Custom Tracking Domain Set Up For Private Instance

Follow the steps below to set up a custom tracking domain (CTD) for private instances. For more information about how it works see custom tracking domain (CTD) article.

If your API tracking domain is not your subdomain or you have multiple websites on different domains you will need to set additional custom tracking domains for each of your tracked website domains. Follow the steps below.

In case you have a private instance and your API tracking domain is already a subdomain of your website it might automatically act as a custom tracking domain. Find out what kind of DNS records you are using and see if you need any changes. Learn about differences in DNS records.


Custom tracking domain setting in project settings is not available on private instances and domains will thus be configured by our IT.

1. Prepare a list of subdomains

Define a list of tracking subdomains of your websites to be used as tracking domains e.g. The selected subdomain should be dedicated entirely for this use, nothing existing should run there, not even on sub-sub domains e.g "".


Setting DNS records on an incorrect domain that is used for other purposes can have serious consequences.

2. Request subdomain configuration

Provide the list of domains and the type of DNS records you wish to use: NS zone (recommended) or CNAME to your CSM. Our developers will configure the domains on the Exponea side and provide you with instructions to set the DNS records.

3. Set the DNS record

Our IT will provide the NS DNS records to be configured for your domains. There are commonly 4 NS records that need to be set.

Your Subdomain

Record Type

Destination Domain




CNAME records
In case you decide to use CNAME records, our IT will provide the destination domain to which clients need to set the CNAME records. Once the client knows the destination domain, they will need to set a DNS CNAME record for the new subdomain.


CNAME records does not work to ensure persistent cookies and anonymous identity.

CNAME example:

Your Subdomain

Record Type

Destination Domain




4. Try to test load SDK

Make sure you followed steps 2. and 3.and your new tracking domain is configured. Try to test load our SDK from your new domain (you can do this via any browser)

5. Update and test the tracking snippet.

There are up to three places where the snippet needs to be updated, based on the version of the web integration snippet you are using. You can update the snippet directly using the instructions below or look into the Web Integration tab where, once the CTD is set up, you can find the updated snippet. In case you have multiple custom domains in one project, follow the steps below.


When updating the snippet be careful to keep all your existing configuration of the initialization unchanged.

  • 1. Tracking API target
    Add/Update the "target" parameter to your initialization config and set it to your custom domain e.g. "target":
<script type="text/javascript">
        "target": "//",
        "token": "<project_token>",
  • 2. JS SDK link (needed for older snippets)
    Look for the link to exponea.min.js in the initialization snippet and replace the JS SDK domain to your custom tracking domain.
    Change from // to //

If you just see"/js/exponea.min.js" you have a newest version of the snippet and this step is not needed.

  • 3. Non-flickering experiments API path (needed for older snippets)
    In case you are using the older implementation of non-flickering experiments update the “path” parameter in their initialization config and set it to your custom domain
    e.g. webxpClient.path =
    webxpClient.path = '';
    webxpClient.sign = '<PROJECT-TOKEN>' + '/' + 

6. Make sure that everything is working

Visit your website and make sure everything is working (events are being tracked, weblayers are displayed…).


Cookies expiry

You might also review the cookies and check the expiry when switching to your new domain, before doing so please make sure to read how CTD works and which cookies are used.

Updated about a month ago

Custom Tracking Domain Set Up For Private Instance

Suggested Edits are limited on API Reference Pages

You can only suggest edits to Markdown body content, but not to the API spec.

We rely on cookies

to optimize our communication and to enhance your customer experience. By clicking on the Accept and Close button, you agree to the collection of cookies. You can also adjust your preferences by clicking on Manage Preferences. For more information please see our Privacy policy.

Manage cookies
Accept & close

Cookies preferences

Accept & close