Revert to an earlier version
Choose a point in your history to return local files to their state at that time.
When the selection includes Salesforce metadata, the revert applies to local files and the connected Salesforce org.
1. Check before reverting
If local files targeted by the revert have unsaved changes, save or discard those changes first.
- Save changes in Ready to Save.
- Save or discard changes in Unsaved Files.
Also review whether org-side changes can be overwritten. Use Check differences with Salesforce to compare content, then bring in and save any org changes you want to keep. Having org changes in the comparison list does not by itself block a revert.
2. Choose what to revert
In History, click the point you want to return to. The changed files and Revert to this version appear.
Click Revert to this version to open the confirmation screen.

Blaze compares the revert targets with the current org before showing the list.

- The top shows the number of targets, how many overwrite org changes, and how many will be deleted.
- Each row shows its action, such as Auto Restore, Delete, or Manual Action.
- When org content differs from the latest local save, available modification dates and names appear. Check whether that content can be overwritten.
- Uncheck rows you do not want to revert. Use the file search input to narrow a long list.
- Click Validate first to check whether the changes can be applied to the org. Errors are grouped by component, test, coverage, and other categories.
Affected rows also show notices for content that remains in the org, such as translations and some profile settings.
3. Review and restore
If the screen says that the org comparison failed and org-side changes have not been checked, the comparison is incomplete. Click Cancel, check your org connection and access permissions, then reopen the confirmation screen.
Click Restore after reviewing the selection. Blaze checks the selected metadata against the org again immediately before proceeding.
If the org has changed since you opened the screen, Blaze pauses and shows updated comparison results and a notice.

Clicking Restore again after this notice also overwrites the newly detected org changes. Review who changed the content and what changed. Adjust the selection or click Cancel to stop.
If you select only files that are not Salesforce metadata, Blaze restores those files locally. Nothing is applied to the Salesforce org, and org validation is unnecessary.
4. Review the result
- The result is recorded in history as an entry starting with
Restore to. - If a target cannot be reverted automatically, Blaze shows what to do in Salesforce Setup.
- Flows are created as a new inactive version. Review them in Setup, then activate them manually.
- Added child elements, such as fields and sharing rules, are removed from the org according to your selection.
- When deleting an added Bot, Blaze deactivates active Bots before deletion.
If the operation fails, review the error and recovery result. Blaze attempts to restore the previous state of items such as deactivated approval processes. If recovery cannot finish, the screen indicates that manual review is required.
5. FAQ
Q. What if my previous revert was interrupted?
Select the target version again and review the current org comparison before retrying. If changes from the interrupted revert remain in Ready to Save, Blaze asks you to discard those changes before trying again. Part of the org may already have been reverted, so review the guidance and current state. If another revert is running, wait for it to finish.
Q. Is anything left out of the org comparison?
Yes. Profiles are not compared with the org, and their rows show Not compared with the org. Targets whose org state already matches the destination are not listed; they are included in the unchanged count.
Q. What happens to metadata excluded by .forceignore?
Salesforce metadata excluded by .forceignore is not applied to the org. The confirmation lists the affected files.
Q. Can I undo a revert?
Yes. The revert is recorded in history. Choose the point from before the revert and click Revert to this version again.