> ## 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.

# Custom Domain Overview

> Serve the Qwairy dashboard and login from your own subdomain, fully branded — e.g. analytics.yourcompany.com.

A custom domain lets you serve the Qwairy dashboard and login from your own subdomain instead of the default Qwairy URL. Your team and clients sign in and work entirely under your brand.

## What a Custom Domain Gives You

* **A branded dashboard** — access Qwairy from a subdomain you control, such as `analytics.yourcompany.com`
* **A branded login** — your team signs in on your domain, with your [logo](/agencies/logo) on the sign-in page
* **A consistent experience** — paired with your logo and [removed branding](/agencies/remove-branding), the product looks and feels like your own

<Note>
  The custom domain brands the **sign-in page**, but magic-link emails and the Google consent screen stay Qwairy-branded by default. For fully white-labeled authentication on your domain, connect your own identity provider with [SSO](/documentation/team/sso) — your IdP handles login, and with SSO + JIT provisioning, matching users are added to your workspace automatically on first sign-in.
</Note>

## Prerequisites

<Steps>
  <Step title="You control the DNS for a subdomain">
    You'll need access to your DNS provider to add a record for the subdomain you want to use (e.g. `analytics.yourcompany.com`).
  </Step>

  <Step title="Use a subdomain, not a root domain">
    Apex (root) domains such as `yourcompany.com` are not supported. Choose a subdomain like `analytics.yourcompany.com` or `ai.yourcompany.com`.
  </Step>
</Steps>

<Warning>
  Root (apex) domains are not supported. Always use a subdomain.
</Warning>

## How Setup Works

<CardGroup cols={2}>
  <Card title="1. DNS Setup" icon="network-wired" href="/agencies/custom-domain/dns-setup">
    Add your domain in White Label settings and create the CNAME record at your DNS provider.
  </Card>

  <Card title="2. Verification" icon="circle-check" href="/agencies/custom-domain/verification">
    Verify your DNS, and the Qwairy team finalizes activation so your team can sign in at your domain.
  </Card>
</CardGroup>