How do I resolve alias related errors on Vercel?

Information on resolving alias related errors on Vercel.
Last updated on March 6, 2024
API & CLI

When adding a domain to a project, you may encounter one of two errors related to to the alias property:

  • "The chosen alias <xyz>.vercel.app is already in use."
  • "To move the domain, remove existing aliases associated with <domain>."

In both cases, you will need to remove the alias(es) in question in order to continue. This article covers the steps you can take to resolve these alias related errors.

The alias may be in use within a Vercel Project's deployments. Check with any Vercel projects' deployments that may include this alias. If you find the alias, you will need to delete the deployment.

If you did not find the alias in any of your deployments, check to see if this alias is currently in use by using this Vercel CLI command:

vercel alias list
Using the vercel alias list command to check all active aliases under a Vercel account.

Make sure to check within all your Vercel accounts, both Hobby and teams, for this alias. You can switch the account scope by using this command:

vercel switch
Using the vercel switch command to change account scope.

If you were able to find the alias through this step, you can remove it with the following command:

vercel alias remove <alias>
Using the vercel alias remove <alias> command to remove an alias.

If you have recently deleted a Vercel Hobby or Pro team account, then please be aware that the domain is instantly available for use again.

If you were not able to resolve your alias related error or if you wish to expedite the pruning process of your recently deleted Vercel account, please contact Vercel Support using the support form available from the Vercel dashboard.

Couldn't find the guide you need?