> For the complete documentation index, see [llms.txt](https://docs.bloop.plus/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.bloop.plus/referral-program/branding/post-purchase.md).

# Post-Purchase Widget

Ask for the referral on the thank-you page, when enthusiasm peaks.

The moment right after checkout is the best time to ask for a referral: the customer is at peak enthusiasm, the thank-you page has nothing else to click, and you know exactly who they are. Bloop puts a referral block there as a Shopify checkout UI extension, so it renders natively on the order status page.

Open **Branding**, pick your [theme](/referral-program/branding/themes.md), choose **Customize**, and open the **Post-purchase popup** card. Like the [referral page](/referral-program/branding/page.md), it's marked **Recommended** — these two surfaces carry most of a healthy programme's shares.

> **Best practice:** Lead with the referee's reward, not your ask. "Give friends $10 off — and earn $10 yourself" frames sharing as generosity. Keep it to one sentence and one button.

### Add the block to your checkout

The block doesn't appear until you place it:

1. **Edit in checkout editor** opens Shopify's checkout and accounts editor.
2. Select the **Thank you** page.
3. **Add app block**, choose Bloop's **Referral block**, and position it.
4. Save.

Bloop's checkout extension also renders a redemption block during checkout, so a referrer can claim a [free product reward](/referral-program/rewards.md#free-product) on their next order.

### Write the content

Two content blocks, each saved per language:

| Block          | What it covers                                                                   |
| -------------- | -------------------------------------------------------------------------------- |
| Referral block | The prompt on the thank-you page — the headline, the reward line, and the button |
| Email sending  | The copy shown when the customer invites a friend by email from that prompt      |

Spend your effort on a one-line, value-led referral block. Keep the email warm and personal: it arrives as if from a friend, and it should read that way.

Switch languages with the selector before you type — unsaved edits are discarded when you change it.

### Copy that works

| Do                                     | Why it works                                      |
| -------------------------------------- | ------------------------------------------------- |
| Lead with the friend's reward          | Frames sharing as generosity, not self-interest   |
| State both rewards in one line         | Two-sided offers outperform give-only ones        |
| Keep it to one sentence and one button | The thank-you page rewards a fast, obvious action |
| Make the share one tap                 | Fewer steps, more links sent                      |
| Match the tone of the page             | A celebratory voice beats a corporate pitch       |

### A worked example

*Illustrative, not measured Bloop results.* The default "Refer a friend and earn rewards" is generic and leads with your benefit. Rewriting it to "Loved your order? Give a friend $10 off — and earn $10 yourself" puts the friend first. An [A/B test](/referral-program/ab-testing.md) against the default shows share rate rising from 3% to 5% — a real gap — so you keep it.

### Common mistakes to avoid

* **Writing the copy and forgetting to add the block.** Nothing appears on the thank-you page until you place it in the checkout editor.
* **Leading with your ask, not their reward.** Put the friend's discount first.
* **Writing a paragraph.** One clear sentence — a pitch loses the moment.
* **Not localizing.** An English-only prompt fails the customers most likely to refer in another language.

### Next steps

* Brand the on-site widget in [Widget panel, launcher and referee popup](/referral-program/branding/popup.md).
* Add a permanent entry point with the [referral page](/referral-program/branding/page.md).
* Catch repeat customers with the [customer account extension](/referral-program/branding/account-extension.md).


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.bloop.plus/referral-program/branding/post-purchase.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.