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 Professional Hosting plans and higher.

Manual Deploys

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 > Build features and then toggling Enable automatic deploys off.

You can conveniently check whether Automatic Deploys are enabled from the Builds tab of the dashboard, which will display the last published build before listing the site's build history.

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, under Build History, click the Publish button for the build that you would like to publish.

This will then open a popup asking for you to confirm that you want to publish that build.

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.