---
title: "Referred Friend Welcome Popup (SDK)"
slug: "referred-friend-welcome-popup-sdk"
tags: ["Loyalty and Referrals"]
updated: 2024-04-02T11:07:42Z
published: 2024-04-02T11:07:42Z
canonical: "support.yotpo.com/referred-friend-welcome-popup-sdk"
---

> ## Documentation Index
> Fetch the complete documentation index at: https://support.yotpo.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Referred Friend Welcome Popup (SDK)

Products

			
				
					
						  

					
					Loyalty & Referrals
		
			

				

###### Supported plans

				

Free, Pro, Premium, Enterprise

			
			

				

###### eCommerce Platform

				

N/A

			

The referred friend welcome popup is a way to greet incoming referred friends when they arrive on your site via a referral link. This is a basic feature that is used by every referral program. If you're not sure where to start, read [the Referral Popups overview article.](/v1/docs/referral-program-popups-overview)

The "Referred Customer Welcome" popup is **enabled by default** and will appear for any customers who arrive at your site by clicking on a **referral link**. The popup will present customers with their coupon code or points (depending on your [Yotpo Referrals settings](/v1/docs/article/setting-up-your-referral-program#customize-parameters)).

## Customizing the Popup

In your Yotpo Loyalty & Referrals admin go to**Programs> Referral Program**

1. Select **Referred Customer Welcome Popup** from the dropdown menu.
2. Click **Customize popup.**
		  
**![](https://cdn.document360.io/f3c2ab59-fe4c-4f93-9614-2872f40e8aa7/Images/Documentation/image-1684845138593.png?sv=2026-02-06&spr=https&st=2026-11-12T16%3A15%3A23Z&se=2026-11-12T17%3A15%3A23Z&sr=c&sp=r&sig=l%2BK6zwEWiCc5AchJgDbQgxe8ZdNDRr6hhY7fMaGWJN4%3D)**

		

## Settings

		

#### Popup Enabled?

If your popup is enabled, it means that it is live on your site, and no deployment is required. If toggled off, this popup will be disabled and not displayed on your site.
		  
![](https://cdn.document360.io/f3c2ab59-fe4c-4f93-9614-2872f40e8aa7/Images/Documentation/313b08d2-cba5-4010-9abf-89eebd688534.png?sv=2026-02-06&spr=https&st=2026-11-12T16%3A15%3A23Z&se=2026-11-12T17%3A15%3A23Z&sr=c&sp=r&sig=l%2BK6zwEWiCc5AchJgDbQgxe8ZdNDRr6hhY7fMaGWJN4%3D)

- Use the **Width** and **Height** bars to change the actual dimensions (in pixels) of the popup itself
- Use the **Upload Image** button to put an image in the background
- Click on the block of text you'd like to change, and a new editor menu will appear:

	
	Tip!
	This welcome message can be updated for fonts and colors, but we recommend keeping the message relatively straightforward from a stylistic perspective; **data suggests that elaborate imagery and design can actually be distracting and harm conversion.**

![](https://cdn.document360.io/f3c2ab59-fe4c-4f93-9614-2872f40e8aa7/Images/Documentation/52b48ef1-9e04-4344-8f37-aec49792e27f.png?sv=2026-02-06&spr=https&st=2026-11-12T16%3A15%3A23Z&se=2026-11-12T17%3A15%3A23Z&sr=c&sp=r&sig=l%2BK6zwEWiCc5AchJgDbQgxe8ZdNDRr6hhY7fMaGWJN4%3D)

#### Customize Error Messages

If a referred friend clicks on a referral link and they are not eligible to get a coupon, one of these error messages will display instead.

- **Coupon Used Error**
- **Not eligible error**

Once you are finished setting up your popups, go over the checklist to take the next steps for a complete [referral program setup](/v1/docs/setting-up-your-referral-program#customize-parameters).