Widget Settings
Widget Settings control the appearance and copy of your referral widget — the colors it inherits, the messages customers see, and which share options appear. Set them under Configure → Widgets.
This page covers configuring the widget. To put a widget on your site (script tag, shortcode, or hosted brand page), see Widgets.
Appearance
The widget inherits your Branding (logo and accent color).
Messages
Each widget has its own copy, which you can edit:
| Widget | Who sees it | Fields |
|---|---|---|
| Share | Customers signing up as advocates | Headline, description, button text, success message |
| Claim | Friends arriving through a referral link | Headline, description, button text, success message |
You can also set the share message: the text an advocate’s link is shared with.
Merge tags
Use these in any of the fields above. They’re replaced with real values when the widget shows:
| Tag | Replaced with |
|---|---|
{brand_name} | Your brand name |
{advocate_reward} | The advocate reward, e.g. $10 or 15% |
{referee_reward} | The friend’s discount, e.g. $10 or 15% |
{advocate_name} / {advocate_fname} | The advocate’s full / first name |
{referee_name} / {referee_fname} | The friend’s full / first name |
{referral_code} | The advocate’s referral code |
{referral_link} | The advocate’s referral link |
Names are only filled in once they’re known. On the claim widget, an advocate with no name on record shows as “A friend”. A name that isn’t known yet is left blank, so write copy that still reads well without it: Thanks, {referee_fname}! shows as “Thanks, !” until the name is known, while “Thanks for joining!” always reads well.
The live preview fills names with samples (Sarah for the advocate, Alex for the friend) so you can see how your copy reads.
The discount message at a WooCommerce checkout isn’t edited here: it follows your reward automatically, e.g. “15% off applied”.
Share channels
Choose which sharing options appear in the widget. Each can be switched on or off:
- SMS, WhatsApp and Email
- Facebook, X, Messenger, Telegram, LinkedIn and Reddit
- Copy link
Live preview
As you change settings, the dashboard shows a live preview so you can see the widget update before saving.
Save your changes
- Go to Configure → Widgets.
- Adjust appearance, messages, and share channels.
- Save — changes take effect on the next page load on your site.