Skip to content
Docs

Claiming Domain Ownership

If a domain is registered with another Vercel account and you need to take ownership of it, Vercel will automatically prompt you to verify DNS ownership when you try to add the domain. This allows you to claim the domain and transfer it to your team.

When you add an existing domain via the Connect External button on your team's Domains page, Vercel automatically checks if you already registered the domain with another Vercel account. If so, you'll be prompted to verify ownership before you can use it.

Use this flow when:

  • You registered a domain with another Vercel account that you no longer have access to
  • You need to transfer domain ownership between Vercel teams without access to the source team
  • You've lost access to the original Vercel account but control the domain's DNS

If you have access to both Vercel accounts, consider using the Move feature instead, which is simpler and doesn't require DNS verification.

You must control the root domain's DNS to add the verification TXT record. If someone else controls it, ask that owner to add the record.

If you bought the domain through Vercel, it uses Vercel's nameservers, and you can't access the owning account, you can't add the TXT record needed to claim it. Use Account Recovery to regain access first.

Claiming a domain for a team and verifying its use on a project are separate checks. After you claim the domain at the team level, adding records or unused subdomains to your projects doesn't require repeated ownership verification.

If the domain or subdomain is already associated with another project, Vercel requires project-level verification when you add it, including when it is serving traffic. Follow the verification prompt for that specific hostname; claiming the root domain doesn't bypass this check.

  • You must have permission to add domains on the target team
  • You must have access to modify DNS records for the domain
  1. Go to the Domains section in your team dashboard sidebar and click Connect External.

  2. In the modal, enter the domain you want to add (for example, example.com) and click Continue.

    Vercel will check the domain's ownership status. If you registered the domain with another Vercel account, you'll be shown the claim verification step.

  3. You'll be shown a TXT record that you need to add to your domain's DNS configuration. The record will look similar to:

    TypeNameValue
    TXT_vercel.example.comvc-domain-verify=...

    Add this record with your DNS provider.

    DNS changes can take a few minutes to propagate. If verification fails initially, wait a few minutes and try again.

  4. Once you've added the TXT record, click Verify & Claim to complete the ownership transfer. Vercel will check for the TXT record and, if found, transfer the domain to your team.

    After successful verification, you'll land on the domain's configuration page where you can manage DNS records and assign it to projects.

If you receive a "TXT record not found" error, ensure that:

  1. You've added the TXT record to the correct domain (check the verification domain shown in the modal)
  2. The TXT record value matches exactly what was provided
  3. Enough time has passed for DNS propagation (typically a few minutes, but can take up to 48 hours in some cases)

You can verify your TXT record has propagated using a DNS lookup tool or by running the following in your terminal:

terminal
dig TXT _vercel.example.com
Last updated September 18, 2026

Was this helpful?

supported.