ReferralCandy gives you two ways for customers to sign up as advocates:

When you can run an embedded form, we recommend the Join Block — it's more seamless than redirecting customers to a separate hosted page. Reach for the Join Page when you specifically want a link to drop into a campaign email or social post without setting up theme blocks.

Both also double as login entry points — already-enrolled advocates can come back to either surface to get back to their referral link without digging through old emails.

Whether anyone who submits the form actually becomes an enrolled advocate depends on your campaign's Target audience (segment criteria), not the Join Block itself — see the "Who can sign up through the Join Block?" FAQ below.

For how the Join Block compares to the other Shopify referral surfaces (Referral extension, Friend offer landing, Customer referral details extension) and which to use when, see Widgets for your referral program. For what advocates see after signing up through the Join Block — their Share Page, rewards dashboard, and sign-in options — see What advocates see after signing up.

Three related things, edited in different places:

Tip: If you're looking at a page on your Shopify storefront and you see a signup form embedded in the page layout, that's the Join Block. If you're looking at a page on *.referralcandy.com or *.refr.cc, that's the Join Page.

To build the Join Block's signup form, open the Join block section of your campaign's Widgets page:

The form builder starts with two required fields — Full name and Email. For each field you can set the field type, a label, a placeholder, help text, and whether it's required; you can also reorder fields or remove them, and add new ones.

Available field types cover most signup needs: Text, Long text, Email, Phone number, Date, Checkboxes, Radio buttons, Select, Combo box, Country, PayPal email, Instagram, TikTok, YouTube, Facebook, X (Twitter), and Social media picker.

To add the Join Block to a page on your storefront:

The Join Block is linked to a campaign directly inside the block's settings in the theme editor:

Until a campaign is selected, the block shows a "Choose a campaign" placeholder in the editor preview. Once linked, the preview renders your real campaign content — heading, offer, and the form fields you built in Step 1.

Don't see your campaign in the picker? Campaigns sync from the ReferralCandy app — open ReferralCandy > Campaign > Widgets > Join block and grant the Shopify permission (Step 1), then reopen the picker.

The Join Block's layout, text, and styling are all edited in the block's settings sidebar in the Shopify theme editor. Pick one of four layouts under Layout:

Width, padding, and background controls sit alongside the layout picker, so you can match the block to the surrounding page.

The Editor preview setting switches which state of the block you're previewing and editing — Pre-signup, Post-signup, Unenrolled, or Waitlist view. This only changes the preview in the theme editor; on your live storefront, each visitor automatically sees the state that matches their actual referral-program status. Each view has its own text settings:

Leave any text field blank to use ReferralCandy's default wording for it. To personalize your own wording, use tokens — placeholders that fill in live campaign values: {referrerReward}, {refereeReward}, {campaignName}, {shopName}, {programTermsUrl}, {tierName}, {nextReferralCount}, and {nextTierReward}; post-signup text also supports {firstName} and {inviteLink}. Liquid tags and conditionals are not supported in the Join Block — the tokens replace them.

If your campaign uses tiered rewards, the Tier rewards settings control the tier table's text: the table header, column headers, an optional reward prefix (for example "Get"), the no-reward and completed-tier labels, and an optional note below the table.

The Style settings control colors and sizes — background, text, button, and input colors, heading and body text sizes, and corner radii. By default these inherit from your Shopify theme, so the block matches your store without any styling work.

Click Save when you're done.

When customers visit the page where the Join Block is embedded, they see the signup form with the fields you built in Step 1. If you're using a tiered reward structure, the tier table appears with the form, letting customers know when and how they get rewarded.

What happens after someone submits the form depends on their status in your campaign:

To change the wording customers see in any of these states, edit the matching view in the theme editor (Step 4) — switch the Editor preview to that view and update its text settings.

The Join Block inherits fonts and colors from your Shopify theme by default, and the Style settings (Step 4) cover most branding needs without code.

For advanced tweaks, the block's Custom CSS setting (under Advanced) accepts CSS declarations and CSS variables in a safe mode — nested rule blocks and at-rules are stripped. For full selectors, use your theme's own Custom CSS with the block's stable classes, such as .rc-jb__content, .rc-jb__title, and .rc-jb__button.

Note: ReferralCandy doesn't provide troubleshooting support for issues caused by custom code or custom themes.

The Join Block doesn't appear on my page

I can't find where to change the wording

Signing up through the block does nothing in the theme editor preview

I can't link a campaign to the Join Block

Before June 2026, the Join Block worked as a four-slot system: up to four Join blocks across all campaigns in your ReferralCandy account, each linked to one campaign from the ReferralCandy dashboard. These legacy blocks are deprecated but continue to work — no removal date has been announced. In the Shopify theme editor's Apps list they now appear as Legacy Join Block 1–4. For new placements we recommend the current Join Block (above), which adds layouts, per-state text editing, and in-block campaign selection.

If your store still uses a legacy block, here's where its settings live: