For the complete documentation index, see llms.txt. This page is also available as Markdown.

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 for the wider partner experience.

Last updated