Restoring Salesforce Metadata to Salesforce


You can restore Salesforce metadata to the Salesforce cloud. Data is restored from media. When data is restored from media, the data is restored to a staging location, and then the data is upload to Salesforce. You can also validate the metadata restore operation before you perform the actual restore operation.

Metadata supported by the Salesforce API is supported for restore operations.


  • You cannot restore managed package components to Salesforce.

  • To restore metadata, you must select individual components, instead of selecting the entire metadata.

Before You Begin


  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 Submit restore.

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.