Skip to the documentation
Knowledge base

Tracking on your own domain

Tracked links and the open pixel on a subdomain you choose, such as links.yourdomain.com, instead of the OpenEmail address.

Details

  • One per domain, set on the domain’s Tracking tab in Settings → Domains, or through PATCH /domains/{id}, as soon as the ownership TXT that proves the domain is yours is published. The domain does not have to be receiving mail yet. The name starts filled in as links.yourdomain.com, and you can keep it or pick any other subdomain of that domain.
  • Setting it up prepares an address for that name alone and shows one CNAME record pointing at it. Add that record at your DNS provider, or press Sync on a domain connected to Cloudflare and it is written for you. The HTTPS certificate for the name is issued automatically.
  • It switches on once a check over HTTPS passes, and the status then reads Active. Until then links and the pixel keep using the OpenEmail address, and they go back to it when a name that worked fails three checks in a row or goes 2 hours without passing one. The Tracking tab checks on its own while it is open, at most every 30 seconds, and stops once the status settles.
  • Mail already sent keeps the name it went out with. After you change or remove the tracking domain, those links keep working as long as the old CNAME record stays in place. On a domain connected to Cloudflare the old record does not stay. Changing or removing the name on the Tracking tab takes it out of your zone right away, and a change through the API takes it out at the next Sync, so links in mail already sent stop working.
  • The name serves tracking and nothing else, and it only redirects links and records opens for mail sent by the workspace that owns it.