> 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/referral-program/how-customers-share-referral-links.md).

# How customers share referral links

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

\_This article's section starts at 4:25 in the video.\_

A referral program only works if customers can find their code without hunting for it. This page maps every storefront surface where a customer's referral code and share link appear, so you can decide which ones to enable and know what customers see on each.

## Prerequisites

* A live referral config. Codes exist only after generation completes ([Set up your referral program](/dollarback-store-credit/referral-program/set-up-your-referral-program.md)).
* The relevant widgets activated in your theme and checkout. See [Activate widgets in your theme](/dollarback-store-credit/getting-started/activate-widgets-in-your-theme.md).

## What customers actually share

Each customer holds one referral code (e.g. `FRIEND-8FK2`). The share surfaces wrap it in a link of the form `https://your-store.com/?ref=CODE`, plus a pre-written share message. Attribution is code-based: the friend must apply the code on their order, because clicking the link alone doesn't record anything ([How referral rewards are calculated & tracked](/dollarback-store-credit/referral-program/how-referral-rewards-are-calculated-and-tracked.md)).

## The share surfaces

| Surface                       | Where                                          | What the customer sees                                                                          |
| ----------------------------- | ---------------------------------------------- | ----------------------------------------------------------------------------------------------- |
| Floating cashback widget      | Site-wide launcher                             | Their referral code and link in the widget's referral view, alongside balance and ways to earn  |
| Customer account blocks (×3)  | Orders page · order status page · profile page | Referral code with copy-to-clipboard, plus their referral history                               |
| Loyalty page referral block   | Your loyalty page                              | The code, a copy button, and share buttons: email, Facebook, X, WhatsApp                        |
| Thank-you page referral block | Right after checkout                           | A referral invite with a copyable link, in separate versions for guests and logged-in customers |

### Floating widget

The referral view inside the floating widget is the always-available surface: any page, any time. Customers must be signed in to see their personal code; signed-out visitors see a login prompt. Styling and labels are editable in **DollarBack admin → Customization** ([The floating cashback widget](/dollarback-store-credit/widgets-and-storefront/the-floating-cashback-widget.md)).

### Customer account blocks

Three referral blocks live in the new customer accounts area (the orders index, the order status page, and the profile page), so the code is in reach exactly where customers check on an order. Each block shows the code with a copy button and message templates you can customize ([Customer account blocks](/dollarback-store-credit/widgets-and-storefront/customer-account-blocks.md)).

### Loyalty page

The loyalty page's referral block is the richest surface: headline, the program pitch (what the friend gets, what the referrer earns), the code with a copy button, and one-tap share buttons for email, Facebook, X, and WhatsApp that open pre-filled with the share message and link. All of the copy is editable, including the separate logged-in and logged-out variants ([Set up the loyalty page](/dollarback-store-credit/widgets-and-storefront/set-up-the-loyalty-page.md)).

### Thank-you page

The moment right after a purchase is peak goodwill, so the thank-you block invites the buyer to refer. It has distinct guest and logged-in states with a copyable link and its own imagery and copy ([Checkout & thank-you widgets](/dollarback-store-credit/widgets-and-storefront/checkout-and-thank-you-widgets.md)).

## Verify it works

Sign in as a test customer and walk the loop: open the widget, an account page, the loyalty page, and place a small order to see the thank-you block. The same code should appear on every surface. Tap a share button (WhatsApp is easiest on a phone) and confirm the message arrives with the working link and code.

## Common issues

* No code shows anywhere → code generation may still be running for a new config, or the customer matches no config; see [Referral codes & bulk sync](/dollarback-store-credit/referral-program/referral-codes-and-bulk-sync.md).
* A block is missing from a page → the widget or block isn't enabled in the theme/checkout editor; see [A widget isn't showing on my store](/dollarback-store-credit/troubleshooting-and-faq/widget-isnt-showing.md).
* Friends clicked the link but no referral was recorded → they didn't apply the code on the order; see [A referral wasn't tracked](/dollarback-store-credit/troubleshooting-and-faq/referral-wasnt-tracked.md).

## Related articles

* [Set up your referral program](/dollarback-store-credit/referral-program/set-up-your-referral-program.md)
* [Set up the loyalty page](/dollarback-store-credit/widgets-and-storefront/set-up-the-loyalty-page.md)
* [Customer account blocks](/dollarback-store-credit/widgets-and-storefront/customer-account-blocks.md)
* [Checkout & thank-you widgets](/dollarback-store-credit/widgets-and-storefront/checkout-and-thank-you-widgets.md)