> ## Documentation Index
> Fetch the complete documentation index at: https://docs.qwairy.co/llms.txt
> Use this file to discover all available pages before exploring further.

# DNS Setup

> Add your custom domain in White Label settings and point it to Qwairy with a CNAME record at your DNS provider.

Setting up a custom domain takes two parts: adding the subdomain in Qwairy, then creating a CNAME record at your DNS provider.

## Add Your Domain in Qwairy

<Steps>
  <Step title="Open White Label settings">
    Go to **Team Management > White Label** in your Qwairy dashboard.
  </Step>

  <Step title="Add your custom domain">
    In the custom domain section, enter the subdomain you want to use (e.g. `analytics.yourcompany.com`) and save.
  </Step>

  <Step title="Copy the CNAME target">
    Qwairy displays the **CNAME target** to point your subdomain to. Keep this value handy for the next step.
  </Step>
</Steps>

<Warning>
  Use a subdomain (e.g. `analytics.yourcompany.com`). Apex (root) domains are not supported.
</Warning>

## Create the CNAME Record

In your DNS provider (Cloudflare, Route 53, GoDaddy, etc.), add a new **CNAME** record:

```
Type: CNAME
Name: analytics            (your subdomain)
Value: <the value shown in your White Label settings>
```

* **Name** — the subdomain you added in Qwairy (for `analytics.yourcompany.com`, the name is usually `analytics`)
* **Value** — the CNAME target shown in your White Label settings

<Note>
  DNS providers label these fields differently. **Name** may appear as Host or Record, and **Value** may appear as Target, Points to, or Content. Use the exact target shown in your White Label settings.
</Note>

<Info>
  DNS propagation can take some time — usually minutes, but it can take up to 48 hours depending on your provider.
</Info>

## Next Step

Once the record is in place, head to [Verification](/agencies/custom-domain/verification) to confirm your configuration and activate the domain.