> 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/widgets-and-storefront/widget-map-what-shows-where.md).

# Widget map: what shows where

{% embed url="<https://dollarlabs.neetorecord.com/watch/c8d6c712c04f95c6091c>" %}

\_This article's section starts at 0:00 in the video.\_

DollarBack can appear in 15 places across your store, from the product page to the checkout, the thank-you page, and your customers' account pages. This page is the index: what each touchpoint shows, where it lives, and where to go to set it up.

All touchpoints are managed from **DollarBack admin → Customize**, which groups them the same way this page does.

<figure><img src="https://2844543096-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FcVBfwy7Yj4tU8TsxkHEr%2Fuploads%2Fgit-blob-49799c7171b68379efd41adc7b6a97535dd5218f%2Fdb-customization-index-annotated.png?alt=media" alt="The DollarBack Customize widgets page with the Storefront group showing cards for Product page cashback, Cart page cashback and Cashback widget, each with an Active badge and a Customize button."><figcaption><p>Every DollarBack touchpoint has a card on the Customize page, grouped by where it shows on your store.</p></figcaption></figure>

## Storefront (theme blocks and app embeds)

Widgets your customers see while browsing. Activated in the Shopify theme editor, customized in DollarBack.

* **Product page cashback message**: a line on each product page showing what that product earns. → [Product page & cart cashback messages](/dollarback-store-credit/widgets-and-storefront/product-page-and-cart-cashback-messages.md)
* **Cart cashback message**: the same message for the whole cart, including order-goal progress. → [Product page & cart cashback messages](/dollarback-store-credit/widgets-and-storefront/product-page-and-cart-cashback-messages.md)
* **Floating cashback widget**: a site-wide launcher that opens a panel with balance, ways to earn, tiers, referrals, a Redeem view for rewards, and history. → [The floating cashback widget](/dollarback-store-credit/widgets-and-storefront/the-floating-cashback-widget.md)
* **Loyalty page**: a full storefront page for your rewards program. → [Set up the loyalty page](/dollarback-store-credit/widgets-and-storefront/set-up-the-loyalty-page.md)

<figure><img src="https://2844543096-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FcVBfwy7Yj4tU8TsxkHEr%2Fuploads%2Fgit-blob-b08cecfb57ed82ad04e9b62aad66585684865702%2Fdb-cx-widget-home.png?alt=media" alt="The floating panel on the storefront for a signed-in customer: Your Credit $22.33 with a history icon in the header, a Bronze tier card marked Current with Next: Silver, Spend $250.00, a Referral Program card that says You get $5.00, They get $5.00, a Redeem rewards card, and Home, Offers and Referral tabs." width="380"><figcaption><p>The floating cashback widget as a signed-in customer sees it.</p></figcaption></figure>

## Checkout and post-purchase

Blocks added in the Shopify checkout editor. The two checkout blocks require Shopify Plus; the thank-you blocks work on all plans.

* **Checkout cashback**: tells the customer what this order will earn, right in checkout. → [Checkout & thank-you widgets](/dollarback-store-credit/widgets-and-storefront/checkout-and-thank-you-widgets.md)
* **Checkout reward marketplace**: lets customers redeem credit for rewards without leaving checkout. → [Checkout & thank-you widgets](/dollarback-store-credit/widgets-and-storefront/checkout-and-thank-you-widgets.md)
* **Thank-you cashback**: confirms the credit just earned, with its expiry note. → [Checkout & thank-you widgets](/dollarback-store-credit/widgets-and-storefront/checkout-and-thank-you-widgets.md)
* **Thank-you referral**: invites the customer to share their referral link while the purchase is fresh. → [Checkout & thank-you widgets](/dollarback-store-credit/widgets-and-storefront/checkout-and-thank-you-widgets.md)

<figure><img src="https://2844543096-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FcVBfwy7Yj4tU8TsxkHEr%2Fuploads%2Fgit-blob-8f6e4fa77b227e9e8a875d57882ecc11bc17a4ed%2Fdb-cx-checkout-cashback-banner.png?alt=media" alt="The checkout order summary with a green banner, You will earn $2.50 as cashback on this order!, above four items, the discount code field, and the subtotal, shipping and total." width="470"><figcaption><p>The Checkout cashback block tells your customers what the order will earn.</p></figcaption></figure>

