Skip to main content

Using a custom domain for your loyalty program

F
Written by Freddie Wynne

Available on: Plus plans

Custom domains let you replace the default LoyaltyLion URLs your shoppers see with a branded domain you own — for example, rewards.example.com. Instead of a referral link like prz.io/abc, your customers share rewards.example.com/r/abc. This makes your referral links, receipt upload page, and loyalty pass install page look like a natural part of your brand rather than a third-party tool.

You can add more than one domain and choose which features run on each, or run everything from a single branded domain (recommended for most merchants).


What you can put on a custom domain

A custom domain can serve any or all of these three features:

Referral links — the referral link a shopper shares with friends. Changes from https://prz.io/abc to https://rewards.example.com/r/abc.

Receipt upload — the page a shopper visits to upload a receipt. Served at https://rewards.example.com/receipts.

Loyalty passes — the page a shopper visits to download their loyalty pass. Served at https://rewards.example.com/passes.

Each feature can be assigned to one domain at a time. You can keep all three on a single domain, or split them across different domains if you prefer.


Before you start

You'll need:

  • A subdomain you own, such as rewards.example.com or points.yourbrand.com. Apex (root) domains like example.com are not supported — you must use a subdomain so your root domain stays free for your storefront.

  • Access to your DNS provider (for example Cloudflare, GoDaddy, Namecheap, or your domain registrar) so you can add DNS records.

  • A LoyaltyLion Plus plan.

A few domains are reserved and can't be used: anything ending in loyaltylion.com, prz.io, or storerewards.co.


Step 1 — Add your domain

  1. In your LoyaltyLion admin, go to Settings > Domains.

  2. Click Add domain.

  3. Enter the subdomain you want to use (e.g. rewards.example.com) and click Add domain.

The domain is created with a status of Pending DNS while it waits for you to set up the DNS records in the next step.


Step 2 — Add the DNS records

After adding your domain, LoyaltyLion shows you two DNS records to create. Add both in your DNS provider exactly as shown. (The exact CNAME target is shown on the domain's setup screen — always copy it from there, as it's specific to your account.)

1. CNAME record — routes traffic for your subdomain to LoyaltyLion

2. TXT record — proves you own the domain

Tip: Some DNS providers ask only for the subdomain portion of the name (e.g. rewards and _loyaltylion-verify.rewards) rather than the full hostname. If you're unsure, check your provider's help docs for how they handle CNAME and TXT record names.

Both records must be in place before the domain can go live — the CNAME alone is not enough.


Step 3 — Wait for verification

LoyaltyLion checks for your records automatically. Most DNS providers apply changes within an hour, though full propagation can occasionally take longer.

  • You can click Check now on the domain's page to trigger an immediate check rather than waiting.

  • The CNAME and TXT records are validated independently, so you'll see each one tick over to verified as it's detected.

  • Once both records are verified, LoyaltyLion automatically provisions a free SSL certificate (so your domain works over https://) and the domain moves to Active. You don't need to manage or renew the certificate yourself.

If the records aren't detected within 72 hours, the domain is marked Failed. You can fix the records and retry.


Step 4 — Assign features to your domain

Once a domain is Active, open it from Settings > Domains and turn on the features you want it to serve:

  • Referral links

  • Receipt upload

  • Loyalty passes

The feature toggles stay disabled until the domain is active. If a feature is already assigned to another domain, you'll be asked to confirm before moving it across.

That's it — new referral links, receipt upload pages, and loyalty pass pages will start using your branded domain.


Domain statuses

Status

What it means

Pending DNS

Waiting for you to add the CNAME and TXT records (and for them to be detected).

Provisioning

Both records verified; LoyaltyLion is issuing your SSL certificate.

Active

Live and ready — you can assign features to it.

Failed

Something went wrong (records not found within 72 hours, certificate couldn't be issued, or ongoing health checks failed).

Archived

The domain has been removed. Its hostname becomes free to add again.


Things to be aware of

Keep your DNS records in place. LoyaltyLion continuously monitors active domains. If you remove or change the CNAME record, the domain will stop working and eventually move to Failed. Leave both records in place for as long as you use the domain.

Keep a domain permanently once it's live. Once a domain is active, links built on it go out into the world — into referral emails sent via your email service provider, saved by customers, shared with friends. Those links point at your custom domain forever. If you later remove the domain (or delete its DNS records), any links already out there will break, and there's nothing LoyaltyLion can do to recover them. So treat a custom domain as permanent: if you want to change domains, add the new one and keep the old one connected (DNS records in place) so its existing links keep working.

Temporary outages recover on their own. This is different from removing a domain. If an active domain briefly becomes unreachable, newly generated referral, receipt upload, and loyalty pass links automatically fall back to the default LoyaltyLion URLs so nothing breaks, and the domain is picked back up automatically once it recovers.

Existing referral links. Customers who already have an old prz.io link will continue to work — the change applies to newly generated links.

Subdomains only. Use something like rewards.example.com, not example.com.

One feature, one domain. Each feature (referrals, receipts, passes) can run on a single domain at a time. You can mix and match across multiple domains, but most merchants find it simplest to run all three from one branded domain.

No limit on domains. You can add as many custom domains as you like.


Troubleshooting

My domain is stuck on Pending DNS. Double-check that both the CNAME and TXT records exist and match exactly what's shown on the domain's setup screen, including the _loyaltylion-verify. prefix on the TXT record name and the ll-verify= prefix on its value. Then click Check now. Remember some providers want only the subdomain portion in the Name field.

My domain moved to Failed. This happens if records aren't detected within 72 hours, the SSL certificate couldn't be issued, or an active domain's records were later changed or removed. Confirm your DNS records are correct and in place, then retry.

I don't see the Domains setting. Custom domains are available on Plus plans. If you're on Plus and still don't see it, please contact support.

Did this answer your question?