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

Referral Hub

Once a customer starts referring, they have questions your dashboard can't answer for them: How many friends have I brought in? What have I earned? Where's my link again? The referral hub answers all of them in one place. It is a personal, hosted dashboard each referrer reaches from a link in your referral emails — where they see their rewards, track their progress through your tiers, watch their referral activity, and grab their link to share again.

It renders straight from your campaign, so there is nothing to build or switch on. Every referrer who receives a hub link already has a working hub. Your only job is to know what it shows them — and, if you use Klaviyo or Mailchimp, to drop the hub link into your flows.

Best practice: Treat the hub as the "share again" surface. A referrer who just earned a reward is your most likely next referrer — link them to their hub from the successful-referral and reminder emails so re-sharing is one click. The magic-link button is already built into those emails; your job is to keep the emails going out.

What the hub gives a referrer

The hub is the referrer's self-service "how am I doing" page. In one screen it shows:

  • Their rewards — every reward they've earned, with its status.

  • Their tier progress — how close they are to the next tier, if your campaign is tiered.

  • Their share tools — their referral link and code, and share buttons for the channels you've enabled.

  • Their recent activity — a live feed of referrals and what happened to each.

  • A campaign switcher — if they belong to more than one active campaign, they can switch between them.

  • A language selector — they choose the language the hub displays in.

How referrers get in

The hub uses a magic link — no username, no password. Referrer-facing emails carry a button that opens the referrer's own hub, already signed in.

  • The link is a signed, single-referrer credential. A referrer can only ever see their own dashboard — the old approach of a guessable ?referrer=<id> URL is gone.

  • Each link is valid for 2 hours from the moment the email was sent. Within that window the referrer can refresh, load more activity, and switch campaigns freely.

  • After 2 hours the link expires on every device, and the hub shows a message asking the referrer to open it from a recent email. Re-access simply means opening a newer email — there is nothing for you or the referrer to reset.

The hub button is added automatically to the referrer emails where it makes sense — Welcome, Pending referral, Denied referral, Not enough referrals, Referrer reward expiry, Remind referrer, Remind referrer to refer, and Referral progress. It is intentionally left off the "reward earned" success emails and all friend-facing (referee) emails.

For emails sent from Klaviyo or Mailchimp — which can go out days or months later — Bloop provides a separate permanent hub link that never expires. See adding the hub link to your flows below.

What's on the hub

Section
What the referrer sees

Header

Your store logo and name, the campaign selector (only when they're in more than one active campaign), the language selector, and their own name and email

Campaign banner

The campaign name, an active/inactive badge, and both reward lines — "Your friend gets…" and "You get…"

Referral methods

Their share link and share code (each with a one-click copy), plus share buttons for the channels you've enabled. Hidden when the campaign is inactive, and each of link/code respects your per-campaign "enable share link / enable share code" toggles

Reward tiers

Shown only for tiered campaigns: a timeline of tier milestones with done / current / upcoming markers, the reward at each step, and a progress headline. Supports looping tiers and the "count referrals from a date" mode

My rewards

Every reward earned, with a type icon (discount code, store credit, cash, or custom), title, dates, and a status badge — Available, Used, or Revoked. Filter tabs let them narrow the list, and discount codes get a copy button

Recent activity

A paginated feed of referral events — a friend's purchase, the amount, and a status (pending, reward sent, declined, or revoked) with a timestamp

Everything here comes from your existing campaign: the reward types and values, the tier structure, the share channels you enabled in branding, your store currency, and your Bloop translations. You don't configure the hub separately.

Apply a discount straight to the cart

Discount-code rewards on the hub get a Shop now button. Clicking it sends the referrer to your storefront with the discount already applied — they never have to copy a code or type it at checkout, and a short confirmation toast tells them it's done. This applies only to discount-code rewards; store credit, cash, and custom rewards don't need it.

Revoked rewards are explained

If a reward was clawed back — because the order behind it was cancelled or refunded — it appears in My rewards with a Revoked badge and a note explaining why. This keeps the referrer informed rather than leaving them wondering where a reward went. See reward revocation for how and when this happens.

Languages

The referrer picks the hub's language themselves, from 20 languages shown in their own native names — English, Deutsch, Español, Français, Italiano, Dansk, Suomi, 日本語, Polski, Português, 한국어, Nederlands, Magyar, Türkçe, Română, ไทย, Svenska, Čeština, 简体中文, and 繁體中文. The choice is remembered for future visits. Every hub label is already translated, so there is nothing for you to set up.

Because a Klaviyo flow or Mailchimp journey can send an email long after a referral happens, the 2-hour magic link isn't suitable there. Instead, Bloop syncs a permanent, non-expiring hub link for each referrer that you can use as a call-to-action button in any flow email:

  • Klaviyo — the profile property BLOOP Hub Portal (use {{ person|lookup:'BLOOP Hub Portal'|default:'' }}).

  • Mailchimp — the merge field BLOOPHUB (use *|BLOOPHUB|*), added to your connected audience automatically on the first sync.

Drop that link on a button in your referral flows so advocates always have a live way back to their hub, whenever the email lands. See Klaviyo integration and Mailchimp integration.

What you control

The hub has no separate on/off switch or storefront block — it is available to any referrer who receives a hub-link email, and it mirrors your campaign. What shapes it is the configuration you already set:

  • Rewards and their values come from your referrer reward setup.

  • Tiers come from your tier structure and its after-final-tier behavior.

  • Share channels come from the sharing methods you enabled in branding.

  • Link and code visibility follow your per-campaign share-link and share-code toggles.

  • The permanent hub link is the one thing you actively place — as a button in your Klaviyo or Mailchimp emails.

Next steps

Last updated