Skip to content
Leat Help Center

Connect your own domain to the contacts portal

Your contacts portal always has an address on a Leat subdomain, like yourcompany.app.leat.com. You can add another Leat subdomain, or connect a domain you own so contacts see something like loyalty.yourcompany.com.

Where to find it

  1. Go to Apps → Contacts portal and click Edit contact portal.
  2. Open the Settings tab and select Domains. The list shows every domain you've added, each marked Custom domain or System domain. The badge is green once the domain is verified.
  3. Click Link domain at the top right.

On Type, pick one of the 2 kinds and click Next:

  • Leat Subdomain: an address ending in .app.leat.com. There's nothing to set up on your side, and it's approved straight away.
  • Custom domain: a domain you own. You add 1 DNS record at your domain provider, and we check it.

A domain can't be changed once it's added, so check the spelling before you continue.

Add a Leat subdomain

  1. On Domain, type only the first part in Your domain. The .app.leat.com part is already filled in. Click Next.
  2. On Verify, click Create at the top right.

The first part can have lowercase letters, numbers and single hyphens, up to 63 characters. It can't start or end with a hyphen. The reserved words below apply here too, and the address can't already be in use by another portal.

Connect your own domain

Pick the address

Use a subdomain, such as loyalty.yourcompany.com or rewards.yourcompany.com. A root domain like yourcompany.com won't work: the connection needs a CNAME record, and DNS doesn't allow one on a root domain.

Leave out https://, the field already shows it. These are refused when you click Next:

  • Capital letters. Type the domain in lowercase.
  • A domain that starts with www., or has 2 hyphens in a row.
  • A domain with a reserved word, such as "leat", as a word of its own, like leat.yourcompany.com. You'll see "Part of your value contains a reserved word." A domain that only contains those letters, like leathergoods.com, is fine.
  • A domain that's already used by a portal, yours or anyone else's. You'll see "This domain has already been taken. Please try something else."

Add the domain and the DNS record

  1. On Domain, enter the full address in Your domain, for example loyalty.yourcompany.com, and click Next.
  2. On Verify, the table shows the 1 record to add: Type CNAME, Host the domain you entered, and a Value. Copy the value exactly as the table shows it. Don't type it from memory or from another article.
  3. Add the record in the DNS settings at the company that manages your domain, usually your hosting provider or domain registrar:
    • Many providers only want the subdomain part in the host field. For loyalty.yourcompany.com you then enter loyalty. Others want the full name. Your provider's help pages say which.
    • If your provider can proxy the record, like Cloudflare's proxy, switch that off so the record is DNS only.
  4. Click Create below the table. That saves the domain and checks the record once. The Status in the table changes from Pending to Success when the record is found, or to Failed with the reason above the table.
  5. Once the domain is saved, Verify takes the place of Create. Click it to check again once your record is in.
  6. Click Submit at the top right to go back to the editor. It stays greyed out until you've clicked Create. You don't have to wait for the record to verify, you can verify later from the domain's details.

DNS changes take a while to spread. We only check when you click Create or Verify, so if it fails right after you added the record, wait and click Verify again.

What the status means

Click a domain in the list to open its details, with its address, its status and when it was added.

  • Created: for your own domain, it's saved but its record hasn't been found yet. The Leat subdomain your portal started on also shows Created, in green, and works as normal.
  • Setting up: the record was found, and we're setting up the domain.
  • Verified: the record was found and the domain is connected. The secure https connection is set up in the background right after, so the address may not open straight away.
  • Setup failed: the record was found, but setting up the domain didn't finish. Click Verify to try again.

Verify on the details page checks your own domain's record again. Click it, then click Verify in the dialog, which then shows the result.

You can have several domains side by side. When we put a link to your portal in an email, on a wallet pass or in a login link, we use:

  1. Your own domain, once one is verified.
  2. Otherwise your oldest domain, which is usually the Leat subdomain your portal started on.

You can't pick a different one. When a contact asks for a login email on the portal itself, the link uses the address they were on.

Moving to a different domain

A domain can't be renamed. To move, add the new domain, wait until it's verified, then delete the old one.

Deleting a domain

Open the domain from the list, click Delete, and click Delete again in the dialog.

  • Deleting your own domain takes it offline. Links already sent with that domain stop working.
  • Your portal's last Leat subdomain can't be deleted, so it has no Delete button.

When your domain won't verify

The check looks for a plain CNAME record on exactly the domain you entered, and compares where it points with the Value in the table. The message tells you which part failed.

"No CNAME records were returned for host …" means we found no CNAME record on that name. The usual causes:

  • The record hasn't spread yet. Wait and click Verify again.
  • The host is wrong. If you typed the full name in a field that only wants loyalty, your provider may have created loyalty.yourcompany.com.yourcompany.com.
  • The record is proxied or flattened, for example with Cloudflare's proxy on. The lookup then returns an IP address instead of a CNAME. Set the record to DNS only.
  • You entered a root domain like yourcompany.com. Delete it and add a subdomain such as loyalty.yourcompany.com instead.
  • You added an A or TXT record instead of a CNAME.

"CNAME target: … did not match the required url: …" means the record exists but points somewhere else. Copy the Value from the table again, exactly.

If it still won't verify, check with whoever manages your DNS first. They can see the record as it's actually published.

Back to the help center