Skip to main content
Nudj’s referral system lives on the community (community.referralConfig). The Shopify embedded admin surfaces the configuration so merchants can set it up without leaving Shopify.
The non-Shopify referral admin UX is documented in the Control Room tab. This page covers the Shopify surface specifically.

​
Configuration UI

PR #1733 shipped the referral program UI and loyalty settings inside the Shopify embedded admin. Merchants configure:
  • Referrer reward — what the existing user gets when a friend signs up (or hits the configured qualification event).
  • Referee reward — what the newly-referred user gets.
  • Qualification event — which action a referred user must complete for the referrer to earn.
Behind the scenes this writes to community.referralConfig, which the Referral achievement (a backing achievement type) uses to fire the two distribution events.

​
Landing URL

PR #2240 consolidated the referral landing URL handling and shipped a standalone referral widget alongside. Merchants get a single URL they can share through any channel; the URL routes through the Nudj referral resolver and hands off to Shopify / the loyalty UI. PR #2126 fixed an early issue where the referral page failed to load in the Shopify embedded admin — the fix ensures the admin can always read/write the referral config.

​
Refer-a-Friend widget

PR #2253 added a dedicated Refer-a-Friend storefront widget block. Drop it into any page via the theme editor; the widget renders the user’s personal referral link and a call-to-action. See storefront widgets for the full widget catalog.

​
Analytics dashboard

PR #2084 shipped a referral analytics dashboard across Shopify, API, and admin surfaces. The dashboard covers:
  • Number of invites sent.
  • Referral conversion rate.
  • Revenue attributed to referred customers.
  • Top referrers leaderboard.
Referral Programme configuration page

​
How rewards distribute

When a referee qualifies, two distribution events fire:
  1. Referrer event — credits the configured reward to the referring user.
  2. Referee event — credits the configured welcome reward to the new user.
Both events are scoped to the community’s referral config. Referral achievements are isolated from standard achievement APIs — they only surface where referral-specific queries are made.

​
Next steps

Refer-a-Friend widget

Storefront block that surfaces the referral link.

Customer accounts

The account surface referred users land on.
Last reviewed: 2026-04 · Related PRs: #1733, #2084, #2126, #2240, #2253