Skip to content

Domains

Learn how to work with domains in your project, including adding custom domains.

By default, all deployments are assigned a .vercel.app suffixed domain.

This domain can be replaced with a Custom Domain of your choice, and purchased through Vercel, or a third-party.

For information on migrating an existing domain to Vercel, see our Zero-Downtime Migration for DNS guide.

To view your all registered domains, go to the Domains tab in your Vercel dashboard.

The domains list will show you all domains that are currently active on your account, and are split into the following columns:

  • Domain - The domain name
  • Registrar - The domain registrar (Vercel or Third Party)
  • Nameservers - The nameservers for the domain (Vercel or Third Party)
  • Expiration date - The expiration date of the domain
  • Creator - The person who created the domain, indicated by their avatar
  • Age - The age of the domain, from when it was added to now

You can search for a specific domain by using the search bar above the domains list. The ability to search domains is available on all plans.

The domain list with search bar

Note: It is not possible to search a multi-level wildcard subdomain, it is only possible to search a subdomain at one level down.

You can move domains to another profile or team using the Domains tab from the Vercel Dashboard.

Selecting the Domains tab from the Vercel Dashboard page.

Once on the Domains tab, select the domain(s) you wish to move by using the checkbox next to each domain then click Move.

Selecting which domains to move from the Domains tab.

After selecting the domain(s) and clicking Move, you will be asked to confirm which profile or team you wish to move them to.

Entering a new profile or team destination for a domain.

When selecting the input field, you will be provided with a list of teams you belong to. If the profile or team you wish to move the domain(s) to is not present, enter the slug value instead. You can find the slug value in Settings page for both profiles and teams.

Note: When moving domains to another team or profile, all assigned domains will remain with the projects they are currently associated to.

To confirm the change, select Move. The domains will be transferred to the new profile of team immediately.

For domains that are registered with Vercel, you can retrieve an authorization code for transferring out to another registrar from the Domains tab of the

dashboard.

Selecting the Domains tab from the Vercel Dashboard page.

Once on the Domains tab, click on the triple-dot menu trigger button for the relevant domain, a menu-item button to transfer the domain out will be presented if the domain is registered with Vercel.

Menu item button for getting domain's transfer authorization code.

Note: If under a Team scope, only Team Owners will see the menu-item button.

After clicking the menu-item button, a modal will open up with the authorization code required to transfer the domain. Transferring a domain can take up to a week.

Menu item button for getting domain's transfer authorization code.

Every commit pushed to the Production Branch of your connected Git repository will be assigned the domains configured in your project.

In order to automatically assign a domain to a different branch, you can enter it in the Git Branch field of your Domain:

A Custom Domain that is automatically assigned to the staging Git Branch.

When you connect a domain to a Project, Vercel checks if this domain is already associated with a Personal Account or Team. A domain can only be associated with one Personal Account or Team at a time.

The following table shows potential errors that can be encountered when adding a domain to your project:

Error Text
Description
This team has already registered this domain
The domain you are trying to add is already connected to the team you have selected.
You have already registered this domain
The domain you are trying to add is already connected to the Personal Account you have selected.
The domain mydomain.com is not available
This more generic error message states that the domain is owned by another Vercel account that you do not have access to. If you have ownership of the domain in question, contact Vercel support.

Domain ownership errors