Skip to content

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.

The Widget tab in the AdvocateLoop dashboard with live preview
Configure → Widgets, with a live preview of your changes.

Appearance

The widget inherits your Branding (logo and accent color).

Messages

Each widget has its own copy, which you can edit:

WidgetWho sees itFields
ShareCustomers signing up as advocatesHeadline, description, button text, success message
ClaimFriends arriving through a referral linkHeadline, 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:

TagReplaced 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

  1. Go to Configure → Widgets.
  2. Adjust appearance, messages, and share channels.
  3. Save — changes take effect on the next page load on your site.