# Referral Signup Widget

This widget can be embedded into your website or used as a standalone landing page. It features a dynamic message or signup form, specifically designed to engage and convert identified referrals.

{% hint style="info" %}
Note: If the email confirmation requirement is enabled, the user signing up must confirm their email before they will be added to your campaign.
{% endhint %}

**Ideal Uses for the Referral Signup Widget:**

* **Targeted Messaging:** Customize the widget to display unique marketing messages or promotional offers to new referrals. For example, you can create a personalized message like, “A special friend referred you! Sign up now to receive your exclusive coupon code.”
* **Enhanced Lead Capture:** Deploy multiple widgets across various sections of your site, such as at the bottom of blog posts or on dedicated landing pages, to capture leads from different touchpoints.

### **User Experience:**

1. **Initial Display:** Visitors are greeted with a signup form designed to capture their details.
2. **Post-Signup:** After a successful registration, users are presented with a confirmation screen, completing their signup process.

   <figure><img src="/files/NpRZYrrLXOUZpqyXTazW" alt=""><figcaption><p>Referral Sign up Widget &#x26; Confirmation screen</p></figcaption></figure>

### Customize the Referral Signup Widget:

1. **Navigate to Campaign Overview:** Begin by accessing your campaign's settings.
2. **Edit Your Campaign:** Click on "Edit Campaign" to modify your existing setup.
3. **Open the Widget Builder:** Select the "Widget Builder" option to start customizing your widget.
4. **Select the Signup Widget:** Choose the "Signup Widget" from the available options.
5. **Customize the Confirmation Screen:** Find and click on the message that says “Thank you for Signing Up.”
6. **Edit the Text:** Customize the text in the ‘Property Options’ to match your desired message.

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

### Install the Signup Widget on your website:

1. **Access Your Campaign Settings:**
   * Go to your **Campaign Overview**.
   * Select **Edit Campaign**.
2. **Copy the Global Tracking Code:**
   * Navigate to the **Launch** section and copy your ReferralHero Global Tracking Code.
3. **Add the Tracking Code to Your Website:**
   * Insert the Global Tracking Code into the `<head>` section of your website to ensure it loads on every page.
4. **Place the Signup Widget on Your Page:**
   * Paste the following code snippet exactly where you want the widget to appear, making sure it’s within the `<body>` tag of your page:

```javascript
<body>
  <div id='referralhero-signup-widget-MFxxxxxxxxxx'></div>
</body>
```

This will embed the Signup Widget directly into your website, allowing users to easily sign up for your referral campaign from the specified location on your page.


---

# Agent Instructions: 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:

```
GET https://berylsystems.gitbook.io/referral-hero-documentation/integrations/embeddable-widgets/referral-signup-widget.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
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.
