> 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/popup.md).

# Popup & Widget

The referral widget is the most visible part of your program. When it matches your store's colors, fonts, and tone, it reads as part of your brand and gets used more. There are three surfaces: the **launcher** (the always-on button), the **panel** (the popup that opens after a click), and the **referee popup** (shown to a new visitor arriving via a referral link). All three live under **Branding → Widgets & Popup**.

> **Best practice:** Treat the launcher as advertising and the panel as the product. Keep the launcher quietly visible on high-intent pages (cart, product), and make the panel polished enough that sharing feels worthwhile.

### What to customize, and what tends to win

| Element              | What tends to win                                                         |
| -------------------- | ------------------------------------------------------------------------- |
| Panel background     | A clean, **light background**                                             |
| Imagery              | **Product-focused** creative over lifestyle photos                        |
| People in the design | **No-human design**                                                       |
| Reward framing       | Lead with the **referee's reward** first — reads as a favour, not a pitch |
| Trust cues           | **Social proof present** (share/join counts)                              |
| Launcher copy        | A **specific, value-led label** ("Give $10, get $10") over a generic one  |
| Launcher placement   | A **quiet presence on cart and product pages**, not sitewide              |

> These are broad A/B testing patterns, not measured Bloop numbers — confirm on your own traffic with an [A/B test](/referral-program/ab-testing.md). The underlying pattern: **simpler and product-led wins.**

### Style the widget panel theme

Open **Widget panel** — a **Design** tab (colors, typography, background, border) and a **Content** tab (wording per screen: Home, Reward, Send Email). Match the primary color and typography to your store, keep the background light, and preview each screen before saving.

### Configure the widget launcher

Open **Widget launcher** to set its **content** (title, icon), **placement** (position, desktop/mobile separately), **display** (icon/text per device), and **pages** (all, selected, or hidden). The two settings worth deliberating: a value-led **copy** earns more clicks than a generic one, and showing it only on **high-intent pages** (cart, product) nudges without nagging everyone.

### Customize the referee popup

Open **Referee popup** to edit the wording a new visitor sees after clicking a referral link — your first impression with them. Lead with the reward they've unlocked, name who sent it, and keep the call to action to one button. It's content-only; styling follows the widget panel theme above.

### A worked example

*Illustrative, not measured Bloop results.* Starting from defaults (colored background, stock lifestyle photo, a generic "Rewards" launcher everywhere), you apply the patterns above — clean background, hero product photo, launcher relabelled "Give 10% — get 10%," shown only on cart and product pages — then [A/B test](/referral-program/ab-testing.md) the new copy against the old before keeping it.

### Common mistakes to avoid

* **Over-branding the panel.** A crowded, heavily styled popup converts worse than a clean one.
* **Burying the reward.** Lead with the value in both the launcher label and the panel headline.
* **Changing everything at once, then guessing.** Change one thing, test it, then move to the next.

### Next steps

* Confirm a design or copy change with [A/B testing](/referral-program/ab-testing.md) before you keep it.
* Give customers a dedicated landing space with the [referral landing page](/referral-program/branding/page.md).
* Prompt buyers right after checkout with the [post-purchase popup](/referral-program/branding/post-purchase.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/popup.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.