> ## Documentation Index
> Fetch the complete documentation index at: https://codebeans-gift-registry.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Customize the appearance

> Match the registry's colours, banner, buttons and wording to your brand.

You style the registry in two places:

* **The theme editor**, in the **Gift Card Registry Widget** app embed settings: colours, the floating button, pagination, sign-in behaviour and custom CSS.
* **The app**, under **Settings**: the hero banner, [storefront text](https://codebeans-gift-registry.mintlify.site/settings/storefront-text.md), [date format](https://codebeans-gift-registry.mintlify.site/settings/general.md#date-format) and the [product card icon](https://codebeans-gift-registry.mintlify.site/storefront/product-card-buttons.md).

![The registry side drawer open on the right of a store page](https://mintcdn.com/codebeans-gift-registry/lL1M0DWb9ajjK2eJ/images/side-drawer.png?fit=max\&auto=format\&n=lL1M0DWb9ajjK2eJ\&q=85\&s=0605d7722032cd1767e7b93d72a43645)

## App embed settings

Open **Online Store → Themes → Customize → App embeds** and click **Gift Card Registry Widget** to expand its settings.

> [accordion] Launcher Button
>
> | Setting | Default | Notes |
> | - | - | - |
> | Show launcher button | On | Turn off to hide the floating **Registry** button. The registry page, the drawer and Add to Registry buttons keep working. |
> | Position | Center Right | Top, center or bottom, left or right. |
> | Screen Offset | 0 px | Distance from the edge of the screen. |
> | Text | Registry | The button label. |
> | Custom Width | 120 px | Applies only when there is text. |
> | Icon Size | 20 px | |

> [accordion] Side Drawer Styling
>
> | Setting | Default |
> | - | - |
> | Background Color | #FFFFFF |
> | Header Background | #111111 |
> | Primary Button Background | #000000 |
> | Primary Button Text | #FFFFFF |
> | Border & Divider Color | #E5E5E5 |

> [accordion] General Colors & Integration
>
> | Setting | Default | Notes |
> | - | - | - |
> | Banner Background | #EBE8E3 | Registry page only, when the banner has no image. |
> | Banner Text Color | #212121 | Registry page only, when the banner has no image. |
> | Body Text | #212121 | Text in the drawer and on the registry page. |
> | Checkbox & Radio Fill | #222222 | |
> | Launcher & Product Page Button Background | #212121 | The floating button, and the main button in the product page's Add to Registry window. |
> | Launcher Button Text | #FFFFFF | |
> | Button & Field Radius | 4 px | Corner rounding of buttons and fields. |

> [accordion] Product Card Buttons
>
> **Add to Registry on product cards** (on by default) adds the icon to product cards. See [Buttons on product cards](https://codebeans-gift-registry.mintlify.site/storefront/product-card-buttons.md).

> [accordion] Collections & Pagination
>
> | Setting | Default | Notes |
> | - | - | - |
> | Suggested Products Collection | — | Shown in the create-registry product picker before the customer searches. Empty shows all products. |
> | Product picker: add button text | Add | |
> | Product picker: added button text | Added | |
> | Registries Per Page | 10 | |
> | Items Per Page | 25 | |
> | Pagination Type | Previous/Next | Or Load More, or Page Numbers. |

> [accordion] Advanced Settings
>
> | Setting | Default | Notes |
> | - | - | - |
> | Notification position | Top Right | Where pop-up messages appear. |
> | Login behavior | Shopify Login | What **Sign in** does. **Shopify Login** works on every store. Choose **Theme Login Page** or **Theme Login Drawer** to use your theme's own login, then fill in **Login page URL** or **Login trigger selector**. |
> | Custom CSS | — | Your own CSS. Use `cbgc__` classes for the product page button and window, and `cbgcd__` for the side drawer. |

## Hero banner

The banner at the top of the registry is shared by the side drawer and the registry page. Set it in the app under **Settings → General settings → Hero Banner**.

| Field | Notes |
| - | - |
| Hero title | Up to 120 characters. Empty shows "Gift Registry". |
| Hero subtitle | Up to 2000 characters. |
| Hero text alignment | Left, Center or Right. |
| Banner Image | Pick an image from **Content → Files**. Use a wide image, 1600 px or more. To use a new image, upload it to **Content → Files** first. |

> [!NOTE]
>
> The customizable hero banner is part of the **Professional** plan and higher. See [Plans](https://codebeans-gift-registry.mintlify.site/billing/plans.md).


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.