Referrals

Issue and manage referral codes, enforce per-code and per-user limits, track every redemption, and optionally require or apply a code at registration, including OAuth and magic-link signup. Shared links like ?ref=CODE are remembered in the visitor's browser for 30 days and filled in at signup. The tables are still created by PhoenixKit core migrations.

Use it when

• You run an invite or referral program and need to know who brought whom
• Registration should be invite-only, requiring a valid code

What it gives you

• Code CRUD with random generation and an optional beneficiary user
• Expiry dates, per-code usage caps and a per-user code limit
• Usage records and stats per code
• Code field in registration, OAuth and magic-link flows
• Referral link capture (?ref=CODE, first-touch, 30-day TTL)
• Admin section Referrals (Overview, Codes) and Settings > Referrals

Example

{:ok, code} =
  PhoenixKitReferrals.create_code(%{
    code: "WELCOME",
    description: "Welcome promotion",
    max_uses: 100
  })

Nothing posted about Referrals yet. Read its changelog or see all PhoenixKit news.