Update Cart in the Storefront

Update cart region, email, and addresses.

On this page

In this guide, you'll learn how to update different details of a cart.

On Next.js, these updates live in src/lib/data/cart.ts and read _aiminaabee_cart_id. After a guest logs in, call transferCart(storeCode) as shown below.

Tip: This guide doesn't cover updating the cart's line items. For that, refer to the Manage Cart's Items in Storefront guide.

Update Cart's Region

If a customer changes their region, you must update their cart to be associated with that region.

For example:

Tip: Learn how to install and configure the JS SDK in the Getting started guide.

tsCopy

1sdk.store.cart.update(storeCode, cartId, {
2  region_id: "new_id",
3})
4.then(({ cart }) => {
5  // use cart...
6  console.log(cart)
7})

The Update Cart API route accepts a region_id request body parameter, whose value is the new region to associate with the cart.

Set Cart's Customer

You might need to change the cart's customer in two cases:

You created the cart for the customer as a guest, then they logged-in, so you want to associate the cart with them as a registered customer.
You're transferring the cart from one customer to another, which is useful in company setups, such as when implementing B2B commerce applications.

To set or change the cart's customer, send an authenticated POST request to the Set Cart's Customer API route:

This API route is only available in the current Aiminaabee API.

tsCopy

1// TODO must be authenticated as the customer to set the cart's customer
2sdk.store.cart.transferCart(storeCode, cartId)
3.then(({ cart }) => {
4  // use cart...
5  console.log(cart)
6})

Assuming the JS SDK is configured to send an authenticated request, the cart is now associated with the logged-in customer.

Learn more about authenticating customers with the JS SDK in the Login Customer guide.

Tip: When using the Fetch API to send the request, either use credentials: include if the customer is already authenticated with a cookie session, or pass the Authorization Bearer token in the request's header.

Set Cart's Locale

Prerequisites

Translation Module Configured

By default, items in the cart will have their associated product's original content. If your storefront supports localization, you can set the cart's locale to ensure that the item contents are in the customer's preferred language.

You can set the cart's locale by passing the locale request body parameter to the Update Cart API route. For example:

tsCopy

1sdk.store.cart.update("us", cartId, {
2  // you can also retrieve the locale from sdk.getLocale()
3  locale: "fr-FR",
4})
5.then(({ cart }) => {
6  // TODO use the cart...
7  console.log(cart)
8})

When the cart's locale is set, existing and new items in the cart will have their content in the specified locale if translations are available.