> ## Documentation Index
> Fetch the complete documentation index at: https://docs.kibocommerce.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Cart Takeover

The cart takeover feature enables customer service representatives (CSRs) to take over an online cart and make changes so that the cart has the shopper's desired products and options. For instance, a shopper may need help ordering several custom products with complex configurations. A CSR can take control of the shopper's cart, browse for products, select options, and add/remove them from the cart.

<CardGroup cols={2}>
  <Card title="Cart & Checkout Concepts" icon="book-open" href="/concept-guides/cart-and-checkout" horizontal data-rec="concept-guide">
    Learn about shopping cart and checkout workflows
  </Card>

  <Card title="Developer Reference" icon="code" href="/developer-guides/cart" horizontal data-rec="developer-doc">
    See the Cart API documentation for programmatic access
  </Card>
</CardGroup>

This feature is supported for both single- and multi-ship tenants, but a CSR must be assigned to a role that has the Customer Update behavior.

## How to Use Cart Takeover

In order to view a shopper's cart, a new order must be made first. CSRs can do this for both anonymous and registered shoppers. However, keep in mind that viewing an anonymous user's cart pulls up an empty cart. For a logged-in user, viewing the cart pulls up the shopper's online cart.

The following example uses an eCommerce storefront. See the [Cart Takeover for Kibo Headless Storefronts section](#cart-takeover-for-kibo-headless-storefronts) for details on how the process differs for headless implementations.

1. Go to **Main** > **Orders** > **Orders**.

2. Click **Create New Order** in the top right. This opens the below page.

   <img src="https://mintcdn.com/kibocommerce-59e68a4a/5Q3zAz2P5aHMz8ra/img/create-new-order.png?fit=max&auto=format&n=5Q3zAz2P5aHMz8ra&q=85&s=3e159b0469c00f25e9e5f67b6d228c64" alt="The order details page" width="1902" height="252" data-path="img/create-new-order.png" />

3. Select the customer from the **Customer Search** drop-down menu on the right.

4. Now that the order is created, click **View User's Cart** in the header.

   <img src="https://mintcdn.com/kibocommerce-59e68a4a/vX_cCc72BnHnRWN5/img/view-users-cart.png?fit=max&auto=format&n=vX_cCc72BnHnRWN5&q=85&s=18b349414c6c7d0b12a0b13fd8c820bb" alt="The order details page with a callout for the View User's Cart button" width="1411" height="279" data-path="img/view-users-cart.png" />

5. This will open the cart page, where no items will be displayed initially. To add an item, first search for a keyword or use the drop-down list of products.

   The cart will always display the CSR logged in as the shopper even though that is not the case. The CSR should not be confused or try to click Log Out.

   <img src="https://mintcdn.com/kibocommerce-59e68a4a/HsxsmZiwYCuO9lws/img/offline-order-product-search.png?fit=max&auto=format&n=HsxsmZiwYCuO9lws&q=85&s=f76f63776e8f4ba791eaa2efdca4f575" alt="The cart module showing the search bar and drop-down list of search results" width="1807" height="855" data-path="img/offline-order-product-search.png" />

6. Clicking on an item opens its details page. Select any options (if applicable) and click **Add to Cart**.

   <img src="https://mintcdn.com/kibocommerce-59e68a4a/5p2bvmH14ykLzZaY/img/add-to-cart-offline.png?fit=max&auto=format&n=5p2bvmH14ykLzZaY&q=85&s=7bf428ac725797c368f048c2667fde02" alt="The product details page in the cart module" width="1813" height="855" data-path="img/add-to-cart-offline.png" />

7. When all items have been added, click **Add Items to Order** in the top right to exit the takeover and allow the shopper to complete checkout on their own.

   Do not click Checkout while doing a cart takeover, unless you intend to enter the customer's payment information yourself as an offline order.

   <img src="https://mintcdn.com/kibocommerce-59e68a4a/5p2bvmH14ykLzZaY/img/add-offline-items-to-order.png?fit=max&auto=format&n=5p2bvmH14ykLzZaY&q=85&s=afd50d870b31d1630b52e0060c4f9216" alt="The cart module with a product added and a callout for the Add Items to Order button" width="1819" height="853" data-path="img/add-offline-items-to-order.png" />

## Cart Takeover for Kibo Headless Storefronts

[Headless integrations](/pages/getting-started "Headless Integrations") can use cart takeover with external storefronts. Admin users can either follow a link on the Customers page to access the storefront directly, or submit an offline order populated with items from the shopper's cart. External cart takeover is not supported for anonymous shoppers.

Contact [Kibo Support](https://help.kibocommerce.com/) to enable this feature.

### View the Kibo Headless Storefront

In addition to the offline order page as shown above for non-headless cases, headless integrations will also display **View User's Cart** buttons on the **Main** > **Customers** > **Customers** table and the customer details page. Clicking either of these buttons will prompt you to select a site before continuing to the external storefront to edit the cart there.

<img src="https://mintcdn.com/kibocommerce-59e68a4a/EkdospAR8vd50L77/img/headless-cart-takeover-1.png?fit=max&auto=format&n=EkdospAR8vd50L77&q=85&s=37b789479b704bec921c5ea2d8037597" alt="The Customers grid with a callout for View User's Cart in the actions menu" width="1391" height="266" data-path="img/headless-cart-takeover-1.png" />

<img src="https://mintcdn.com/kibocommerce-59e68a4a/EkdospAR8vd50L77/img/headless-cart-takeover-2.png?fit=max&auto=format&n=EkdospAR8vd50L77&q=85&s=ba4b49b91dad32f997abd1d3be6d3643" alt="The customer details page with a callout for View User's Cart" width="1257" height="312" data-path="img/headless-cart-takeover-2.png" />

When viewing [a B2B account,](/pages/manage-b2b-accounts "Manage B2B Accounts") clicking any user in the table will redirect you to the above customer details page. From there, you can view the user's cart and perform a takeover using the same process as documented here.

### Create Order in Admin UI

If creating a new order in the Admin UI, any changes will not be reflected on the external storefront. This means that you will have to submit it as an offline order, instead of releasing it for the shopper to checkout on their own.

1. After creating a new order and selecting the customer, click **Populate Items from Cart** in the actions menu. This will add all items from the shopper's external cart to the order.<img src="https://mintcdn.com/kibocommerce-59e68a4a/mirjU24xTFSyw6n2/img/populate-items-from-cart.png?fit=max&auto=format&n=mirjU24xTFSyw6n2&q=85&s=75a54812174c7e42dd2724e39d9d2277" alt="The Order Details page with a callout for the Populate Items button" width="1230" height="301" data-path="img/populate-items-from-cart.png" />
2. Click **Edit Details** to add/remove items, select a shipping method, or perform adjustments.
3. Click **Save** on the Edit Details modal when complete.
4. Enter the customer's payment information in the **Payments** tab.
5. Click **Submit Order** in the top right of the page.
