> ## Documentation Index
> Fetch the complete documentation index at: https://docs.nudj.cx/llms.txt
> Use this file to discover all available pages before exploring further.

# Referral Program (Shopify)

> Configure the referral program from the Shopify embedded admin: referrer + referee rewards, landing URL, and the analytics dashboard.

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.

<Info>
  The non-Shopify referral admin UX is documented in the Control Room tab. This page covers the Shopify surface specifically.
</Info>

## 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](/enterprise/shopify/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.

<Frame caption="Referral Programme configuration page: rewards for referrer and referee, condition type, and landing URL.">
  <img src="https://g0cvqggimgcfezpr.public.blob.vercel-storage.com/pr-screenshots/NUDJ-0000-docs-audit-enterprise-1776495079502/referral-analytics.png" alt="Referral Programme configuration page" />
</Frame>

## 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

<CardGroup cols={2}>
  <Card title="Refer-a-Friend widget" icon="puzzle-piece" href="/enterprise/shopify/storefront-widgets">
    Storefront block that surfaces the referral link.
  </Card>

  <Card title="Customer accounts" icon="user-circle" href="/enterprise/shopify/customer-accounts">
    The account surface referred users land on.
  </Card>
</CardGroup>

> Last reviewed: 2026-04 · Related PRs: #1733, #2084, #2126, #2240, #2253