Referral Welcome Popup

The Referral welcome popup is the first thing new shoppers see when they arrive at your shop via a referral link from their friends. The popup will display a coupon code or points shoppers can use with their purchases.

This is your brand’s way of greeting and enticing them to explore your store and make a purchase. 

Creating a popup

New merchants

The popup is automatically enabled for new merchants who recently joined Yotpo Loyalty & Referrals.

To access referral welcome popup:

1. In your Yotpo Loyalty & Referrals admin, go to On-site Modules > Referral Modules.
2. Scroll down to the Referral Welcome Popup section.

You can go ahead and customize the welcome popup to better fit your brand’s design.

Existing merchants

Existing merchants who joined Yotpo before the 25th of March, 2021, will need to access the module and create a new popup instance.

To create a referral welcome popup instance:

1. In your Yotpo Loyalty & Referrals admin, go to Display On-site Modules > Basic Modules > Referral.
2. Scroll down to the Referral Welcome Popup section.
3. Click the Create button.

If you choose to publish the new Referral welcome popup, the old popup will be automatically disabled.

You can revert back to the old popup at any time by enabling it. This will automatically disable the new popup module.

Customizing your popup

You can customize every aspect of the popup to fit your brand’s voice and tone. 

General appearance

Email capture

Activating the setting will add an additional step to the popup where referred friends must fill in their email addresses before they can see the discount code.

This step can help in boosting security and preventing referral fraud.

Image & background

In this section, you can choose the different design elements for the popup:

• Display image on both mobile and desktop
• Background color and opacity
• Fonts

Advanced customization

At the bottom of the tab, you’ll find the Custom CSS option for advanced code editing of all the different elements. 

Simply use the “Inspect” action of your browser to hover over an element you wish to edit to learn its name and which CSS rules are already applied to it.

Text design

In this section, you can adjust the content, size, and color of the different popup text elements.

If you turned on the Email capture setting, you will be able to choose between the popup steps to adjust both the popup text and the error messages relevant to each step.

Popup text

Here you can adjust the title, subtitle, and button text that appear in the popup.

Error messages

In this section, you can change the color and content of the different error messages the user may encounter. Each error message you edit will be shown on the preview screen so that you will be able to see exactly what the shopper sees.

The different messages and their use cases:

• Invalid email -This message will appear if the provided email address does not fit the regular format of email addresses, for example - if the address is missing the "@" character.

• Not eligible - This message will appear if the referred friend is not eligible to receive a reward. For example, if the referred friend’s details match those of the referrer.
• Used this offer - This message will appear if the friend already used their referral reward.
• General error - This error will appear if there’s a general problem with the site or referral program. This can display if the coupon code can’t display for any reason.
• Safari privacy settings error - This error message will appear if the "Hide IP address" setting in the referred friend's Safari browser is turned on. Since this setting aims to hide personal details, if turned on, Yotpo’s fraud prevention system will not allow the referred friend to participate in the referral program. To get the discount code, the referred friend must first turn off the "Hide IP address" option in their Safari privacy settings, then click the referral link again.

Saving and publishing your popup

Once you’re done customizing your popup, you can save it by clicking the Save icon.

Unlike the other modules, the Referral welcome popup can only have one instance. This means that only one popup design can be created and then redesigned as you see fit.

To publish your popup and make it available to referred friends, go to the top right corner of the preview window and click on Publish. 

After clicking Publish, the popup will automatically appear on the webpage you defined as the Landing URL in your Referral Program settings. 

If no URL is defined and the field is left blank, the referral link will lead the user to the address defined as the Website URL in the Settings > General section of your Loyalty admin.

Any customizations you save and publish on this popup moving forward will not need another copy and paste of the code.