Menu
Important
Stay updated on React2Shell

vercel alias

Last updated November 25, 2025

The command allows you to apply custom domains to your deployments.

When a new deployment is created (with our Git Integration, Vercel CLI, or the REST API), the platform will automatically apply any custom domains configured in the project settings.

Any custom domain that doesn't have a custom preview branch configured (there can only be one Production Branch and it's configured separately in the project settings) will be applied to production deployments created through any of the available sources.

Custom domains that do have a custom preview branch configured, however, only get applied when using the Git Integration.

If you're not using the Git Integration, is a great solution if you still need to apply custom domains based on Git branches, or other heuristics.

The command is not the recommended way to promote production deployments to specific domains. Instead, you can use the following commands:

  • : Use to skip custom domain assignment when deploying to production and creating a staged deployment
  • : Use to promote your staged deployment to your custom domains
  • : Use to alias an earlier production deployment to your custom domains

In general, the command allows for assigning custom domains to any deployment.

Make sure to not include the HTTP protocol (e.g. ) for the parameter.

Using the vercel alias command to assign a custom domain to a deployment.

Using the vercel alias command to remove a custom domain from a deployment.

Using the vercel alias command to list custom domains that were assigned to deployments.

These are options that only apply to the command.

The option can be used to bypass the confirmation prompt when removing an alias.

Using the vercel alias rm command with the --yes option.

The option can be used to specify the maximum number of aliases returned when using . The default value is and the maximum is .

Using the vercel alias ls command with the --limit option.

The following global options can be passed when using the vercel alias command:

For more information on global options and their usage, refer to the options section.


Was this helpful?

supported.