Manual Deploys and Rollbacks

Manual deploys allow you to choose exactly what build to publish to production and when. Rollbacks allow you to quickly revert your production site to a previous build at the click of a button.

Prerequisites

Manual deploys and Rollbacks are only available for Performance Hosting plans and higher.

Manual Deploys

In order to deploy manually, you have to disable Automatic Deploys, the default behavior for Gatsby Cloud sites.

Disable Automatic Deploys

You can disable Automatic Deploys by going to Site Settings > Builds and then unchecking the Enable automatic deploys box.

You can conveniently check whether Automatic Deploys are enabled from the Builds tab of the dashboard. The gear icon is a shortcut to the site settings above.

When Automatic Deploys are disabled, subsequent builds will not be published until you do so manually. 

Publish a Manual Deploy

On the Builds tab of the dashboard, click the View production history link to get a list of your Production Builds.

1.  The currently published build will have a Published badge next to the build time information.
2. Other builds that are eligible to be published will have a Publish button next to the view build link

Note: A build will not have a publish button in cases where the deploy failed. Click the build card title to see the build logs.

When you click the publish button for a build you will be asked to confirm.

By default, manual deployment will automatically turn off automatic deploys, so that future (potentially broken) builds don't deploy immediately to production.​ If you want to leave them enabled, uncheck the Disable automatic deploys checkbox in the confirmation dialog above. The checkbox does not appear if Automatic Deploys are already disabled.

Click Publish to deploy the build to production.