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

# Referral Hub

The personal dashboard where referrers track rewards, tiers, links and activity.

The referral hub is a personal dashboard where a referrer sees their rewards, tier progress, referral link and code, and recent activity. It renders straight from your campaign — there's nothing to build. Brand it from **Branding → Referral Hub** when you're ready.

> **Best practice:** Link to the hub from your successful-referral and reminder emails. A referrer who just earned a reward is your best next referrer, and re-sharing from the hub is one click.

### What's on the hub

| Section          | What it shows                                                                                                    |
| ---------------- | ---------------------------------------------------------------------------------------------------------------- |
| Header           | Your logo, campaign selector (when they're in more than one), language picker, light/dark toggle, account menu   |
| Campaign banner  | The banner image you upload, plus the campaign name and what each side gets                                      |
| Referral methods | Their referral link and code, with copy buttons and the share channels you've enabled                            |
| My rewards       | Every reward earned, filtered by All / Available / Used / Revoked, with a **Shop now** button for discount codes |
| Reward tiers     | A progress timeline and what the next referral earns — shown only for tiered campaigns                           |
| Recent activity  | Referral events and their status: Pending, Reward sent, Reward declined                                          |

A revoked reward shows a note explaining why — see [reward revocation](/referral-program/reward-timing.md#revoking-a-reward). Referrers earning **cash** rewards who haven't given you payment details see a prompt to add them; see [cash rewards](/referral-program/rewards.md#cash).

If Bloop is briefly unreachable, the hub shows the referrer's last loaded copy with a notice that the data may be out of date, rather than an error page.

### How referrers get in

Every hub link Bloop puts in an email or an integration property is **permanent** — it doesn't expire, so a Klaviyo or Mailchimp flow that sends days later still works. Opening one signs the referrer in on that device and keeps them signed in until they log out from the account menu.

| Where the link comes from   | Property                |
| --------------------------- | ----------------------- |
| Bloop's own referrer emails | Built into the template |
| Klaviyo                     | `BLOOP Hub Portal`      |
| Mailchimp                   | `BLOOPHUB`              |

See [Klaviyo](/referral-program/integrations/klaviyo.md) and [Mailchimp](/referral-program/integrations/mailchimp.md).

> Because the link is permanent, treat it as a credential. Anyone who receives a forwarded hub link can see that referrer's rewards.

### Open the hub as a referrer

From **Referral → Contacts**, open a referrer and choose **Login as referrer** to see their hub exactly as they see it — useful when someone reports a missing reward or a wrong tier. Referrers can send themselves a fresh hub link any time from the **Referral link** block in their customer account; see [customer account extension](/referral-program/branding/account-extension.md#the-hub-link).

### Brand the hub

**Branding → Referral Hub** controls how the hub looks:

| Section        | What you set                                                                                                                                                                       |
| -------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Logo & favicon | Header logo (PNG, JPEG or WebP, max 5 MB) and browser favicon (PNG or ICO, max 5 MB)                                                                                               |
| Colors         | Primary brand color and background color                                                                                                                                           |
| Typography     | Font family                                                                                                                                                                        |
| Banner         | Campaign banner image — a wide image works best                                                                                                                                    |
| Content        | Page title, welcome subline, and the labels on every section: credit balance, campaign, "friend gets" / "you get", referral methods, tiers, activity, payment info, revoke warning |

A **Custom code** tab takes CSS and JavaScript that run on your live hub. Use it for the last 5% your brand needs — a web font, a tweak Bloop doesn't expose. Bloop support can't debug custom code, and a broken snippet can change how the hub looks or behaves.

Everything you set here is overridden by nothing else: the hub is the one surface a referrer returns to, so it's worth matching to your store properly.

### Languages and appearance

Referrers pick their own language from 21 options, including Catalan, and switch between light and dark themes from the header. A referrer who has never chosen follows their device's setting. Both choices stick on that device — nothing to set up on your side.

### Next steps

* Set what referrers earn in [Referrer and referee rewards](/referral-program/rewards.md).
* Give referrers more milestones with [FlexiTiers](/referral-program/tier-rewards.md).
* Put the hub on your own domain in [Sharing link](/account-and-settings/sharing-link.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/referral-hub.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.