Restoring Salesforce Metadata to a File System

You can restore the Salesforce metadata to a folder that resides on one of your servers. 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.

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.

Before You Begin

You must have a subclient that includes metadata. For more information, see Backing Up Salesforce Metadata.


  1. From the navigation pane, go to Protect > Applications > Cloud apps > Salesforce.
  2. The Apps page appears.
  3. 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.
  4. 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.

  5. Select Metadata restore.

    The Backup content page appears.

  6. Optional: Select a backup. From the Showing latest backup list, select the backup:
    • To show the latest 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.
  7. Optional: 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.
  8. Click the Metadata, unpackaged and then select the check box next to 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.

  9. Click Restore.

    The Restore options dialog box appears.

  10. In the Restore target area, select File system.
  11. From the Destination server list, select the server where you want to restore the data to.
  12. Click Submit.

What to Do Next

You can control or view the job. For more information, see Jobs.

Last modified: 12/22/2020 4:19:06 AM