Enable multi-cart selection and new-cart creation

Prev Next

This article is for Salesforce admins, implementation partners, and solution consultants who need to enable and validate the storefront behavior that lets buyers choose another cart or create a new cart during standard add-to-cart flows.

What this setting changes

When this feature is enabled, the standard add-to-cart action in supported storefront product experiences opens a modal titled "Select basket to add the product to" instead of adding immediately.

From that modal, buyers can:

  • select an existing shopping cart and choose Add
  • choose Add to new to create a new cart for the product
  • choose Cancel without changing any cart

When the feature is disabled, the storefront keeps the default single-step add-to-cart behavior.

Controlling feature parameter

The behavior is controlled by the managed package feature parameter:

  • Feature parameter: Add_To_Other_Cart_Feature_Enabled
  • Default value: false

The current package metadata indicates that this parameter is delivered from the managed package publisher to the subscriber org. Based on that implementation, treat enablement as support-controlled unless your OrderCentral team has confirmed a self-service administration model for your tenant.

Prerequisites

Before enabling the feature, confirm these prerequisites:

  1. The storefront uses the standard OrderCentral product ordering experiences for product detail pages and any supported list or tile add-to-cart flows you plan to use.
  2. Buyers already have the expected shopping cart access for their account context.
  3. The storefront has a clear way for buyers to review and manage carts after rollout, ideally through a dedicated cart page or the Shopping Cart - List View component.
  4. Your project team understands the active-cart behavior difference between adding to an existing cart and creating a new one.

Enable the feature

At the time of writing, there is no Experience Builder property or storefront page setting that enables this behavior directly.

Use this rollout process:

  1. Confirm that your buyer journey should support multiple simultaneous carts.
  2. Contact OrderCentral support or your implementation partner and request activation of Add_To_Other_Cart_Feature_Enabled for the target org.
  3. Provide the org details and rollout timing your team wants to use.
  4. Confirm when the feature has been enabled in the subscriber org.
  5. Retest the supported product ordering experiences before publishing the storefront change broadly.

Where buyers see the new behavior

After enablement, the modal flow appears in the standard add-to-cart experience used by:

  • the product detail ordering component
  • supported product list and tile ordering experiences in your storefront

In that modal, the buyer can select an existing shopping cart and choose Add, or choose Add to new without selecting an existing cart first.

Validation checklist

Use this checklist after enablement:

  1. Open the storefront as a buyer.
  2. Navigate to a product detail page and select Add to Cart.
  3. Confirm that a modal titled "Select basket to add the product to" opens instead of adding immediately.
  4. If the buyer already has shopping carts, confirm they are listed with visible details such as Number of products, Total price, Owner, and Active or Inactive status.
  5. Select an existing cart and confirm the product is added successfully.
  6. Repeat the test and choose Add to new.
  7. Confirm that a new cart is created and that storefront cart-aware experiences now reflect the new active cart.
  8. If your storefront uses supported product list or tile ordering experiences, repeat the same validation there.
  9. Confirm that canceling the dialog does not create or modify a cart.

Expected fallback behavior when the feature is off

If the feature parameter is false, buyers should see the normal add-to-cart behavior:

  • no "Select basket to add the product to" modal
  • product added through the standard add-to-cart flow, typically using the current active cart when one already exists
  • no new-cart action in the storefront add flow

This is the expected fallback and should not be treated as an error.

Troubleshooting

The dialog does not appear

Check these points first:

  • the feature parameter has been enabled for the org
  • the page uses a supported standard OrderCentral product ordering experience
  • the user is testing the supported add-to-cart flow, not a custom integration path

Buyers can create a new cart but cannot find an existing cart to select

The selection list depends on the carts available to that buyer in the current storefront context. If no carts are available, the modal shows an empty-state message and the buyer can still use Add to new to begin a fresh cart.

The active cart did not change after adding to another existing cart

This is expected. Adding to an existing selected cart does not switch active cart context automatically.

The active cart changed after Add to new

This is also expected. A newly created cart becomes the active cart after the add succeeds.

Related articles

  • Multi-cart storefront workflows
  • Shopping Cart - List View

5. Additional Suggestions

  • Add a short internal runbook for support teams that confirms how this feature parameter is enabled per tenant.
  • If self-service administration becomes available later, document subscriber steps alongside the support-controlled assumption.
  • Pair rollout communication with a buyer-facing explanation of active-cart behavior so support teams receive fewer questions after launch.