> For the complete documentation index, see [llms.txt](https://help.dollarlabs.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.dollarlabs.io/dollarback-store-credit/troubleshooting-and-faq/widget-isnt-showing.md).

# A widget isn't showing on my store

Work through these checks in order; the first two cover the vast majority of cases.

## 1. Check the extensions status card on the dashboard

**Look at:** **DollarBack admin → Dashboard**, the extensions status card. It lists each storefront surface and whether it's active in your published theme.

**You'll see:** any inactive surface flagged, with a deep link into the Shopify theme editor for that exact surface.

**Fix:** click the deep link and enable the missing widget (see check 2 for which kind of switch you're looking for). Back on the dashboard, confirm the card now shows it active.

## 2. Know whether it's an app embed or an app block (they're different)

**Look at:** the Shopify theme editor, but in two different places:

* **App embeds** are site-wide toggles in the theme editor's app embeds panel. The floating cashback widget and the cashback window variable are embeds. If the window-variable embed is off, *no* DollarBack widget can load its data, so turning it on can fix several "missing" widgets at once.
* **App blocks** are placed per template: open the specific template (product page, cart) and add the DollarBack block to a section. The product page and cart cashback messages are blocks.

**You'll see:** an embed shows an on/off toggle; a block either appears in the template's section list or is absent entirely.

**Fix:** toggle the embed on, or add the block to the template, then save. Enabling an embed does not add blocks, and adding a block does not enable embeds. A block must be added on every template where you want it.

## 3. Confirm you edited the published theme

**Look at:** the theme name in the editor's top bar.

**You'll see:** if you enabled the widget on a draft or duplicate theme, the live store won't change.

**Fix:** repeat the change on the currently published theme, or publish the theme you edited.

## 4. Rule out a theme conflict

**Look at:** the storefront in an incognito window. If the block is added but invisible, your theme's CSS or a section setting may be hiding it.

**You'll see:** in the browser's developer tools, the widget's element present in the page but hidden or zero-height.

**Fix:** move the block to a different section position, or remove custom CSS targeting it. If it renders in a default Shopify theme but not yours, the conflict is theme-side; share the finding with your theme developer.

## 5. Clear the browser cache

**Look at:** the storefront in a private/incognito window or another browser.

**You'll see:** the widget appears there but not in your normal browser: a cached page.

**Fix:** hard-refresh or clear the cache. Ask customers reporting the issue to do the same before you dig further.

## Related articles

* [Activate widgets in your theme](/dollarback-store-credit/getting-started/activate-widgets-in-your-theme.md)
* [Widget map: what shows where](/dollarback-store-credit/widgets-and-storefront/widget-map-what-shows-where.md)
* [Understanding the dashboard](/dollarback-store-credit/getting-started/understanding-the-dashboard.md)
* [The floating cashback widget](/dollarback-store-credit/widgets-and-storefront/the-floating-cashback-widget.md)