> For the complete documentation index, see [llms.txt](https://berylsystems.gitbook.io/referral-hero-documentation/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://berylsystems.gitbook.io/referral-hero-documentation/integrations/embeddable-widgets/referral-welcome-banner.md).

# Referral Welcome Banner

The Referral Welcome Banner is a versatile widget designed to appear at the top or bottom of your website. It features a dynamic message or signup form aimed at engaging and converting identified referrals.

### **User Experience:**

1. **Signup Form:**

   * Visitors or referrals first encounter the signup form. This form can be displayed to all site visitors or limited to referrals only, based on your campaign settings.

   <figure><img src="/files/OGZYsL6ikUN2qnKKwBO2" alt=""><figcaption></figcaption></figure>
2. **Confirmation Screen:**

   * After a successful signup, users are presented with a confirmation screen, reinforcing their engagement with your referral program.

   <figure><img src="/files/He5iSsuteu7B74v3tRXN" alt=""><figcaption></figcaption></figure>

### **Customize the Referral Welcome Banner:**

1. Navigate to **Campaign Overview**.
2. Click on **Edit Campaign**.
3. Select **Widget Builder**.
4. Choose **Referral Welcome Banner** to customize the banner's design, message, and settings to align with your campaign goals.

   <figure><img src="/files/Rmb2jw98PAUG5qvMEvRf" alt=""><figcaption></figcaption></figure>

### **Install the Referral Welcome Banner on your website:**

1. **Add the Global Tracking Code**:
   * Navigate to **Campaign Overview > Edit Campaign > Launch** and copy your Global Tracking Code.
   * Paste this code into the `<head></head>` section of your website to ensure it loads on every webpage.
2. **Enable the Welcome Banner**:
   * Go to **Campaign Overview > Edit Campaign > Launch > Step #3 > Referral Welcome Banner**.
   * Toggle the banner **ON**.
3. **Customize Display Settings**:
   * Decide whether you want the banner to display for all visitors or only for referrals.

     <figure><img src="/files/liCfp1od2K09eHwQeM83" alt=""><figcaption></figcaption></figure>


---

# 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://berylsystems.gitbook.io/referral-hero-documentation/integrations/embeddable-widgets/referral-welcome-banner.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.