## Customer account

Blocks on the new customer account pages (order list, order status, profile).

* **Order status cashback**: credit earned on that specific order, on the order status page. → [Customer account blocks](/dollarback-store-credit/widgets-and-storefront/customer-account-blocks.md)
* **All orders cashback**: the store credit balance on the order list page, with a **Reward history** button that opens filterable history. → [Customer account blocks](/dollarback-store-credit/widgets-and-storefront/customer-account-blocks.md)
* **Referral blocks (three placements)**: referral code and share UI on the order list, order status, and profile pages. → [Customer account blocks](/dollarback-store-credit/widgets-and-storefront/customer-account-blocks.md)
* **Account reward marketplace**: redeem rewards from the profile page. → [Customer account blocks](/dollarback-store-credit/widgets-and-storefront/customer-account-blocks.md)
* **Wallet pass**: a Google or Apple Wallet loyalty card on the customer's phone, updated when DollarBack issues or deducts credit or the tier changes. → [Customer account blocks](/dollarback-store-credit/widgets-and-storefront/customer-account-blocks.md)

<figure><img src="https://2844543096-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FcVBfwy7Yj4tU8TsxkHEr%2Fuploads%2Fgit-blob-ee2db1fcedb56ccde2338385fbee303263ac09ad%2Fdb-cx-account-profile.png?alt=media" alt="The customer account Profile page with three blocks: Loyalty card with Add to Google Wallet and Add to Apple Wallet buttons; a referral block with Copy Code and WhatsApp buttons; and Redeem rewards with Available credit $12.33, two rewards that cost $20.00 marked Add $7.67 more to redeem, a Free shipping reward that costs $5.00 with a Redeem button, and a View history button." width="560"><figcaption><p>The Profile page with the wallet pass, referral and account reward marketplace blocks.</p></figcaption></figure>

## Third-party cart drawers

* **Cart drawer cashback**: the cart message rendered inside Rebuy, Upcart, Monster, AMP, or your theme's native drawer. → [Cart drawer integrations](/dollarback-store-credit/integrations/cart-drawer-integrations.md)

## The full matrix

