> For the complete documentation index, see [llms.txt](https://staylime.com/docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://staylime.com/docs/avante-themes/features-and-advanced-setup/cart-drawer.md).

# Cart drawer

Slide-out cart panel rendered by the theme layout. Enabled in Theme settings → Cart — it is not an Add section block and not part of the header group.

A slide-out cart panel that appears when a visitor clicks the cart icon, without leaving the current page. Shows items, quantities, subtotal, and an optional free shipping progress bar.

<figure><img src="https://795663372-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F6DraMvJNYYlFJqlho1aV%2Fuploads%2FBSJ71I6KurAguwebXh0F%2FGroup%202%20(5).jpg?alt=media&amp;token=47426b60-119e-48ec-89be-f18decbc54d2" alt=""><figcaption></figcaption></figure>

{% hint style="warning" %}
**There is no Cart drawer entry in Add section**, and the drawer is not part of the header or footer section groups. Avante renders it once from the theme layout, and only when **Theme settings → Cart → Enable cart drawer** is on. Looking for it in the section list is the usual dead end.
{% endhint %}

***

### Where it is configured

The cart drawer is enabled and configured in **Theme settings**, not in the Theme Editor sidebar:

[**Theme settings → Cart**](https://staylime.com/docs/avante-themes/theme-settings/cart.md) — turn the drawer on, choose the cart name, and set cart-wide options.

[**Theme settings → Cart drawer**](https://staylime.com/docs/avante-themes/theme-settings/cart-drawer.md) — everything that appears inside the panel.

<figure><img src="https://795663372-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F6DraMvJNYYlFJqlho1aV%2Fuploads%2FbYjBkZx1H6MNrxIAclzB%2FGroup%202%20(6).jpg?alt=media&amp;token=ac2dcf9e-91f0-4dc3-b296-911b0c255048" alt=""><figcaption></figcaption></figure>

***

### Enabling the drawer

By default the cart drawer is **disabled**. To turn it on, go to **Theme settings → Cart** and check **Enable cart drawer**.

<figure><img src="https://795663372-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F6DraMvJNYYlFJqlho1aV%2Fuploads%2FWDkklDH2pYGfeUcxT7Wh%2FGroup%202%20(7).jpg?alt=media&amp;token=3138a5b6-4c50-4cf4-82a4-24d6fc09a54e" alt=""><figcaption></figcaption></figure>

When disabled, clicking the cart icon takes visitors to the full `/cart` page instead.

***

### Cart name

Avante lets you choose how the cart is labeled throughout your store: **Cart**, **Bag**, or **Basket**. This changes all button labels, headings, and drawer text to match — a small branding detail that makes the store feel more polished.

<figure><img src="https://795663372-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F6DraMvJNYYlFJqlho1aV%2Fuploads%2FPkDtUyXITwAXj3myNCmL%2FGroup%202%20(8).jpg?alt=media&amp;token=6d9bb00a-a452-4c53-847b-84a61217791f" alt=""><figcaption></figcaption></figure>

***

### Key features

**Free shipping bar** — show a progress bar that tells visitors how much more they need to spend to qualify for free shipping. Can be enabled separately for the cart drawer and the full cart page.

<figure><img src="https://795663372-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F6DraMvJNYYlFJqlho1aV%2Fuploads%2FQPUN62WuxnQF3dwTn7Cw%2FGroup%202%20(9).jpg?alt=media&amp;token=448c45b7-0119-47cd-afa0-af7b8d9f7994" alt=""><figcaption></figcaption></figure>

**"You saved"** — displays the total savings when cart items are on sale. A small nudge that reinforces the purchase decision.

**Discount code** — visitors can enter a promo code right inside the drawer without going to checkout first. Enable **Show as collapsible tab** to keep it tidy — the field stays hidden until the visitor taps to expand it.

**Order note** — a text field where visitors can leave a note with their order (gift message, delivery instructions). Also supports the collapsible tab option to save space.

<figure><img src="https://795663372-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F6DraMvJNYYlFJqlho1aV%2Fuploads%2FkUwtAZddQa4gzbe7IQQS%2FGroup%202%20(10).jpg?alt=media&amp;token=f8eeccf6-0dde-46f2-b881-fb3dc129c9ab" alt=""><figcaption></figcaption></figure>

**Shipping calculator** — estimate shipping costs right in the drawer based on country. If the customer is logged in, their default shipping address country is pre-selected automatically.

<figure><img src="https://795663372-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F6DraMvJNYYlFJqlho1aV%2Fuploads%2FW6efEczNoYZ6pM5CxPYn%2FGroup%202%20(11).jpg?alt=media&amp;token=b4e5d378-1fd1-4485-a439-9f3438078854" alt=""><figcaption></figcaption></figure>

**Cart drawer recommendations** — product recommendations at the bottom of the drawer to encourage add-ons. Supports custom image ratio, mobile layout (one or two columns), color pills, and vendor display — same product card options as collection pages.

<figure><img src="https://795663372-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F6DraMvJNYYlFJqlho1aV%2Fuploads%2FfwwIhFquj1LQAhXqkLML%2FGroup%202%20(12).jpg?alt=media&amp;token=46250378-7cc1-4332-81c4-1c37e600f278" alt=""><figcaption></figcaption></figure>

**Hide "View cart" button** — if you want the drawer to be the only cart experience, hide the button and drive visitors straight to checkout.

{% hint style="success" icon="sparkles" %}
For more cart-related settings (cart name, free shipping thresholds, cart page layout), see [**Theme settings → Cart**](https://staylime.com/docs/avante-themes/theme-settings/cart.md).
{% endhint %}

***

### Related

* [Theme settings → Cart drawer](https://staylime.com/docs/avante-themes/theme-settings/cart-drawer.md) — full reference for all cart drawer settings
* [Theme settings → Cart](https://staylime.com/docs/avante-themes/theme-settings/cart.md) — cart name, free shipping, pre-order notice, consent checkbox
* [Header](https://staylime.com/docs/avante-themes/global-sections/header-and-navigation/header.md) — cart icon configuration
* [Cross-sell & Recommendations](https://staylime.com/docs/avante-themes/sections/trust-and-social-proof.md) — product recommendation sections


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://staylime.com/docs/avante-themes/features-and-advanced-setup/cart-drawer.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
