> For the complete documentation index, see [llms.txt](https://copilot-docs.bugbase.ai/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://copilot-docs.bugbase.ai/enterprise/settings/domain-verification.md).

# Domain Verification

Verify root-domain ownership before web recording and assessment.

Use **Settings -> Domain Verification** to prove ownership of root domains before web assessment, browser-session recording, or Manual Crawler when verification is required.

The Web Run Assessment **Asset** step shows each domain's verification state. Select **Verify ownership** on a row to open this page.

## Verification Flow

1. Open **Settings -> Domain Verification**.
2. Select the root domain that needs verification.
3. Publish the DNS TXT record shown in the challenge.
4. Click **Verify Now**.
5. Wait for the status to change to **Verified**.

If the DNS challenge expires or needs to be regenerated, use **Refresh Challenge** and publish the new TXT value before trying again.

## Statuses

| Status         | Meaning                                                                                      |
| -------------- | -------------------------------------------------------------------------------------------- |
| **Verified**   | The domain passed ownership verification and can be used for gated web assessment workflows. |
| **Pending**    | A challenge exists, but the TXT record has not been confirmed yet.                           |
| **Unverified** | No valid ownership proof has been completed for the root domain.                             |

## When Verification Blocks Work

Verification may be required before:

* recording browser sessions;
* using Manual Crawler;
* starting a web Discovery, Assessment, or Discovery + Assessment intent;
* vetting a domain with **AI configure**.

If a flow is blocked, open **Settings -> Domain Verification**, verify the root domain, then return to the scan or browser-session flow.

On a shared trial, **Run Assessment** shows a banner until the root domain is set up: **Add your root domain** with an **Add domain** button when no root domain is added yet, or **Verify your root domain** with a **Verify domain** button when it is added but not verified. Both buttons open this page. See [Shared-Trial Banner](https://copilot-docs.bugbase.ai/enterprise/run-assessment-wizard.md#shared-trial-banner).

### AI Configure on a Shared Trial

On a shared trial, AI configure runs only on a domain whose root is verified, unless BugBase has waived verification for your workspace. Until then, the **AI configure** card on the **Intent** step is unavailable and reads **Verify ownership of {root domain} to use AI configure.** If vetting is refused at start, the wizard shows **Domain is not verified** with a **Verify domain** button that opens this page.

Verifying the root, such as `example.com`, covers its subdomains. Dedicated deployments do not ask for verification before AI configure.

### Enforcement

Enterprise managers can disable verification enforcement for some deployments. Shared trial environments usually require DNS TXT verification unless BugBase support grants an exception. Manual Crawler is additionally available only in Debug Mode.
