This article discusses features and capabilities available only for merchants on non-Shopify platforms. If you're using Shopify, visit this article.
ReferralCandy provides several widgets you can install on your store to promote your referral program. This article maps which widgets exist on the Widgets page, where each one fits in the customer flow, and how to install and customize each.
Before you start: where changes are made
Three surfaces are involved when working with widgets:
ReferralCandy Widgets page — where you get the install code snippets for each widget, and where you toggle Cookie consent. Path: ReferralCandy dashboard > select a campaign > Widgets.
ReferralCandy Themes / Visual Editor — where you customize the text, branding, and colors of each widget. Path: ReferralCandy dashboard > select a campaign > Themes.
Your store's site code or page template — where you paste the install snippet so the widget renders for your visitors.
Rule of thumb:
If you want to install a widget, copy the snippet from the Widgets page and paste it into your store's site code.
If you want to change the text, colors, or branding of an installed widget, use Themes / Visual Editor.
If a widget's design isn't updating after a Visual Editor change, the widget is fetching live from ReferralCandy — refresh the page on your store to see the update.
Widgets available
Listed in the order they appear on the Widgets page.
Post-purchase popup
Where it shows up in the flow
A customer completes a checkout → lands on your store's order confirmation / Thank You page → sees a popup inviting them to join the referral program and grab their referral link. They sign up directly in the popup.
Why use it
The Thank You page is the highest-intent moment in the customer journey for asking someone to refer — the customer just bought, so they're at peak enthusiasm. The popup catches them right then.
Where to install it
Open the page template or code that renders your store's purchase confirmation / Thank you page. Copy the post-purchase popup snippet from the Widgets page in ReferralCandy and paste it just before the closing </body> tag, then save. Qualified customers will see the popup right after checkout.
Where to customize it
ReferralCandy Themes > Customize — edit the popup's headline, body text, button text, colors, and branding.
For full setup details, see Showing a post-purchase popup to customers.
Embedded signup
Where it shows up in the flow
A visitor browses your store → lands on a specific page (typically a dedicated "Refer a friend" or "Rewards" page) → sees a signup form embedded inline with the page content. They fill in the form to enroll as an advocate. Already-enrolled advocates can log in here to access their referral link and rewards.
Why use it
Recruits new advocates from existing storefront traffic without bouncing them off your site. The embedded form also doubles as a login widget — already-enrolled advocates can use the same form to log in and view their referral link and rewards, so they don't have to dig through old emails for their link.
Where to install it
Open the specific page where you want the embedded signup form to appear (commonly a "Refer a friend" page). Copy the embedded signup iframe snippet from the Widgets page and paste it just before the closing </body> tag, then save. You can customize the iframe by adjusting attributes like data-height and data-width.
Where to customize it
ReferralCandy Themes > Customize — edit the form headline, field labels, button text, colors, and branding. The embedded form inherits styling from your active theme.
For full setup details, see Embedded signup.
Referral widget (floating)
Where it shows up in the flow
A visitor lands on any page of your store → sees a floating "Share and earn" widget anchored at the bottom corner → clicks it to open a signup form. They sign up to enroll as an advocate without leaving the page.
Why use it
A persistent, site-wide entry point. Unlike the embedded signup (which lives on one specific page) or the post-purchase popup (which only appears after a purchase), the floating widget is visible on every page where the snippet is installed. Like the embedded signup, it also doubles as a login widget — already-enrolled advocates can click it to log in and grab their referral link from any page, without having to find a specific signup page first.
Where to install it
Open the layout file or page template where you want the widget to appear on every page (typically the main layout / theme.liquid equivalent). Copy the referral widget snippet from the Widgets page and paste it just before the closing </body> tag, then save.
Where to customize it
ReferralCandy Themes > Customize — edit the widget's tagline, button text, colors, and position-related options.
For full setup details, see Using a floating Referral Widget.
Cookie consent
Where it shows up in the flow
A visitor lands on your storefront → sees a sticky banner at the bottom asking for cookie consent → either consents or declines. ReferralCandy uses cookies to attribute referrals back to the advocate who shared the link, so this banner is the consent moment for that tracking.
Why use it (or not)
Turn this on if your store serves customers in jurisdictions that require explicit cookie consent (GDPR in the EU, CCPA in California, etc.). Without consent in those regions, referral tracking may not work correctly for those visitors. If you don't serve those jurisdictions, or you already have your own cookie consent system, you probably don't need this.
Where to enable / disable it
ReferralCandy Widgets page — the Cookie consent toggle.
Where to customize it
This widget is typically minimal and mostly just enabled or disabled. If your store needs deeper styling or behavior changes, that becomes a theme or custom-code scope.
Other signup surfaces and the advocate experience
Beyond the widgets above, your campaign also has a hosted Join Page — a ReferralCandy-hosted signup page accessible via a link you can share via email, social posts, customer support replies, or anywhere a link works (no install required). See Join Page for how to find and customize it.
For the post-signup advocate experience — the Share Page, Your Rewards tab, and authentication flow — every advocate lands in the same RC-hosted journey regardless of which signup surface enrolled them. See What advocates see after signing up.
Quick cheat sheet: "Where do I edit this?"
"I want to install a widget on my store" → copy the snippet from the ReferralCandy Widgets page, paste it into your store's site code or page template.
"I want to change the text, labels, or branding of an installed widget" → ReferralCandy Themes > Customize (Visual Editor).
"I want to toggle Cookie consent on or off" → ReferralCandy Widgets page (Cookie consent toggle).
"I want to enable the Friend Offer Page (the page referred friends land on)" → that lives under the Friend Offer section of your campaign, not Widgets.
Widgets FAQ
Can I use widgets from multiple campaigns at the same time?
Can I use widgets from multiple campaigns at the same time?
Widgets are campaign-specific if you're running multiple campaigns. The ability to use widgets simultaneously depends on the widget type.
Note: Some widgets require technical expertise to set up.
Embedded widgets (the embedded signup form and the floating referral widget) are campaign-specific. Your campaigns don't share the same embed code, so each can be used simultaneously on different pages.
For the floating referral widget, we recommend using only one per page. For example, embed the main campaign's referral widget on your homepage, then create a separate page for a seasonal campaign where its referral widget is embedded.
The post-purchase popup can only be enabled for one campaign at a time.
Where do I configure the Friend Offer Page (the page referred friends see when they click a referral link)?
Where do I configure the Friend Offer Page (the page referred friends see when they click a referral link)?
The Friend Offer Page settings aren't on the Widgets page on Other Platforms — they live under Friend Offer in your campaign settings. The page design itself is edited in ReferralCandy Themes > Customize (the Friend Offer Page asset).
If your campaign's friend offer is a discount code, friends will see the code on the Friend Offer Page before clicking through to your store. If your campaign isn't offering a discount code for the friend, the Friend Offer Page is skipped — friends just land on your store URL directly.
Who can sign up through these widgets?
Who can sign up through these widgets?
The widgets themselves don't filter who can sign up — anyone who fills in the form is routed to the campaign's enrollment logic. Whether they actually become an enrolled advocate is controlled at the campaign level, not at the widget level, via the campaign's Target audience (segment criteria).
For example, you can set your campaign's target audience to "lifetime purchase value greater than $0" to make the campaign customer-only — non-customers who sign up through any widget won't be enrolled. Configure this in your campaign's Target audience / segment settings.