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

# Verify domain

> Confirm DNS records are live so your custom domain activates.

After you [add a domain](/custom-domains/add), Oviond reconciles its status against Vercel. Once the records resolve and SSL is provisioned, the domain becomes **Active** and shared links start rendering under it.

## Statuses

A domain moves through these states (`pending`, `verifying`, `active`, `failed`):

| Status      | Meaning                                                             |
| ----------- | ------------------------------------------------------------------- |
| `pending`   | Just added. The DNS records haven't been detected yet.              |
| `verifying` | Records are visible but SSL is still provisioning.                  |
| `active`    | Records and SSL are live — the domain is fully functional.          |
| `failed`    | Verification didn't complete. Records are missing or misconfigured. |

In the list, these collapse into a single badge: **Active** (green), **Verification failed** (red), or **Action required** (amber, for `pending` and `verifying`).

## Trigger a re-check

<Steps>
  <Step title="Open Custom domains">
    Go to **Settings → Custom domains** (`/settings/custom-domains`).
  </Step>

  <Step title="Show the DNS records">
    Click **Show DNS records** on the domain to expand the records to add.
  </Step>

  <Step title="Verify the domain">
    Click **Verify domain**. Oviond re-queries Vercel and updates the status. It also keeps the status in sync automatically via a webhook when Vercel confirms ownership or provisions the certificate.
  </Step>
</Steps>

If a domain stays in **Pending** for a while, double-check that the `CNAME` (and any `TXT` ownership record) match exactly what Oviond showed when you added the domain. DNS changes can take anywhere from a minute to several hours to propagate, depending on your provider.

## Set a default domain

The default custom domain is used to build shared report URLs when a client has no domain override of its own. Only an **Active** domain can be set as the default. Your first domain becomes the default automatically; on any other active domain, click **Set as default** (the star) from **Settings → Custom domains**.