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

# Troubleshooting

> Fixes for the most common setup problems.

> [accordion] I can't see the Registry button on my storefront
>
> 1. Check that the **Gift Card Registry Widget** app embed is on in your **live** theme. See [Turn on the app embed](https://codebeans-gift-registry.mintlify.site/getting-started/enable-app-embed.md).
> 2. In the embed settings, check that **Show launcher button** is ticked.
> 3. In the app, check **Settings → General settings → App Status**. It should say **App is Enabled**.

> [accordion] Share links or email links open my home page, not the registry
>
> These links open the registry through the app embed. Turn the app embed on. See [Turn on the app embed](https://codebeans-gift-registry.mintlify.site/getting-started/enable-app-embed.md).

> [accordion] The Add to Registry button does nothing
>
> The window it opens is loaded by the app embed. Turn the app embed on, even if you only use the **Registry Add Button** block.

> [accordion] Product cards have no registry icon
>
> * Check that **Add to Registry on product cards** is ticked in the app embed settings.
> * If your theme still shows no icon, set a **Custom Selector**. See [Buttons on product cards](https://codebeans-gift-registry.mintlify.site/storefront/product-card-buttons.md#if-a-card-has-no-icon-or-it-sits-in-the-wrong-place).

> [accordion] Customers can't create a registry
>
> * Customers must be signed in. Check that customer accounts are enabled in **Settings → Customer accounts** in your Shopify admin.
> * Check that your store has an active plan. Without one, the storefront is read-only.
> * Check your plan's registry limit on the [Dashboard](https://codebeans-gift-registry.mintlify.site/admin/dashboard.md).
> * Check that **Offer Product registries** is on in [General settings](https://codebeans-gift-registry.mintlify.site/settings/general.md).

> [accordion] Emails aren't arriving
>
> * Check that the email is switched on in **Settings → Customer Notifications** or **Admin Notifications**.
> * Check whether you have reached your plan's [email limit](https://codebeans-gift-registry.mintlify.site/emails/overview.md#email-limits).
> * If you use [custom SMTP](https://codebeans-gift-registry.mintlify.site/emails/custom-smtp.md), check the host, username and password, and that your sender address is verified with your provider.
> * Ask the recipient to check their spam folder.

> [accordion] A registry item isn't marked as bought
>
> Purchases are counted when Shopify confirms the order, usually within a minute. The item must have been added to the cart from the registry, not from the normal product page. Check the order for a **Registry Name** line property.

> [accordion] A setting I changed doesn't show on my storefront
>
> * Make sure you clicked **Save** in the save bar.
> * Some settings need a higher plan. Check [Plans](https://codebeans-gift-registry.mintlify.site/billing/plans.md).
> * Reload your storefront in a private window to skip your browser's cache.

Still stuck? [Contact support](https://codebeans-gift-registry.mintlify.site/help/contact-support.md).


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