Promote sandbox updates

Use a sandbox to safely make changes to your production tenant:

1. Create a sandbox before making configuration changes to your tenant.

2. Access the sandbox, and then make configuration changes to your tenant. Run the updated workflow from within the sandbox, run sandbox validations, and verify that your changes are ready for promotion.

3. Promote configuration changes (this topic) to your production tenant.

   Tip

   You can automatically delete a sandbox using the Promote and delete sandbox option when promoting changes from a sandbox to production.

This is part three of a series of topics that describes how your brand can use sandboxes to safely make changes to your production tenant.

Note

Users who have been assigned the DataGrid Operator or DataGrid Administrator policy, and then assigned the Allow sandbox administration policy option, are allowed to create sandboxes and promote changes to production from a sandbox.

The following sections describe the steps you’ll follow when promoting changes in a sandbox to production.

	Open the sandbox from which you want to promote configuration state changes.
	A series of validations are run against updates. These validations will notify you within the sandbox when the configuration states of production and sandbox conflict. Most of the time you should receive a validation report that does not contain a list of conflicts, similar to: Occasionally, you will receive a validation report that shows one (or more) validation errors. For example, a schema mismatch between a custom domain table in production and a custom domain table in the sandbox: If you receive a validation report with errors, investigate each error and work to resolve the underlying issue. It is possible that resolution must be done in the production tenant before pulling updates to the sandbox. It is also possible that the resolution is done in the sandbox. It depends on the error.
	When configuration state changes in a sandbox are ready for promotion to production, the sandbox-specific notifications will provide a link named “Ready to promote”.
	Review the list of Added, Changed, and/or Removed configuration state changes. Click the name of the added, changed, or removed object to review the details for the configuration state change. Resolve validation issues, as necessary.
	Enter a merge message for this set of configuration state changes. When the sandbox is ready to be promoted, click Promote. Tip You can automatically delete a sandbox using the Promote and delete sandbox option when promoting changes from a sandbox to production.
	After the updates are safely running in production, you should delete the sandbox.