| Touchpoint                  | Surface                                                 | What it shows                                                                                                                                                                                                                                                                                                                                        | You can customize                                                                                                                                                             |
| --------------------------- | ------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Product page message        | PDP theme block                                         | Cashback earnable on this product; order-goal not-yet-reached / top-tier-reached states; discount-code reward messages                                                                                                                                                                                                                               | Message text per state, background/text color, size, weight, padding, tooltip, custom CSS                                                                                     |
| Cart message                | Cart page / drawer theme block                          | Cashback for the current cart; order-goal not-yet-reached / top-tier-reached states; discount reward messages; loading state                                                                                                                                                                                                                         | Message templates per state, colors, typography, padding, tooltip, custom CSS                                                                                                 |
| Floating cashback widget    | App embed (site-wide)                                   | Launcher opening a panel with Home, Offers (ways to earn: signup / newsletter / birthday / social forms, tiers and progress) and Referral tabs (Offers and Referral only when they have content), a Redeem view for rewards, history with an All / Store credit / Discount codes / Referral filter, and an optional card linking to the loyalty page | Launcher label and icon, all labels and tab names, login prompts, Home card order, loyalty-page card, panel width, 5 color roles, border radius, custom CSS                   |
| Loyalty page                | Full storefront page                                    | Hero, how-it-works steps, ways to earn, tiers, referral block with share buttons (Facebook, X, WhatsApp, email), reward history, FAQ                                                                                                                                                                                                                 | Every section's copy (logged in/out variants), hero image, section hiding, full branding tokens (colors, type, radii), sign-in/registration URLs, custom CSS (`db-loyalty-*`) |
| Checkout cashback           | Checkout block (Shopify Plus)                           | Cashback the order will earn; order-goal progress; discount reward notices                                                                                                                                                                                                                                                                           | Offers title, message templates per state, scope phrase                                                                                                                       |
| Checkout reward marketplace | Checkout block (Shopify Plus), signed-in customers only | Balance plus your marketplace rewards, with a shortfall note on rewards the customer can't afford yet; redeem, **Apply to cart** and copy-code actions                                                                                                                                                                                               | Heading, collapsed summary, maximum offers, balance, cost, expiry and shortfall labels, button labels, success/error messages (reward wording is shared)                      |
| Thank-you cashback          | Thank-you block                                         | Credit earned on the order just placed, expiry note, discount-code rewards earned                                                                                                                                                                                                                                                                    | Offers title, title, cashback/expiry/loading messages, discount reward messages                                                                                               |
| Thank-you referral          | Thank-you block                                         | Referral invite with a **Copy Code** button for signed-in customers; a **Login to share** prompt for guests                                                                                                                                                                                                                                          | Heading, body message, button and clipboard text, image (per state)                                                                                                           |
| Order status cashback       | Order status block (**Store Credit Earned**)            | Credit earned on that order                                                                                                                                                                                                                                                                                                                          | Cashback earned message                                                                                                                                                       |
| All orders cashback         | Order list block (**Store Credit Earned**)              | Balance banner with a **Reward history** button that opens history with filters                                                                                                                                                                                                                                                                      | Heading, body message, button label, popup title, history filter, tag and detail labels                                                                                       |
| Referral blocks (×3)        | Order list / order status / profile                     | Referral code, copy button and WhatsApp share                                                                                                                                                                                                                                                                                                        | Heading, body message, copy-button and clipboard text                                                                                                                         |
| Account reward marketplace  | Profile block                                           | Your marketplace rewards (with a shortfall note on the ones the customer can't afford yet), redemption history, balance                                                                                                                                                                                                                              | Headings, balance label, shortfall note, empty states, button labels, success/error messages (reward wording is shared)                                                       |
| Wallet pass                 | Profile block + phone wallet (Google or Apple)          | Loyalty card: balance, member name, tier, QR code; updates when DollarBack issues or deducts credit or the tier changes (store credit spent at checkout does not update it)                                                                                                                                                                          | Issuer and program name, launch URL, per-platform images and colors, notification texts with variables, Google campaign broadcast                                             |
| Cart drawer cashback        | Rebuy · Upcart · Monster · AMP · theme drawer           | Cashback message inside the third-party drawer, mirroring the cart message                                                                                                                                                                                                                                                                           | Per-drawer enablement; inherits the cart message templates                                                                                                                    |

Every text field in this table can also be translated per language; see [Translate your widgets](/dollarback-store-credit/widgets-and-storefront/translate-your-widgets.md). The wording of the rewards themselves and their unlock conditions isn't in any one widget: it is shared by every reward marketplace and edited once in **Customize → Reward marketplace text**; see [Word your rewards](/dollarback-store-credit/spending-store-credit-and-rewards/set-up-the-reward-marketplace.md#word-your-rewards-reward-marketplace-text). The icons and illustrations on the widget and loyalty page are swappable independently of all of this; see [Icons & images](/dollarback-store-credit/widgets-and-storefront/icons-and-images.md). Theme developers who want to render cashback messaging in their own markup can use the [storefront window API](/dollarback-store-credit/developer-tools/storefront-window-api.md).

## Common issues

* A widget is activated but nothing appears on the storefront; see [A widget isn't showing on my store](/dollarback-store-credit/troubleshooting-and-faq/widget-isnt-showing.md).
* Store credit doesn't appear as a payment option at checkout; see [Store credit isn't available at checkout](/dollarback-store-credit/troubleshooting-and-faq/store-credit-isnt-available-at-checkout.md).

## Related articles

* [Activate widgets in your theme](/dollarback-store-credit/getting-started/activate-widgets-in-your-theme.md)
* [Product page & cart cashback messages](/dollarback-store-credit/widgets-and-storefront/product-page-and-cart-cashback-messages.md)
* [The floating cashback widget](/dollarback-store-credit/widgets-and-storefront/the-floating-cashback-widget.md)
* [Translate your widgets](/dollarback-store-credit/widgets-and-storefront/translate-your-widgets.md)