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.

If you need to modify or customize the metadata that you backed up, perform the following operations:

  1. Restore the metadata to a file system.
  2. Modify the corresponding xml files.
  3. Use the Force.com Migration Tool tool to deploy the metadata to the Salesforce organization. For more information, go to the Salesforce help website, Force.com Migration Tool.


  • 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

  • Verify that the Salesforce user who performs the restore operation 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 > Applications > Cloud apps > Salesforce.

    The Apps page appears.

  2. In the Restore column, click Restore.
    • If multiple instances are backed up, the Restore dialog box appears.
    • If one instance is backed up, the Select restore type page appears.
  3. If multiple instances are backed up, expand the instances, select the data that you want to restore, and then click Select Content.

    The Select restore type page appears.

  4. Select Metadata restore.

    The Backup content page appears.

  5. 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.
  6. Optional: To select the metadata that you want to use for the restore, from the Showing restorable metadata only list, select one of the following options:
    • To view all metadata, click Show all metadata.
    • To view only the metadata that you can restore, select Show restorable metadata only.
  7. 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.

  8. Click Restore.

    The Restore options dialog box appears.

  9. In the Restore target area, select Salesforce.
  10. In the Destination details area, provide the destination information.
    1. From the Destination server list, select the server that hosts the Salesforce destination instance.
    2. From the Destination instance list, select the Salesforce instance.
  11. Click Submit restore.

Last modified: 3/24/2021 6:37:01 AM