> For the complete documentation index, see [llms.txt](https://ursus-ecom.gitbook.io/arctos-theme/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://ursus-ecom.gitbook.io/arctos-theme/theme-settings/drawers.md).

# Drawers

Drawers are panels that slide in from the left or right edge of the screen. The cart drawer and the search drawer both use this component.

{% hint style="info" %}
**Where to find it:** In the theme editor (**Customize**), go to **Theme settings > Drawers**.
{% endhint %}

Drawers are slide-in panels that appear from the left or right edge of the screen without navigating away from the current page. This theme uses drawers for two core interactions:

* [**Cart drawer**](https://ursus-ecom.gitbook.io/arctos-theme/section-templates/overlay-group/cart-drawer.md)**:** Opens when a customer adds a product to their cart, letting them review and edit their cart without leaving the page they're on.

<figure><img src="https://1411897219-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FP6Y96SO1y456EU9GTaCh%2Fuploads%2Fgit-blob-478bdc6b92176fe82807fa5acc284da18ca14d3e%2Fdrawers-cart.webp?alt=media" alt=""><figcaption></figcaption></figure>

* **Search drawer:** Opens when a customer clicks the search icon, displaying a full search input and results in a focused panel.

<figure><img src="https://1411897219-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FP6Y96SO1y456EU9GTaCh%2Fuploads%2Fgit-blob-75413f9f507f702da7daf58b79238aa5dd08b96c%2Fdrawers-search.webp?alt=media" alt=""><figcaption></figcaption></figure>

Settings here apply globally to both drawers. If you want a different look for a specific drawer, you can override these defaults from that drawer's individual settings.

### 1. Heading

Controls the text style of drawer headings like "Your Cart" or "Search.".

Sets the text style for the drawer heading. Each style applies a predefined combination of font, size, weight, and letter spacing from your theme's [typography](https://ursus-ecom.gitbook.io/arctos-theme/theme-settings/typography.md) settings.

<figure><img src="https://1411897219-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FP6Y96SO1y456EU9GTaCh%2Fuploads%2Fgit-blob-8c34be50ac633aedbbd7a315e425a9ad12350674%2Fdrawers-heading.webp?alt=media" alt=""><figcaption></figcaption></figure>

### 2. Position

Controls whether the drawer slides in from the **right** or **left** side of the screen. Most stores use Right.

### 3. Close button

Controls the appearance of the close button inside the drawer. A well-placed, clearly visible close button reduces friction. Customers should never have to hunt for a way out.

<figure><img src="https://1411897219-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FP6Y96SO1y456EU9GTaCh%2Fuploads%2Fgit-blob-82d59bcd70e77b8446b594cb115d556a86a2dd6e%2Fdrawers-close.webp?alt=media" alt=""><figcaption></figcaption></figure>

<table><thead><tr><th width="109.9296875">Setting</th><th width="132.359375">Options</th><th>Notes</th></tr></thead><tbody><tr><td><strong>Style</strong></td><td><ul><li>Classic</li><li>Boxed</li></ul></td><td><ul><li><strong>Classic</strong> is an X icon with no container.</li><li><strong>Boxed</strong> places it inside a small bordered box.</li></ul></td></tr><tr><td><strong>Box style</strong></td><td><ul><li>Fill</li><li>Outline</li></ul></td><td><ul><li><strong>Fill</strong> adds a solid background behind the close icon.</li><li><strong>Outline</strong> shows only the border.</li></ul><p><em>Only available when Style is set to <strong>Boxed</strong>.</em></p></td></tr></tbody></table>

### 4. Style

Controls the visual treatment of the drawer panel and the backdrop behind it. The corner radius, backdrop, and display effect work together to set the overall tone, whether that's sharp and minimal, soft and layered, or something in between.

<figure><img src="https://1411897219-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FP6Y96SO1y456EU9GTaCh%2Fuploads%2Fgit-blob-2f17dbef21b56723d954bfd9ba5ec78faab3e047%2Fdrawers-style.webp?alt=media" alt=""><figcaption></figcaption></figure>

<table><thead><tr><th width="185.7421875">Setting</th><th width="160.24609375">Options</th><th width="379.8828125">Notes</th></tr></thead><tbody><tr><td><strong>Corner radius</strong></td><td><ul><li>Main corner</li><li>Small</li><li>Extra small</li><li>None</li><li>Custom</li></ul></td><td><p>Controls how rounded the corners of the drawer panel are.</p><ul><li><strong>Main corner</strong> matches the global corner radius set in your theme.</li><li><strong>Small</strong> and <strong>Extra small</strong> inherit from the <a href="https://ursus-ecom.gitbook.io/pages/MtcWsJuspkVnqjnkw5Ur#id-1.-global-style-main-corner">main corner</a> value and scale it down proportionally for a subtler effect.</li><li><strong>None</strong> removes rounding entirely for a sharp, full-bleed look.</li><li><strong>Custom</strong> lets you set a precise value to match a specific design.</li></ul></td></tr><tr><td><strong>Backdrop color style</strong></td><td><ul><li>Solid</li><li>Gradient</li></ul></td><td><ul><li><strong>Solid</strong> is a flat dimmed overlay.</li><li><strong>Gradient</strong> fades directionally and can look more refined on image-heavy pages.</li></ul></td></tr><tr><td><strong>Color code</strong></td><td>Hex with alpha</td><td><p>Sets the overlay color and opacity.</p><ul><li>Lower alpha values are subtler</li><li>Higher values focus attention on the drawer.</li></ul></td></tr><tr><td><strong>Display effect</strong></td><td><ul><li>Slide</li><li>Fade</li></ul></td><td><ul><li><strong>Slide</strong> moves the panel in from the side</li><li><strong>Fade</strong> appears in place.</li></ul><p>Slide is more conventional; Fade can feel more immersive.</p></td></tr></tbody></table>

### 5. Spacing

Controls the space around and inside the drawer panel. Getting this right makes the drawer feel intentional.

<figure><img src="https://1411897219-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FP6Y96SO1y456EU9GTaCh%2Fuploads%2Fgit-blob-e94e77f25a0d81fa9473f8e9a6f39a4adecd5171%2Fdrawers-spacing.webp?alt=media" alt=""><figcaption></figcaption></figure>

<table><thead><tr><th width="110.2421875">Setting</th><th>What it controls</th></tr></thead><tbody><tr><td><strong>Padding</strong></td><td><p>The space between the drawer's edges and its content.</p><ul><li>More padding gives the content room to breathe and makes the drawer feel more considered.</li><li>Less padding maximizes the space available for content, useful for the cart drawer where product lines need room.</li></ul></td></tr><tr><td><strong>Margin</strong></td><td>The gap between the drawer panel and the screen edge. Adding margin makes the drawer feel like a floating panel rather than a full-edge sheet, which can soften the overall experience.</td></tr></tbody></table>
