For the complete documentation index, see llms.txt. This page is also available as Markdown.

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.

Last updated