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

# Landing Page

A referral landing page gives your program a permanent URL you can put anywhere — a menu, newsletter, order email, or social bio. Unlike the on-site widget, it's always there, and Bloop builds it as a real Shopify page on your own domain so it inherits your theme. Manage it under **Branding → Referral page**.

> **Best practice:** Use a clean, memorable handle (the default `referral-program` works well) and add the page to your main menu or footer before launch.

### When to use a landing page

Reach for the page whenever the share has to start somewhere other than your storefront: linking from email or a newsletter, a "Refer a friend" menu item, a social bio, search traffic, or explaining a program with rules worth reading. If you only need to catch existing customers while they browse, the [widget](/referral-program/branding/popup.md) alone is enough.

### What makes a referral page convert

* **A headline that names the reward.** "Give a friend 15% off, get $10 when they buy" beats "Join our referral program."
* **One obvious action.** A single button — competing calls to action lower the share rate.
* **A short how-it-works** (the **Guide** section) — three steps at most.
* **The reward stated plainly** (the **Reward** section) — both sides, in money or percentage terms.

### Create the page

1. On the **Setup** tab, choose a page URL handle — Bloop defaults to `referral-program` and builds the URL as `/pages/<handle>`.
2. Confirm to create the page. Bloop adds it to your Shopify store and links it to your campaign.

If the handle is already taken, Bloop asks you to pick a unique one.

### Manage the URL

The Setup tab lets you edit the **page title** and **URL handle** — choose **Update page** to save, **View page** to preview live.

> Avoid renaming the handle after launch — a changed handle breaks every link you've already shared.

### Edit the content and design

* **Content** — the **Content** tab edits page wording per language, grouped into **Main**, **Guide**, and **Reward**.
* **Design** — **Edit in theme editor** to style the page with your theme's sections and branding.

### Make the page easy to find

Add it to your **main menu** or **footer**, embed it into an existing page with Bloop's app block, and share the URL in newsletters and order confirmations. See [making your referral program visible](/best-practices/program-visibility.md).

### A worked example

*Illustrative, not measured Bloop results.* Keep the default `referral-program` handle, write a value-first headline ("Give a friend 15% off — get $10 when they buy"), style it to match your theme, then add it to the footer and newsletter. Watch [analytics](/referral-program/analytics/analytics.md) — impressions and shares should rise together as the sign it's working.

### Common mistakes to avoid

* **Building the page and never linking to it.** A page with no entry points gets no traffic.
* **A vague headline.** Name the reward for both sides in the first line.
* **Renaming the handle after sharing it.** Choose it once and leave it.

### Next steps

* Style the on-site widget in [referral widget branding](/referral-program/branding/popup.md).
* Add more entry points 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/page.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.
