This article is for Experience Builder implementers, Salesforce admins, and front-end implementers who need to place a storefront component that lists the buyer's shopping carts and supports cart management actions.
What this component is for
Shopping Cart - List View is an Experience Builder component that displays the buyer's available shopping carts in a single list. It helps buyers review existing carts, activate a different cart, and remove carts they no longer need.
This component is especially useful when your storefront supports multiple carts and buyers need a dedicated place to manage them outside the add-to-cart flow.
Where this component can be used
The component is exposed for Experience Builder placement on:
- default community component regions
- Experience Builder pages
Use it on a dedicated shopping cart management page, in a buyer account area, or in another storefront location where cart switching should be easy to find.
Add the component in Experience Builder
Use these steps to place the component in the storefront:
- Open Experience Builder for the storefront site.
- Open the page where buyers should manage their carts.
- In the component panel, locate Shopping Cart - List View.
- Drag the component into the target page region.
- Save and publish the site.
Builder properties and limitations
At the time of writing, the exposed Experience Builder component does not provide configurable properties in the builder property panel.
Current behavior to know before placement:
- the rendered card title is fixed as All Shopping Carts
- there are no exposed settings for filtering, labels, or action visibility
- selection mode exists in the underlying base component but is used internally by the built-in add-to-other-cart modal and is not exposed as a builder setting
What buyers see
For each cart in the list, the component shows:
- cart name or description
- number of products
- total price
- cart owner
- active or inactive status
The component uses a tile-style layout so buyers can scan carts quickly.
If no carts are available, the component shows an empty state with the message No shopping carts found and the link Select products to create a cart, which takes the buyer back to the product catalog.
If the cart data cannot be loaded, the component shows the standard error panel.
Actions available from the component
Buyers can take these actions from the list:
Open a cart
Selecting a cart tile opens that shopping cart record page.
Activate a cart
Inactive carts show an Activate action. When the buyer activates a cart, that cart becomes the active cart for the current buyer context.
After activation, the component publishes the standard cart refresh event so subscribed cart-aware storefront components can update.
Delete a cart
Inactive carts also show a Delete action. When the buyer selects Delete, the storefront asks for confirmation before removing the cart.
The current component does not expose Delete for the active cart. Because of that, this article should not promise active-cart reassignment behavior after deletion.
How the component behaves in the storefront
The component loads the carts available to the current buyer account context. During loading, it shows a spinner.
After activation or deletion:
- the list refreshes automatically
- cart actions are reflected in the UI without a manual page refresh
- cart-aware components can stay aligned through the standard cart refresh pattern when activation occurs
Validation checklist
Use this checklist after publishing:
- Open the storefront as a buyer.
- Confirm the component is visible in the intended page region.
- Confirm that existing carts load in the list.
- Verify that each cart shows identifying details, item count, total price, owner, and active state.
- Activate an inactive cart and confirm that it becomes active.
- Confirm that other cart-aware storefront components now reflect the newly active cart.
- Delete an inactive cart and confirm that it is removed from the list after confirmation.
- Test the empty state in a user context with no available carts and confirm that Select products to create a cart takes the buyer back to the product catalog.
Troubleshooting
No carts are shown
Verify that the buyer has access to carts in the current storefront account context.
Activation appears to work but other cart indicators do not update
Verify that related components on the page respond to the standard refreshShoppingCart event.
Buyers expect to pick a cart from this component during add-to-cart
The public Experience Builder component is meant for cart management pages. The cart-selection version of the list is used internally in the built-in add-to-other-cart flow and is not exposed as a separate builder option.
Related articles
- Multi-cart storefront workflows
- Shopping Cart Widget
- refreshShoppingCart__c
5. Additional Suggestions
- Consider a future enhancement article if builder-level properties are added later, because the current public component is intentionally minimal.
- If OrderCentral introduces a public cart selector component, document it separately instead of expanding this article with internal modal behavior.
- Add a storefront architecture guide that explains when to use Shopping Cart Widget, Shopping Cart - List View, or both on the same site.