Skip to content
← Back to Changelog

Tuesday, December 19th 2023

Stage and manually promote deployments to production

Posted by

Avatar for seanmassa-vercelcom

Sean Massa

Software Engineer

Avatar for sambecker

Sam Becker

Director of Product Design

Avatar for mcocirio

Mariano Cocirio

Product Manager

Avatar for chrisbarber

Chris Barber

Software Engineer

Avatar for trekglowacki-vercelcom

Trek Glowacki

Software Engineer

You can now control when domains are assigned to deployments, enabling the manual promotion of production deployments to serve traffic.

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

You can now create staged deployments that do not assign domains, which can later be promoted to production and serve traffic. This is helpful for custom workflows and having multiple production environments for QA or testing.

From the dashboard

  • Disable the assignment of domains for your production branch in your Git project settings.
  • Find your deployment from the list of all deployments and use the right menu to select Promote to Production.

From the CLI

  • vercel --prod --skip-domain
  • vercel promote [deployment-id or url]

Learn more in our documentation.