Skip to content

Custom Domains

INFO

Custom domains are a Pirsch Plus feature.

The dashboard and scripts can be served from your own domain. Combined with themes allowing you to fully white label Pirsch.

Configuring up a Custom Domain

Custom domains can be configured on the General settings page of your dashboard. You will need an unused domain to serve the dashboard and scripts. This can be a subdomain like dashboard.custom-domain.com or any other unused top level/subdomain you have.

Custom Domain Settings

After entering your domain, click Save and copy the DNS records that appear below. Create four new records for your domain.

  • Two A records with your domain and the IPv4 addresses (one for each)
  • Two AAAA records with your domain and the IPv6 addresses (one for each)

If you are using a subdomain, be sure to specify it as the host. Otherwise, use @ for the root domain (or leave it blank). The exact way you need to configure DNS depends on your domain provider. Here is a zone file for my.custom-domain.com.

$ORIGIN custom-domain.com.
$TTL 3600
my IN A 49.12.191.129
   IN A 159.69.94.230
   IN AAAA 2a01:4f8:c012:cb50::1
   IN AAAA 2a01:4f8:1c1b:cb09::1
$ORIGIN custom-domain.com.
$TTL 3600
my IN A 49.12.191.129
   IN A 159.69.94.230
   IN AAAA 2a01:4f8:c012:cb50::1
   IN AAAA 2a01:4f8:1c1b:cb09::1

And here is one for the top level domain custom-domain.com:

$ORIGIN custom-domain.com.
$TTL 3600
@ IN A 49.12.191.129
  IN A 159.69.94.230
  IN AAAA 2a01:4f8:c012:cb50::1
  IN AAAA 2a01:4f8:1c1b:cb09::1
$ORIGIN custom-domain.com.
$TTL 3600
@ IN A 49.12.191.129
  IN A 159.69.94.230
  IN AAAA 2a01:4f8:c012:cb50::1
  IN AAAA 2a01:4f8:1c1b:cb09::1

After you add the records, make sure they are propagated. You can do this by entering your domain or subdomain into a tool such as DNS Checker.

SSL

We automatically request an SSL certificate for your domain the first time you visit. So the first time you open the dashboard on your own domain, it may take a while for it to load. Once the certificate is obtained, we'll automatically update it as needed.

Serving Scripts on Your Own Domain

If you have configured a custom domain, the script snippets on the Integration settings page will use your domain.

Custom Domain Snippets

The names of the files are truncated to avoid being blocked by ad blockers.

  • pirsch.js is shortened to p.js
  • pirsch-events.js is shortened to e.js
  • pirsch-sessions.js is shortened to s.js
  • pirsch-extended.js is shortened to ext.js

You don't need to update your existing integration, both the regular scripts and the ones on your own domain will work. However, we recommend using your own to get around ad blockers.