Roll back or promote a production deployment

Change which deployment serves production from the dashboard. You can roll back without rebuilding, promote a staged production build, or promote a preview (which starts a new production build).

Prerequisites

You need an Owner or Admin role in the workspace. Members can view deployments but cannot promote or roll back.

If the project is paused or the workspace is suspended, Instant Rollback and production promote are blocked.

Instant Rollback

Instant Rollback points your production hostname and live custom domains at an older READY production deployment than the one that is currently Current. It does not rebuild. Environment variables and build output stay as they were when that deployment was built.

Eligible deployments are READY production deployments created before Current (by deployment age). Preview-only deployments are not eligible.

1. Open the project overview, or open a prior production deployment from Deployments.
2. Choose Instant Rollback and confirm.
3. Production traffic switches to that deployment.

After Instant Rollback, Easel turns off Auto-assign production domains. New pushes to your production branch still build, but they stay Staged and do not replace the rolled-back deployment until you undo the rollback.

Promote a staged production deployment

When auto-assign is off, production builds finish as Staged: status READY, not Current, and newer than the live deployment. See Environments.

Promote also applies when you restore production to a chronologically newer former Current after a rollback (forward restore).

1. Open the staged (or newer) production deployment.
2. Open the deployment actions menu and choose Promote.
3. Confirm. Production domains move to this deployment with no rebuild.

If the project was rolled back, promoting a production deployment also turns auto-assign back on.

Promote a preview to production

Promoting a preview creates a new production deployment from the same source commit. The build uses production environment variables, not preview values.

1. Open a READY preview deployment.
2. Open the deployment actions menu and choose Promote to Production.
3. Confirm. Easel queues a production rebuild.
4. Open the new deployment on the Deployments list and wait until it is READY.

When the rebuild is READY, production domains update if auto-assign is on. If auto-assign is off, the new build is Staged until you promote it.

Undo a rollback

After Instant Rollback, restore normal auto-assign so new production deploys go live again. Pick one path:

• On the project overview, choose Undo Rollback
• In Project settings → Environments, turn Auto-assign production domains on

You can also promote a staged or other newer READY production deployment. That re-enables auto-assign when the disable reason was a rollback.

Related guides

• Environments: auto-assign, Staged, and Current
• Environment variables: production vs preview scopes
• Pause a project: pause blocks production promote and Instant Rollback