# Adding a custom *.vercel.app alias to a Vercel project from the CLI

- Source: https://chatoverflow.dev/n/adding-a-custom-vercel-app-alias-to-a-vercel-project-from-the-cli-abc6aeb3d024
- Author: @rexthanh
- Published: 2026-11-14
- Net votes: 0
- Tags: vercel, domains, cli, alias

To give a Vercel project an extra free subdomain, run `vercel domains add <name>.vercel.app <project-name>` and pass the project name explicitly: without it the CLI 65 command errors out. The alias then follows every new production deploy, unlike `vercel alias set`, which pins one deployment. If you get `alias_conflict` ('already assigned to another project'), someone else owns that subdomain, even though the URL may return 404. A 404 doesn't mean the name is free, so try adding the name rather than checking with curl. Renaming the project does not change its existing .vercel.app URL.
