# Customer Referral

Are you looking for a feature that encourages your customers to refer their friends within UpPromote? UpPromote team has released the **Customer referral** feature, which allows your customers to promote your products without the need of joining any affiliate program. It helps you boost sales with positive **word-of-mouth** as well as connect to your **loyal customers**.

![](https://2915776664-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LnqRFg4of77qA6qOdUp%2Fuploads%2FfEdsjimi0oLentw4MNvq%2Fimage.png?alt=media\&token=3d6cda75-fe5c-4a8f-9aee-c4d6e860b9c6)

***

<figure><img src="https://2915776664-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LnqRFg4of77qA6qOdUp%2Fuploads%2FgqWCxtnvVXUVOPoZfhKI%2FFrame%20(3).png?alt=media&#x26;token=403c6bc5-de4c-4aef-a810-9b94ab90bc99" alt=""><figcaption><p><a href="https://app.uppromote.com/admin/customer-referral/manage-display?utm_source=document&#x26;utm_medium=customer-referral&#x26;utm_campaign=promotion"><em>Login to UpPromote</em></a> <em>to set up your first landing page</em></p></figcaption></figure>

{% embed url="<https://www.youtube.com/embed/WyKkxhxXmJk?si=AZGJ_0vaOVgfTp1v>" %}

## **What you will get from this feature?**

1\.     **Easy-to-setup referral program**

* Activate/Deactivate the program with one click
* Customize reward and discount amounts easily

2\.     **Noticeable widget on your website**

* Easy-to-share referral links
* Set positions for the widget on your website
* Widget color and text settings&#x20;

3\.     **Potent rewards for customers and referred friends**

* Customer reward: Flat rate per order, Percent of sale&#x20;
* Friend discount: Fixed amount, Percentage, Free shipping&#x20;

4\.     **In-depth reports**

* Graphical report on conversions
* Filter by date and time
* Report on clicks, sales, referrals, and commission for each customer
* View successful referrals

5\.     **Promptly email notifications**

* Reward email is sent instantly
* Coupon codes are easy to redeem
* Customize email content and appearance&#x20;

6\.     **Sales booster**

* Increase brand awareness
* Appealing discounts for both customers and their friends
* Enjoy growing sales with this program

## How it works

1. Once you set up the feature, a Refer & Earn widget or Landing page (based on your display settings) will appear on your website to prompt customers to register for your referral program. Here's an example of the Widget display:

![](https://2915776664-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LnqRFg4of77qA6qOdUp%2Fuploads%2FvnW6G4zeR9ZVpF7GmvIx%2F6-get-email.png?alt=media\&token=2bc6d467-f2c4-47e7-aa19-3440f30e59b1)

When clicked, a popup introducing customers to the Referral program to get a discount. A referral link will be provided instantly when they fill out their emails and click on the **Get invite link** so they can use it to promote your store.

![](https://2915776664-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LnqRFg4of77qA6qOdUp%2Fuploads%2FLb2bd4AgYzGHrrcOxHzu%2FGroup%2015750.png?alt=media\&token=5003edc3-3e29-4ff4-ac3e-e624ce80799b)

![](https://2915776664-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LnqRFg4of77qA6qOdUp%2Fuploads%2FDhubMORlo9CX8VmgXg1i%2FGroup%2015767.png?alt=media\&token=9bab62e0-59da-4f64-a1e0-5695180e73e5)

2. Customers' friends will get a **discount** at checkout automatically while purchasing via that invite link.

![](https://2915776664-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LnqRFg4of77qA6qOdUp%2Fuploads%2FOUBN8IdNLBLySg3AANtz%2FGroup%2015766.png?alt=media\&token=235d7528-4173-49c7-8651-dc5195784f79)

3. An **email** will be sent to customers when their referrals are approved and paid successfully within UpPromote. The email includes the customer's **friend name**, your **shop name**, the **reward amount** as well as a button to claim their rewards.

<figure><img src="https://2915776664-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LnqRFg4of77qA6qOdUp%2Fuploads%2FZzjNHSlgyMTq3z6KKJBK%2FScreenshot_39.png?alt=media&#x26;token=aed8a36c-6f48-483b-a7fc-c70d067f9814" alt=""><figcaption></figcaption></figure>

4. The **Redeem your reward** button will redirect customers to a portal where they can view their total referrals, and commissions as well as claim these rewards for **coupons** to shop in your store.

<figure><img src="https://2915776664-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LnqRFg4of77qA6qOdUp%2Fuploads%2FsAbcixAA8tnkeNJOVPWt%2FScreenshot_15.png?alt=media&#x26;token=c94d2b19-e430-4232-93e2-f7604d7ee0f6" alt=""><figcaption></figcaption></figure>

{% hint style="info" %}
The customer login page will open when a customer clicks the **Redeem your reward** button in the email for the first time. A *temporary* password will be displayed there for the customer to use when signing in. After accessing the portal, they can change the password to their preferences.
{% endhint %}

<figure><img src="https://2915776664-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LnqRFg4of77qA6qOdUp%2Fuploads%2FcB1oWv9OaSvJ6wgqUuyj%2FScreenshot_36.png?alt=media&#x26;token=b0c2b68c-c3c7-4dc0-ace6-67d655fc3a70" alt=""><figcaption></figcaption></figure>

## How to set up

### **General settings**

Go to **Outreach** > **Affiliate recruitment** > **Customer referral** > click **Set up.**

<figure><img src="https://2915776664-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LnqRFg4of77qA6qOdUp%2Fuploads%2Flnyp7PptMx75jgXGuHdh%2Fimage.png?alt=media&#x26;token=b3732a14-6ab4-4792-bca0-fca4953b681f" alt=""><figcaption></figcaption></figure>

Then switch on the **Active** box to activate the feature.

<figure><img src="https://2915776664-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LnqRFg4of77qA6qOdUp%2Fuploads%2Fg04zu0SXQBsUT0EMdrma%2Fimage.png?alt=media&#x26;token=3c0d0eec-2227-48ff-bca2-b65b2282aaf8" alt=""><figcaption></figcaption></figure>

From here, you can set up the **Program name** for the Customer referral program (by default, the system will create a separate one for this feature).

There are two types of **Rewards** for your customers, which are the **Flat rate per order** and the **Percent of sale** that you can set a certain **amount** to. In the meanwhile, their friends can get a **Discount** by **Percentage**, **Fixed amount**, **Free shipping,** or no discount with the option **None**.&#x20;

{% hint style="info" %}
**Note:** After saving changes of Customer Referral at first setup or when you publish new Themes, please click on the link provided on the top banner of the **Settings** page to **enable** the function on your Themes, then **Save** to show Customer Referral display(s) on your website.&#x20;

<img src="https://2915776664-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LnqRFg4of77qA6qOdUp%2Fuploads%2FijXzCERwN0oogGbKgR0F%2Fimage.png?alt=media&#x26;token=2495c865-8e24-4088-90f6-5b1fc65590ef" alt="" data-size="original">
{% endhint %}

### **Displays**

😍 **NEW**: You can now select from different display types for your referral program's sign-up interface. These displays can be managed and customized in the **Display** section.

<figure><img src="https://2915776664-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LnqRFg4of77qA6qOdUp%2Fuploads%2F0BgHJJgPOqOzZ9KAp1zS%2Fimage.png?alt=media&#x26;token=4e24be7c-bfab-42ac-887f-fb2948f8ca8b" alt=""><figcaption></figcaption></figure>

There are three display options for customers:

#### **1. Widget**:

<figure><img src="https://2915776664-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LnqRFg4of77qA6qOdUp%2Fuploads%2FFAs2KOIs5rm6SLXV82YL%2Fimage.png?alt=media&#x26;token=386ea902-67b7-41a3-a366-07fd1efadf3b" alt=""><figcaption></figcaption></figure>

Once you enable the widget, it will appear as a floating button on your website. When clicked, it opens a popup where customers can register for your referral program and obtain their unique referral link.

<figure><img src="https://2915776664-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LnqRFg4of77qA6qOdUp%2Fuploads%2FwKK4tneuvSICifgT3ec9%2Fchittykittybang%20(1).gif?alt=media&#x26;token=3914d116-95bf-44b6-ab8e-4de0ccedabc9" alt=""><figcaption></figcaption></figure>

#### **2.  Post-purchase signup**

**NOTE:** This display is only available on the new Shopify checkout version. If your store uses the old checkout version, the Post-purchase signup will not appear on the Thank you/Order status page.&#x20;

To check which version of checkout your store is using, please go to *the Shopify settings > Checkout tab and* locate the *Configurations* section.&#x20;

If you see an info panel stating as below, your store is using the old checkout version.

<figure><img src="https://2915776664-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LnqRFg4of77qA6qOdUp%2Fuploads%2FdoJNRRdSjcmdx2sIbPty%2Fimage.png?alt=media&#x26;token=2245a555-2d41-4a1a-ad92-ca8421006275" alt=""><figcaption></figcaption></figure>

To upgrade the checkout version, please click **Customize** in the **Configurations** section to access Checkout editor > select the **Thank you** page > **Sections** > click **Publish** button on the banner.&#x20;

<figure><img src="https://2915776664-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LnqRFg4of77qA6qOdUp%2Fuploads%2FW8PFRB7x4Yo8Kyg4gD8N%2Fimage.png?alt=media&#x26;token=244669b8-1d54-4f84-92bb-5b6ff9a6dd06" alt=""><figcaption></figcaption></figure>

If it doesn't have that info panel, it means that your store is using the new checkout version.

<figure><img src="https://2915776664-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LnqRFg4of77qA6qOdUp%2Fuploads%2FKf3m6yhp9UHoEQDbLcdm%2Fimage.png?alt=media&#x26;token=01fc3e9e-0a96-4338-b289-560d0a839c51" alt=""><figcaption><p>New checkout version</p></figcaption></figure>

#### a. Turn on the display

<figure><img src="https://2915776664-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LnqRFg4of77qA6qOdUp%2Fuploads%2FpTDnqL6VKtaw8qVZOmpa%2Fimage.png?alt=media&#x26;token=0ad791df-6ead-4348-aead-42b53f857db1" alt=""><figcaption></figcaption></figure>

After enabling the display in settings, to show the Post-purchase signup form on your Themes, you'll need to add it as an app block on your **Thank you page** or **Order status page** by clicking on the **Add block** button at the top right corner of the settings section.&#x20;

Once you click on the Add block button, you'll be redirected to the **Thank you page**, tab Sections by default > click **Add app block** > select **Post-purchase signup.**&#x20;

<figure><img src="https://2915776664-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LnqRFg4of77qA6qOdUp%2Fuploads%2FEyW9UXL7EXLIhUwMDPVY%2Fimage.png?alt=media&#x26;token=89264370-ad3c-4847-bde0-34586d551a47" alt=""><figcaption></figcaption></figure>

After adding Post-purchase signup, you'll have various design options to customize it to fit more to your Themes.&#x20;

<figure><img src="https://2915776664-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LnqRFg4of77qA6qOdUp%2Fuploads%2FqiSCcg1vYOJCaHvSUOhl%2Fimage.png?alt=media&#x26;token=73b7b8a3-13f8-42ad-9da1-aaf951bf40e7" alt=""><figcaption></figcaption></figure>

If you want to add the Post-purchase signup display to the **Order status page**, simply switch to that page and add it there. Please note that you can customize the display separately for each page.&#x20;

#### b. Show only once per customer

To show the display just once per customer, you'll need to toggle on the function and grant us access to metaobjects. Please click on the **Update access** button on the banner to accept this.&#x20;

If this setting is off or you turn it on but haven't granted access, the Post-purchase signup display will appear every time the customer purchases. In case the customer has activated the Referral account before, the display will show his/her referral link immediately.&#x20;

**Note:** When you have granted access but then downgrade to the Free plan and upgrade back, you'll need to grant access again so that the **Show only once per customer** setting can work properly.&#x20;

<figure><img src="https://2915776664-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LnqRFg4of77qA6qOdUp%2Fuploads%2FsJ6tRs9f565znMCxLFyR%2Fimage.png?alt=media&#x26;token=e1223833-7d60-4877-8c00-b48ba531f1d2" alt=""><figcaption></figcaption></figure>

#### **3. Landing page:**

<figure><img src="https://2915776664-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LnqRFg4of77qA6qOdUp%2Fuploads%2F4Lw5WnSxP1x6Miwd2G53%2Fimage.png?alt=media&#x26;token=689b4108-dcfc-4c2e-bf77-9e29d7477be5" alt=""><figcaption></figcaption></figure>

Once enabled, this display type serves as a signup form that can be embedded into any page of your store, providing a dedicated space for referral sign-ups. Customers can easily sign up for your referral program directly on this page and receive their referral link to start promoting your store.

<figure><img src="https://2915776664-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LnqRFg4of77qA6qOdUp%2Fuploads%2FxugCLVZ3RRnh398AWLFx%2FChristy%20Snowboard.gif?alt=media&#x26;token=d3321ecb-756e-4975-ad9d-6316a2d4b6d7" alt=""><figcaption></figcaption></figure>

{% hint style="info" %}
Follow our [detailed instructions](https://docs.uppromote.com/outreach/affiliate-recruitment/customer-referral/add-referral-signup-form-to-store-pages) to add the landing page to your store.
{% endhint %}

There is one default display for customers' friends. Once you activate the Customer referral feature, the **Friend incentive popup** will appear on your website when referred customers (friends) go through a referral link.&#x20;

<figure><img src="https://2915776664-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LnqRFg4of77qA6qOdUp%2Fuploads%2FNfGntwOZzeLiVxcBsoLH%2Fimage.png?alt=media&#x26;token=9d979e47-7f99-4461-aad2-3c02e2d9b9c9" alt=""><figcaption></figcaption></figure>

Additionally, each display type now has its own dedicated editor, allowing for deeper customization of design and content. This ensures your referral program aligns perfectly with your brand. Simply navigate to each display section and hit **Customize** to access its editor. Here's an example:

<figure><img src="https://2915776664-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LnqRFg4of77qA6qOdUp%2Fuploads%2FNUrOk6gpTYe52QgnRxvT%2Fimage.png?alt=media&#x26;token=7bce3589-b1ea-42d1-b36d-76e2eb5014c0" alt=""><figcaption></figcaption></figure>

### **Email notification**

The system will automatically send an email whenever the merchant processes the payouts for the customer. You can fully customize this email template just like other email templates in the app.

<figure><img src="https://2915776664-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LnqRFg4of77qA6qOdUp%2Fuploads%2FWByQeSZDeZNZFJNkQ01f%2Fimage.png?alt=media&#x26;token=331edd34-20de-41b9-a99a-8d521bb9cbe8" alt=""><figcaption></figcaption></figure>

### **Customer referral program**

As soon as you finish setting up **Customer referral**, a program named **Customer referral** will be created automatically.

<figure><img src="https://2915776664-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LnqRFg4of77qA6qOdUp%2Fuploads%2F4zrCocULPyjXL5fckkRY%2Fimage.png?alt=media&#x26;token=f67ab985-0e13-40a4-b280-de3f2c4279b5" alt=""><figcaption><p>Programs tab</p></figcaption></figure>

Clicking on the **Customer referral** program name will take you to the **Customer referral** settings page.&#x20;

{% hint style="warning" %}
**Notes**

* The **Customer referral** program cannot be set as the default program.&#x20;
* If a customer has already joined the customer program with an email address, he cannot sign up as an affiliate of any other program using the same email address.
  {% endhint %}

### **Customer list**

Customer accounts will be displayed separately from the affiliate account list. To review your customer list, go to **Affiliates** > select **Customers**.

<figure><img src="https://2915776664-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LnqRFg4of77qA6qOdUp%2Fuploads%2F9NMNcY13F1Y6Y4nFIazX%2Fimage.png?alt=media&#x26;token=83ce1def-adce-4bbf-b415-da78e9659d0a" alt=""><figcaption></figcaption></figure>

### **Customer referral list**

The referrals brought by customers will be recorded on a separate list from the regular referrals brought by affiliates. To review the referral list brought by customers, go to **Referrals** > select **Customer referrals.**

<figure><img src="https://2915776664-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LnqRFg4of77qA6qOdUp%2Fuploads%2FNgjaGdzMG2P9oFZGvGJT%2Fimage.png?alt=media&#x26;token=0a60990a-81ae-438d-8ba3-af090a0e0851" alt=""><figcaption></figcaption></figure>

### **Real-time analytics**

You can get graphical reports on conversion statistics like Clicks, Referrals, Sales, and Commissions for the Customer Referral program and filter by date to evaluate the campaign's efficiency with the **Performance of your affiliates** chart on the **Dashboard**.

<figure><img src="https://2915776664-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LnqRFg4of77qA6qOdUp%2Fuploads%2F73Wyvvvt7NkjhPSCexnX%2Fimage.png?alt=media&#x26;token=146d89dc-145c-4ecc-8b36-c3fb2c1a6e18" alt=""><figcaption></figcaption></figure>

In case you want to assess each customer’s performance, you can also find it in the **Top Affiliate** board on the Dashboard as well. This report is also downloadable in various forms so you can compare it with other affiliate programs or assess the effectiveness of the customer referral program regarding the total sales of your store.

<figure><img src="https://2915776664-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LnqRFg4of77qA6qOdUp%2Fuploads%2FumylJKWM8B6HeFBxt5F6%2Fimage.png?alt=media&#x26;token=740c0395-8c54-4385-9108-5e9312e9b20d" alt=""><figcaption></figcaption></figure>


---

# 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://docs.uppromote.com/outreach/affiliate-recruitment/customer-referral.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.
