Skip to content

How do I point a subdomain at Convultra?

The step-by-step for setting up a first-party tracking subdomain such as track.yourdomain.com with a single CNAME record.

article |3 min |Updated Sep 2026
On this page · 5 sections

You point a subdomain at Convultra by adding it under Settings → Tracking → Custom tracking domains and creating one CNAME record at your DNS provider. Convultra provisions the SSL certificate. Once the domain is active, the tracking script and every event request come from track.yourdomain.com instead of a Convultra host, which keeps tracking first-party and off the blocklists that ad blockers use.

Do I need this?

No. The default hosts, cdn.convultra.com for the script and tracking.convultra.com for events, work without any setup. A custom subdomain is worth doing when:

  • a noticeable share of your visitors use ad blockers or strict browsers
  • your security policy requires every request on your pages to be first-party
  • you want the tracking domain to be one you control

What you need

  • Access to your domain’s DNS records
  • A subdomain you are not using for anything else, such as track.yourdomain.com or analytics.yourdomain.com
  • Five minutes

The steps

  1. Add the domain in Convultra. Open Settings → Tracking → Custom tracking domains, enter track.yourdomain.com and click Add Domain. The domain appears in the list with the status Add CNAME record and shows the record you need.

  2. Add the CNAME record at your DNS provider:

    TypeNameValue
    CNAMEtrack.yourdomain.comtracking.convultra.com

    Some providers want only the subdomain part (track) in the name field. Use whichever form your provider expects.

  3. Wait for it to go Active. The page checks every 15 seconds. When it sees the record the status changes to Provisioning SSL, and 1 to 2 minutes later to Active. If you would rather not wait for the next check, click Check Now.

  4. Swap the script URL on your site. The Active domain’s panel shows the complete snippet; the only change from the default is the src:

<script async src="https://track.yourdomain.com/v1/ultra.js" data-convultra-key="YOUR_API_KEY"></script>

The SDK notices it was loaded from your domain and sends all events there.

How to confirm it works

  • Open https://track.yourdomain.com/v1/ultra.js in a browser. You should see the script.
  • Visit your site, then check Overview for new visitors.
  • Back in Settings, the Active domain shows when it last received an event.
  • If you use the API or MCP server, get_tracking_health lists the custom tracking domains that are live.

Common mistakes

  • Pointing the record somewhere else. The value must be exactly tracking.convultra.com, not cdn.convultra.com, not an IP address, and not your own site.
  • Using an A record. It has to be a CNAME.
  • Using the bare domain. Use a subdomain. yourdomain.com itself is serving your website.
  • Forgetting to change the snippet. Adding the domain does nothing until pages load the script from it.
  • A proxy in front of the hostname. If another service answers for track.yourdomain.com, Convultra cannot provision the certificate and the domain shows Error. Point the record straight at Convultra.

If a domain sits in Error and the message is not clear, email support@convultra.com with the subdomain and we will check it from our side. For the background and the full status table, see Custom tracking domains.

Next in Installation Custom tracking domains →