When adding a domain to a project, you may encounter one of two errors related to to the
- "The chosen alias
<xyz>.vercel.appis already in use."
- "To move the domain, remove existing aliases associated with
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
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:
If you were able to find the alias through this step, you can remove it with the following command:
vercel alias remove <alias>
If you have recently deleted a Vercel Hobby or Pro team account, then please be aware that a certain amount of time must pass before the domain is once again available for us, this is dependent on the type of account deleted:
- Hobby (4 days)
- Team (4 days)
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.