Validating a Restore of Salesforce Metadata to Salesforce


Before you restore Salesforce metadata to the Salesforce cloud, you can validate the restore. When the validation runs, a validation job is created. If errors occur during the validation job, the job is marked as pending. If the validation job is successful, the job is marked as complete.

Before You Begin

  • Verify that the Salesforce user who performs the validation has a System Administrator profile or an equivalent profile.

  • Configure backups to include metadata.¬†For more information, see Backing Up Salesforce Metadata.


  1. From the navigation pane, go to Protect > Salesforce.

    The Salesforce page appears.

  2. For the organization that contains the data that you want to restore, click the action button , and then click Restore.

    The Select restore type page appears.

  3. Select Metadata restore.

    The Backup content page appears.

    Here you can download up to 1GB of metadata and use tools like Workbench to deploy. Select one or more metadata components, and then click Download.

  4. Optional: To select a backup, from the Showing latest backup list, select the backup:

    • To show the most recent backup, select Show Latest Backup.

    • To show a backup at a specific time, select Show backup as a of a specific date, and then type the date and time.

    • To show backups for a date range, select Show backup for a date range, and then specify the dates.

  5. Click the Metadata and unpackaged check boxes, and then select the check box for each metadata object that you want to restore.

    Note: For each metadata file that you want to restore, check if the metadata file (-meta.xml) exists, and then select it. For example, suppose that you have AccountBeforeUpdate.cls file that is accompanied by the AccountBeforeUpdate.cls-meta.xml file and you want to restore metadata. In this case, you will need to select both files in the restore operation.

  6. Click Restore.

    The Restore options dialog box appears.

  7. Next to Restore target, select Salesforce.

    1. Under Destination details, from the Destination organization list, select the Salesforce destination.

  8. Click Validate only.

What to Do Next

  • Monitor the restore job. If the job is not successful, go to the job details page to review the errors.

  • In Salesforce, check the metadata deploy status, results, and errors. If errors occur, go to the Deployment Details page to troubleshoot, or contact your Salesforce administrator or Salesforce support. For more information, go to Monitor Deployments on the Salesforce support website.

Restoring Salesforce Metadata to Salesforce