Skip to main content
When you finish, dl.js, event ingest, and your tracking links all load from a subdomain you own, such as go.acme.com.

​
Before you start

  • You must have the owner or admin role.
  • You must control DNS for the domain.
  • You must use a subdomain. An apex domain such as acme.com cannot carry a CNAME, so it never reaches Active.
Three hostnames are rejected outright: any name ending in datalyr.com, lyr.link, or dlyr.link.

​
Add the domain

  1. Open Settings → Domains.
  2. Enter the subdomain in the Add a tracking domain card, such as go.acme.com.
  3. Select add domain.
We create a Cloudflare custom hostname for you and show the DNS records you need.

​
Create the DNS records

The card lists two records. Create both at your DNS provider.
If your domain is on Cloudflare, set record 1 to DNS only, the grey cloud. A proxied orange-cloud record breaks certificate issuance, and the domain never reaches Active.
A third record appears only after verification fails. It is an ownership TXT record. Add it and verify again.

​
Verify

  1. Return to Settings → Domains.
  2. Select verify.
The status pill moves through four values. Active also unlocks two counters on the card: the number of tracking links on the domain, and unique clicks in the last 30 days. We re-check every domain once a day at 04:00 UTC, so a slow DNS change resolves itself.

​
Make it the default

Only a domain at Active can become the default. The default domain is the host inside the snippet on Settings → Install.
  1. Select make default on the domain card.
  2. Open Settings → Install.
  3. Confirm the snippet src now reads https://go.acme.com/dl.js.
  4. Deploy the new snippet.

​
Route Shopify through the domain

The card shows a Route Shopify block when Shopify is connected. Select it to re-point your Shopify Web Pixel at the new host. You don’t need a theme edit.

​
What the domain serves

Ingest on your own domain sets a first-party __dl_visitor_id cookie for 365 days, with SameSite=Lax, Secure, and HttpOnly. We suppress that cookie when the browser sends Sec-GPC: 1 or DNT: 1.

​
Remove a domain

Removing a domain breaks every tracking link on it, and every page still loading dl.js from it. We release the SSL certificate, so re-adding the domain means creating the DNS records again.
  1. Select remove on the domain card.
  2. Type the hostname to confirm.
  3. Select remove domain.
We delete the Cloudflare hostname, clear the edge routing entry, point Shopify back at the default ingest host, and delete the row.

​
When it doesn’t work

​
Next