# Linking your domain

To get started, head into the **Dev Space** tab within your dashboard, and select **Domains**. You'll need to activate the Custom Domains addon if you haven't already.

<div align="left"><figure><img src="https://2927352434-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FyAmEVMxhOOdXgxn7sjnz%2Fuploads%2FZn0DeTNHGYZ1AkvoHVQb%2FScreenshot%202024-06-15%20at%203.10.24%E2%80%AFpm.png?alt=media&#x26;token=95e40681-0fc8-4cc7-b1af-a0bf79c93996" alt=""><figcaption></figcaption></figure></div>

Once you have entered your domain or subdomain, you will need to enter the displayed records within your domain's DNS settings. This tells the internet to point your domain to our content delivery network. Sometimes, you may be required to verify you own the domain name by adding additional records.

<div align="left"><figure><img src="https://2927352434-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FyAmEVMxhOOdXgxn7sjnz%2Fuploads%2FG9JJeLu6K4XgIeNY7ilJ%2FScreenshot%202024-06-15%20at%203.12.41%E2%80%AFpm.png?alt=media&#x26;token=07a2d451-6f82-4345-982e-ce39c29e0aae" alt=""><figcaption></figcaption></figure></div>

Let's say we wanted to link **onboard.personr.co**, your DNS record should look something like the below.

<figure><img src="https://2927352434-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FyAmEVMxhOOdXgxn7sjnz%2Fuploads%2FcwwwN5wZ2o8cAROAKpxn%2FScreenshot%202024-06-15%20at%203.17.31%E2%80%AFpm.png?alt=media&#x26;token=56b5d2f6-7435-455f-8acf-e6e7a2b9021b" alt=""><figcaption></figcaption></figure>

When adding your DNS records, make sure to use the IP address we've provided via the platform.&#x20;

{% hint style="info" %}
If you use CloudFlare or similar for DNS or domain management, make sure to turn off traffic proxying.
{% endhint %}

Once you've entered the required records in your domain's DNS settings, select **Check Records**. Depending on your provider, propagation may take a few hours. Similarly, it may take a few hours for our system to generate an SSL certificate - though this usually only takes a few minutes.

That's it. Once linked, you can use your newly-linked domain to...

* Access the dashboard;
* Provide branded verification links to clients; and
* Create static verification [Pages](https://manual.personr.co/api-documentation/pages/overview) with your domain.

{% hint style="info" %}
If you generate verification links via API, you can replace **enterprise.personr.co** with your linked domain.
{% endhint %}