> 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/affiliate-program/branding/on-site-content.md).

# On-Site Content

When a shopper clicks an affiliate's link, nothing on the landing page reflects that recommendation unless you make it visible. The identifier bar is a small on-site message — shown only on affiliate-referred visits — that names the person who sent them: "You're shopping with Jane Doe." It reassures the visitor the link was legitimate, keeps the affiliate's endorsement live at the moment of decision, and signals to affiliates that their promotion is recognized on your store. This page covers turning the bar on, writing its content, styling it, and previewing it.

You'll find this under the affiliate **Branding** tab, in the on-site content area.

> **Best practice:** Write the bar as a warm continuation of the affiliate's pitch, not a system notice. Use `{{FirstName}}` so the message feels personal, and consider surfacing `{{CouponCode}}` so the visitor sees their discount waiting. Keep it to one short line, match the colors to your theme, and confirm it doesn't cover navigation on mobile using the storefront preview before you publish.

### How the bar turns an endorsement into a trust signal

A referral link does its persuading off-site — in a post, a video, a message to a friend. By the time the shopper lands on your store, that endorsement is in the past. The identifier bar closes that gap, carrying the recommendation onto your store at the exact moment the visitor is deciding whether to trust the page.

That's why a single line of text punches above its weight:

* **It confirms the link was real.** A visitor who clicked an unfamiliar link arrives slightly on guard. "You're shopping with Jane Doe" tells them they're in the right place and dissolves that hesitation.
* **It keeps the endorsement live.** Naming Jane on the page keeps her vouching for you while the shopper browses, instead of letting the recommendation fade the moment they left her content.
* **It rewards the affiliate.** When affiliates see their name acknowledged on your storefront, the partnership feels real — a quiet but genuine reason to keep promoting you.
* **It can carry the offer.** Surfacing `{{CouponCode}}` turns the bar from a nicety into a nudge — the visitor sees a discount already waiting, which is a concrete reason to keep shopping rather than bounce.

The bar only fires on affiliate-referred visits, so it never clutters the experience for organic shoppers.

### Turning the bar on

A status toggle controls whether the identifier bar shows on your store. Turn it on to display the bar to visitors who land via an affiliate link; turn it off to hide it.

### Writing the content

The **content** field holds the message shown in the bar. You can personalize it with dynamic variables that Bloop fills in from the referring affiliate and their coupon:

| Variable         | Resolves to                 |
| ---------------- | --------------------------- |
| `{{FirstName}}`  | The affiliate's first name  |
| `{{LastName}}`   | The affiliate's last name   |
| `{{Email}}`      | The affiliate's email       |
| `{{CouponCode}}` | The affiliate's coupon code |

The default content is `You're shopping with {{FirstName}} {{LastName}}`. A copy menu lets you insert each variable into the field. The content can't be saved blank — an empty message is rejected.

#### Which variable to use, and when

The bar is one short line, so pick the one or two variables that do the most work for your goal — don't crowd all four in.

| Variable         | Use it when you want to...                                  | Note                                                                                            |
| ---------------- | ----------------------------------------------------------- | ----------------------------------------------------------------------------------------------- |
| `{{FirstName}}`  | Make the message feel personal and human                    | The workhorse — a first name reads warm and is rarely too long                                  |
| `{{LastName}}`   | Identify the affiliate more formally (with `{{FirstName}}`) | Good for business or professional partners; can feel stiff on its own                           |
| `{{Email}}`      | Rarely — debugging or a very formal context                 | Exposing an affiliate's email to shoppers is usually a privacy misstep; avoid it in public copy |
| `{{CouponCode}}` | Show the visitor their discount is already waiting          | Turns the bar into a nudge; pair with `{{FirstName}}` so it stays warm, not transactional       |

What tends to read well:

* **Warm and personal:** `You're shopping with {{FirstName}} — welcome!`
* **Endorsement plus offer:** `{{FirstName}} sent you a treat — use code {{CouponCode}} at checkout.`
* **Formal partner:** `Recommended by {{FirstName}} {{LastName}}.`

What to avoid: a system-notice tone ("Affiliate referral detected"), exposing `{{Email}}` in public copy, or stuffing every variable into one cramped line.

### Styling the bar

Two colors control the bar's look:

| Color      | Default   | Applies to           |
| ---------- | --------- | -------------------- |
| Background | `#001584` | The bar's background |
| Text       | `#FFFFFF` | The message text     |

Pick colors that fit your store theme while keeping the message readable. The **tweaking style** field also accepts custom CSS for fine-tuning beyond the built-in color pickers.

### A worked example: a friendly, offer-carrying bar

For affiliate Jane Doe (coupon `JANE15`): turn the bar on, write `Welcome! You're shopping with {{FirstName}} — use code {{CouponCode}} for 15% off` (renders as *"...shopping with Jane — use code JANE15..."*), style the background to your brand accent, then preview at phone width to confirm it doesn't cover your menu or cart before saving. Every visitor through Jane's link gets a personal welcome and sees their discount waiting.

### Previewing

A live preview renders the bar over a sample of your storefront so you can see the message, colors, and any custom CSS before saving. There's also an online-store preview action that opens your real store with the affiliate test parameter applied, so you can confirm the bar appears as expected on a referred visit.

### Saving

Changes are tracked as you edit and surfaced through the save bar at the top of the page. Save to publish the bar, or discard to revert to the last saved version.

### Common mistakes to avoid

* **Writing it like a system alert.** "Affiliate referral detected" tells the visitor nothing useful and breaks the warmth of the recommendation. Lead with `{{FirstName}}`.
* **Exposing the affiliate's email.** Putting `{{Email}}` in public-facing copy leaks the partner's address to every shopper. Use the first name instead.
* **Skipping the mobile check.** A bar that looks fine on desktop can cover your menu or cart on a phone. Use the storefront preview at phone width before publishing.

### When and why to use the bar

* **You want referred visitors to convert better** → the bar reinforces the endorsement and can surface the coupon at the decision point. Turn it on with `{{CouponCode}}` in the copy.
* **Affiliates ask whether their traffic is "recognized"** → the bar is visible proof their links are working on your site, which keeps them motivated to keep sharing.
* **You run discount-driven affiliate offers** → leading the bar with the coupon turns a passive notice into an active nudge toward checkout.
* **You're recruiting and onboarding new partners** → mention the on-site bar as a perk; affiliates like seeing their name on a real storefront. See [recruiting affiliates](/best-practices/recruiting-affiliates.md) for the wider partner experience.

### Related

* [Build your affiliate registration form](/affiliate-program/branding/registration.md) — brand the signup page affiliates use to join.
* [Style your affiliate portal](/affiliate-program/branding/portal-style.md) — brand the dashboard affiliates log into.
* [Getting started with affiliates](/quick-start/getting-started-1.md) — overview and onboarding.
* [Recruiting affiliates](/best-practices/recruiting-affiliates.md) — making the whole partner experience feel professional.


---

# 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/affiliate-program/branding/on-site-content.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.