5 min read

Transferring Domains to Another Team or Project

Domains can be transferred to another team or project within Vercel, or to and from a third-party registrar. Learn how to transfer domains with this guide.
Table of Contents
  1. You can move domains to another profile or team using the Domains tab of your Account Settings page (account-scoped domains) or your team's dashboard.

  2. Once on the Domains tab, select the context menu next to the domain you wish to move, and click Move. You can also use checkbox next to each domain to select more than one domain

    Selecting which domains to move from the Domains tab.
    Selecting which domains to move from the Domains tab.
  3. 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.
    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.

    When moving domains to another team or user, all existing project domains associated with them will remain and not be moved to prevent service disruption. However, any custom aliases that are not part of project domains will be removed immediately.

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

You can use the Dashboard to remove a domain from a project and then re-add it to another. However, this could potentially end up with some site down-time. For more information on transferring domains with zero downtime, see How to move a domain between Vercel projects with "Zero Downtime"?

  1. Due to ICANN rules, a domain must be registered with a registrar for 60 days before it can be transferred to another.

    You can verify that your domain has been registered with Vercel for at least 60 days by visiting the Domains Dashboard. If the registrar is Vercel and the age greater than 60 days, it is eligible to transfer.

  2. Select the Domains tab

    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.

  3. Once on the Domains tab, click on the triple-dot menu 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.
    Menu item button for getting domain's transfer authorization code.

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

  4. After clicking the menu-item button, a modal will open up with the authorization code required to transfer the domain. Use this authorization code with your new registrar to confirm that you want to transfer the domain. There is no additional confirmation that you need to do on the Vercel side. Transferring a domain can take up to a week.

    Modal for domain's transfer authorization code.
    Modal for domain's transfer authorization code.

By transferring your domain into Vercel, you allow Vercel to manage the DNS records for the domain and can use it with any Projects listed under the account the domain is owned by.

  1. Due to ICANN rules, a domain must be registered with a registrar for 60 days before it can be transferred to another. You will need to confirm this with your registrar before attempting the transfer to Vercel.

    If the domain has not been registered with the current registrar for at least 60 days, the domain transfer will fail.

    NOTE: To find further information on ICANN rules, visit the ICANN website.

  2. Once you have verified your domain's eligibility to transfer, proceed with unlocking your domain in your registrar's domain settings. Most domains are usually locked by default to prevent unauthorized changes.

    The domain lock feature appears in different forms across registrars. Sign into the host where your domain is registered and look for a Domain Lock or similar option to unlock your domain. If this option is not available, contact your registrar to change this.

  3. After unlocking the domain, you will need to obtain an authorization code. The code will be sent to the email address associated with your domain by your registrar. In some cases, your authorization code pops up on your dashboard. This may be available in the domain registrars dashboard. If it is not available, contact your registrar to obtain this.

  4. When transferring a domain, you will have two options to choose from. Either using the Vercel Dashboard or Vercel CLI.

    Option 1: Using Vercel Dashboard

    After obtaining the authorization code, click on the Transfer in button in the Vercel Domains Dashboard and enter in your domain and respective authorization code.

    Option 2: Using Vercel CLI

    With Vercel CLI, you can run the following command from your terminal.

    vercel domains transfer-in [your-domain]

    You will be requested to provide an authorization code from your registrar after running this command. Once you get the authorization code from your registrar, paste it into the prompt and the transfer will begin.

    In a case where your domain cannot be transferred, check that it has been over 60 days since the domain has been registered or previously transferred. If it still does not work, contact your registrar.

  5. After activating a domain transfer-in, you will be informed that the DNS settings for your domain will not be transferred along with the domain. Instead, you will need to download a zone file from your registrar and upload it to Vercel.

    You can import the zone file to Vercel DNS by running the following command:

    vercel dns import [your-domain] [zonefile]

    If you do not apply a custom zone file, transferring in a domain automatically applies the default Vercel DNS settings.

  6. You can deploy your app with Vercel once the domain has been successfully added to your account.

    By setting a production domain from your projects' Domains dashboard, you will be able to use the following command with Vercel CLI:

    vercel --prod

    This command will deploy your project and make it accessible at the production domain that you have setup.

Last updated on June 20, 2024