> ## 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.

# Buttons on product cards

> Show an Add to Registry icon on product cards in collections, search results and your home page.

With the [app embed](https://codebeans-gift-registry.mintlify.site/getting-started/enable-app-embed.md) on, the app finds the product cards on your collection, search and home pages and adds an **Add to Registry** icon to each one. **Usually there is nothing to set up.**

![Product cards on a collection with the registry gift icon in the top-left corner of each image](https://mintcdn.com/codebeans-gift-registry/BGALGEd3ayzoJB-1/images/card-icon.png?fit=max\&auto=format\&n=BGALGEd3ayzoJB-1\&q=85\&s=15781b4d30b2a88cce984300a841218b)

| Page | Gets an icon? |
| - | - |
| Collection, search and home pages | On every product card |
| Product page | Only on related and recently viewed products. The product itself uses the [Registry Add Button](https://codebeans-gift-registry.mintlify.site/storefront/add-to-registry-button.md). |
| After filtering or sorting | Yes, new cards are picked up automatically |

To turn the icons off, open the app embed settings in the theme editor and untick **Add to Registry on product cards**.

## Change how the icon looks

Open **Settings → Integrations & Theme → Collection Card Icon** in the app.

![The Collection Card Icon settings in the app, with a preview of the icon on product cards](https://mintcdn.com/codebeans-gift-registry/BGALGEd3ayzoJB-1/images/card-icon-settings.png?fit=max\&auto=format\&n=BGALGEd3ayzoJB-1\&q=85\&s=36f8946942e367335ab6580ceb9b2cae)

| Setting | Default | What it does |
| - | - | - |
| Button Style | Badge | **Badge** puts the icon on a coloured chip. **Icon only** draws it straight on the photo with a soft shadow. |
| Icon Position | Top Right | The corner of the product image. Choose **Custom** to set the distance from each edge (0–100 px). |
| Accessible Label | Add to Registry | Read by screen readers and shown as the tooltip. |
| Background Color | #212121 | Badge colour. Set opacity to 0 for no background. |
| Icon Color | #ffffff | Icon colour. |
| Border Color | none | Badge border. |
| Border Radius | 4 px | Badge corner rounding (0–30). |
| Icon Size (px) | 24 | 12–64. |
| Icon Padding (px) | 8 | Space around the icon (0–24). |
| Custom Icon (SVG) | — | Paste SVG markup to replace the gift icon. Use `fill="currentColor"` so **Icon Color** still applies. |

A **Preview** on the page shows how the icon will look.

## If a card has no icon, or it sits in the wrong place

Themes build product cards in different ways. Try these in order:

> [accordion] 1. Tell the app which element is the card
>
> In **Collection Card Icon**, fill in **Custom Selector (Advanced)** with the CSS selector of one product card, for example `.product-card` or `.card__media`. To find it, right-click a card on your storefront and choose **Inspect**. Then choose a **Custom Selector Placement**:
>
> * **Inside it, last (overlay)** or **Inside it, first (overlay)** keep the icon in the corner of the image.
> * **Just before it** or **Just after it** place the icon next to the element.
>
> Leave the field empty to go back to automatic detection.

> [accordion] 2. Add the Registry Card Button block
>
> Some themes let you add blocks inside a product card. In the theme editor, open your collection template, expand the product grid down to the product card, and add the **Registry Card Button** app block. Older themes build cards from snippets and don't allow this.

> [accordion] 3. Add a snippet to your card template
>
> Open your product card snippet (often `snippets/card-product.liquid` or `snippets/product-card.liquid`) and paste the snippet from [Add the button by hand](https://codebeans-gift-registry.mintlify.site/storefront/add-to-registry-button.md#add-the-button-by-hand-theme-code). Inside a card, the product variable is often called `card_product` instead of `product`.

> [!NOTE]
>
> Automatic detection reads the product link inside each card. If your theme opens products with JavaScript instead of a normal link, use option 2 or 3.


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