---
title: How do I resolve alias related errors on Vercel?
description: Information on resolving alias related errors on Vercel.
url: /kb/guide/how-to-resolve-alias-errors-on-vercel
canonical_url: "https://vercel.com/kb/guide/how-to-resolve-alias-errors-on-vercel"
published: 2025-11-03
last_updated: 2025-11-27
authors: Sam Ko
related:
  - /docs/cli
install_vercel_plugin: npx plugins add vercel/vercel-plugin
---
<!-- docsgraph:related -->
## Related pages

> **For AI agents:** Follow these links to understand how this page connects to the rest of the Vercel ecosystem. For the full cross-link map (inbound, outbound, prerequisites, and semantic neighbors), see the .graph.md link below.

- [vercel alias](https://vercel.com/docs/cli/alias?from=related) — Learn how to apply custom domain aliases to your Vercel deployments using the vercel alias CLI command.
- [Delete an Alias](https://vercel.com/docs/rest-api/aliases/delete-an-alias?from=related)
- [Assign an Alias](https://vercel.com/docs/rest-api/aliases/assign-an-alias?from=related)
- [Get an Alias](https://vercel.com/docs/rest-api/aliases/get-an-alias?from=related)
- [List aliases](https://vercel.com/docs/rest-api/aliases/list-aliases?from=related)
- [How to move a domain between Vercel projects with "Zero Downtime"?](https://vercel.com/kb/guide/how-to-move-a-domain-between-vercel-projects-with-zero-downtime?from=related) — Information about how to move your domain between Vercel projects without downtime.
- [How do I remove a domain from my Vercel account?](https://vercel.com/kb/guide/how-do-i-remove-a-domain-from-my-vercel-account?from=related) — Learn how to completely remove a domain from your Vercel account?
- [How do I add a custom domain to my Vercel project?](https://vercel.com/kb/guide/how-do-i-add-a-custom-domain-to-my-vercel-project?from=related) — Learn how to add a custom domain to your Vercel project.
- [How can I move a domain to a Vercel team?](https://vercel.com/kb/guide/how-can-i-move-a-domain-to-a-team?from=related) — Information on how to move domains between accounts on Vercel.
- [How do I resolve "err_too_many_redirects" when using a Cloudflare proxy with Vercel?](https://vercel.com/kb/guide/resolve-err-too-many-redirects-when-using-cloudflare-proxy-with-vercel?from=related) — Information about how to resolve the "err_too_many_redirects" error when using a Cloudflare proxy with Vercel.

Full cross-link map for this page: [/kb/guide/how-to-resolve-alias-errors-on-vercel.graph.md](/kb/guide/how-to-resolve-alias-errors-on-vercel.graph.md)
<!-- /docsgraph:related -->


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.

## Steps to Resolve

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](https://vercel.com/docs/cli#getting-started) command:

```bash
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](https://vercel.com/docs/cli#commands/switch) by using this command:

```bash
vercel switch
```

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

```bash
vercel alias remove <alias>
```

## Deleted Accounts

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.