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

# Troubleshooting & FAQ

> Fixes for the most common setup problems, and answers to frequent questions.

## Troubleshooting

> [accordion] Nothing shows on my store
>
> Check these three things in order:
>
> 1. **App embeds**: **Online Store → Themes → Customize → App embeds**. Both **Wishlist Engine** and **Wishlist icon** must be on, in your **live** theme. Click **Save**.
> 2. **Feature toggles**: **Insights → Wishlist Settings**. Features start deactivated on a new install.
> 3. **Plan**: make sure you have an active plan on **Pricing**.
>
> Then reload your store with a hard refresh (Ctrl/Cmd + Shift + R).

> [accordion] The product page button is missing or in the wrong place
>
> Your theme probably uses non-standard markup. In **Manage Wishlist → Product Page**, enter a **Custom Cart Selector** (or **Custom Image Selector** if the button sits on the image). Or add the **Add to Wishlist Button** app block exactly where you want it. See [Product page button](https://codebeans-wishlyst.mintlify.site/guides/customize/product-page.md).

> [accordion] Hearts missing on some product cards
>
> * For custom card markup, enter a **Custom Collection Selector** in **Manage Wishlist → Collections**.
> * If your theme loads more products with infinite scroll or "Load more" and the new cards have no hearts, ask your developer to call `window.forceWishlistInjection()` after new products load. See [JavaScript API](https://codebeans-wishlyst.mintlify.site/developers/javascript-api.md#re-scanning-after-ajax-updates).

> [accordion] The wrong variant is saved
>
> The app follows your theme's variant changes. Some themes switch variants without telling other scripts. A developer can run `window.cbTraceVariant(true)` in the browser console to see what the app detects, and dispatch a `variant:changed` event from the theme if needed. See [JavaScript API](https://codebeans-wishlyst.mintlify.site/developers/javascript-api.md#events).

> [accordion] The wishlist page is blank
>
> * Make sure the **Wishlist page** toggle is activated under **Insights**.
> * Make sure the page has the **Shopy Wishlist Page** block, or the `<div data-cb-wishlist></div>` shortcode.
> * If you use custom page templates and the page broke after publishing, tick **Turn OFF custom wishlist templates on this theme** in the **Wishlist Engine** app embed. Then fix the template.

> [accordion] Share links open the wrong page
>
> Set the full URL of your wishlist page in **Manage Wishlist → Wishlist Detail Account Page → Share page URL**.

> [accordion] Guests are asked to log in
>
> Guest wishlists are off, or not included in your plan. Turn on **Guest wishlists** under **Insights → Wishlist Settings**. See [Guest wishlists](https://codebeans-wishlyst.mintlify.site/guides/storefront/guest-wishlists.md).

> [accordion] Reminder emails are not being sent
>
> * **Enable chase emails** must be on, and the specific campaign or alert must be enabled.
> * Your plan must include the email type, and you must have promotional emails left this month (see **Home → Plan usage**).
> * Emails go to **signed-in customers** with an email address only. Shoppers who unsubscribed or whose address bounced are skipped.
> * With your own SMTP, use **Send Test Email** in **Manage Wishlist → Email Settings** to check the connection.

> [accordion] Customer names and emails show as unavailable
>
> The app needs access to protected customer data. Follow the **Customer Data Access Required** banner on the **Customers** page.

## FAQ

> [accordion] Does it work with my theme?
>
> Yes. Codebeans Wishlyst works with every Online Store 2.0 theme, and with older themes through shortcodes. It detects common themes such as Dawn and its family, Debut, Brooklyn and Ella, plus quick-add and quick-view popups.

> [accordion] Will it slow down my store?
>
> Scripts load deferred, after your page content. Custom page template files load only on stores that have published a custom template.

> [accordion] Can shoppers keep more than one list?
>
> Yes, in **Multiple lists** mode (the default), up to your plan's limit. Switch to **Single list** in **Manage Wishlist → Basics** if you prefer one list per shopper.

> [accordion] What happens to a guest's wishlist when they log in?
>
> It moves to their customer account automatically. See [Guest wishlists](https://codebeans-wishlyst.mintlify.site/guides/storefront/guest-wishlists.md).

> [accordion] Can I export my data?
>
> Yes, from **Customers → Export**, as an Excel file. See [Customers & export](https://codebeans-wishlyst.mintlify.site/guides/admin/customers.md#export).

> [accordion] Is there a back-in-stock email?
>
> Not today. The app sends [low stock and price drop alerts](https://codebeans-wishlyst.mintlify.site/guides/emails/stock-and-price-alerts.md) and [reminder campaigns](https://codebeans-wishlyst.mintlify.site/guides/emails/chase-emails.md).

> [accordion] Can I use it in a mobile app or headless storefront?
>
> Yes, with the [Shopper REST API](https://codebeans-wishlyst.mintlify.site/api-reference/introduction.md) on plans that include API Access.

## Still stuck?

Open the **live chat** inside the app, or email [support@codebeans.net](mailto:support@codebeans.net) with your store's `myshopify.com` domain and a link to the page where the problem appears.


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