> ## Documentation Index
> Fetch the complete documentation index at: https://confidence-auth-testing.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Verify a domain

> Prove ownership of your organization's domain by adding a DNS TXT record.

export const HowToSchema = ({name, description, steps = []}) => {
  const schema = {
    "@context": "https://schema.org",
    "@type": "HowTo",
    name,
    description
  };
  if (steps.length > 0) {
    schema.step = steps.map((s, i) => ({
      "@type": "HowToStep",
      position: i + 1,
      name: typeof s === "string" ? s : s.name,
      text: typeof s === "string" ? s : s.text || s.name
    }));
  }
  return <script type="application/ld+json" dangerouslySetInnerHTML={{
    __html: JSON.stringify(schema)
  }} />;
};

export const NotForSpotify = () => <Note>
    <strong>This page doesn't apply at Spotify.</strong> Use the Spotify
    documentation in the sidebar.
  </Note>;

{user?.groups?.includes("spotify") && <NotForSpotify />}

<HowToSchema
  name="Verify a Domain"
  description="Prove ownership of your organization's domain by adding a DNS TXT record."
  steps={[
{
  name: "Go to Domains",
  text: "Go to Confidence. On the bottom of the left sidebar, select Admin > Domains.",
},
{
  name: "Add a domain",
  text: "Click Add domain and enter your organization's domain (for example, acme.com).",
},
{
  name: "Copy the DNS record",
  text: "A dialog shows the TXT record you need to add. Copy the Host and Value fields.",
},
{
  name: "Add the TXT record to your DNS",
  text: "Log in to your DNS provider and add a TXT record with the host and value from the previous step. The record goes on the domain itself, which most DNS providers call '@' or let you leave empty.",
},
{
  name: "Verify the domain",
  text: "Back in Confidence, click Verify. Confidence checks your DNS for the record and marks the domain as verified.",
},
]}
/>

Verifying a [domain](/docs/iam/domains) proves that your organization owns it. Once verified, Confidence associates the domain with your workspace.

<Note>
  To manage domains, you need the **Admin** role.
</Note>

## Add a domain

<Steps>
  <Step title="Go to Domains">
    Go to Confidence. On the bottom of the left sidebar, select **Admin > Domains**.
  </Step>

  <Step title="Add a domain">
    Click **Add domain** and enter your organization's domain (for example, `acme.com`). Confidence suggests domains based on the email addresses already associated with your workspace.

    Free email domains like `gmail.com` or `outlook.com` cannot be registered.
  </Step>
</Steps>

## Verify Ownership With a DNS TXT Record

After adding a domain, you need to verify that your organization owns it by adding a TXT record to your DNS configuration.

<Steps>
  <Step title="Open the DNS record dialog">
    Click **Verify** on the domain row. A dialog shows the TXT record you need to add:

    * **Host:** Your domain (for example, `acme.com`)
    * **Value:** A verification string in the format `confidence-domain-verification=<token>`

    Use the copy buttons to copy each value.
  </Step>

  <Step title="Add the TXT record to your DNS">
    Log in to your DNS provider (for example, Cloudflare, GoDaddy, or Route 53) and add a new **TXT** record with the host and value from the previous step.

    <Tip>
      The record goes on the domain itself. Most DNS providers call this host **@** or let you leave the host field empty.
    </Tip>

    DNS changes can take anywhere from a few minutes to 48 hours to propagate, depending on your provider.
  </Step>

  <Step title="Verify the domain">
    Back in Confidence, click **Verify**. Confidence checks your DNS for the TXT record and marks the domain as verified.

    If verification fails, double-check that the TXT record is published correctly. You can use a tool like [Google Admin Toolbox Dig](https://toolbox.googleapps.com/apps/dig/) to confirm that the record is visible in public DNS.
  </Step>
</Steps>

## Remove a domain

To remove a domain, open the actions on the domain row and select **Remove**. Removing a verified domain also removes the ownership association with your workspace.

## Related Resources

<CardGroup cols={2}>
  <Card title="Domains reference" href="/docs/iam/domains">
    Understand what verified domains are and how they work
  </Card>

  <Card title="Users reference" href="/docs/iam/users">
    Manage user access to your workspace
  </Card>

  <Card title="IAM introduction" href="/docs/iam/introduction">
    Overview of identity and access management
  </Card>
</CardGroup>