---
schema_version: "1"
id: b2402e9a637dd72c362130a6fcc487d7b0956ecb8ab66585f1c7d5b72cbbeb45
title: Back Up Metadata to Protect and Restore Your Customizations
collection: admin
version: current
locale: en-us
portal_url: https://docs.salesforce.com/admin/current/en-us/xcloud/264-0-0/admin_backup_metdata.md
canonical_url: https://help.salesforce.com/s/articleView?id=xcloud.admin_backup_metdata.htm&release=264.0.0&type=5
source_site: help.salesforce.com
content_type: documentation
content_hash: 1fab1d5cbe23bc79ed0e77f510357ae32e809968b67e67b1e03720f1d8a52952
description: Protect your org’s customizations, such as custom fields, custom Apex code, page layouts, reports, and permission sets, by backing up your metadata.
products:
  - Salesforce Platform
  - Cross Cloud
release: "264"
---
# Back Up Metadata to Protect and Restore Your Customizations

Protect your org’s customizations, such as custom fields, custom Apex code, page layouts, reports, and permission sets, by backing up your metadata.

### Required Editions

<table class="slds-table slds-table_bordered slds-max-medium-table_stacked slds-m-bottom_small edition"><colgroup><col></colgroup><tbody><tr class=""><td class="slds-cell-wrap" style="vertical-align:top;">Available in: <strong>Developer</strong>, <strong>Enterprise</strong>, <strong>Performance</strong>, <strong>Professional</strong>, and <strong>Unlimited</strong> editions.</td></tr></tbody></table>

<table class="slds-table slds-table_bordered slds-max-medium-table_stacked slds-m-bottom_small permission">
        <colgroup>
          <col style="width:50%">
          <col style="width:50%">
        </colgroup>
        <thead class="slds-text-title_caps ">
          <tr class="">
            <th scope="colgroup" class="slds-cell-wrap" colspan="2" style="text-align:center;vertical-align:top;" id="d98440e69">User Permissions
              Needed</th>
          </tr>
        </thead>
        <tbody>
          <tr class="">
            <td data-label="User Permissions Needed" class="slds-cell-wrap" style="vertical-align:top;" headers="d98440e69 ">To create unmanaged packages:</td>

            <td class="slds-cell-wrap" style="vertical-align:top;" headers="d98440e69 ">Create AppExchange Packages and Manage Users</td>

          </tr>
        </tbody>
      </table>

Backing up your metadata gives you a snapshot of that metadata at a particular point in time. At a future time, you can compare the backed-up metadata with more recent metadata. You might do this to revert your metadata to a previous state or to identify what changes have been made for purposes such as debugging.

To back up your metadata, create an unmanaged package.

1. In Setup, enter Package Manager in the Quick Find box, and then select **Package Manager**.
2. Select **New**, name the package, and select **Save**.
3. In the Components tab, select **Add**.
4. In the Component Type dropdown list, select the types of metadata you want to include in your backup, and click **Add To Package** for each metadata type.
5. To finish creating this unmanaged package, click **Upload**.

You receive an email when your package has been uploaded to the Package Manager page.

![Note](https://sf-zdocs-cdn-prod.zoominsoftware.com/tdta-xcloud-setup-264-0-0-production-enus/6f21df35-9ea0-4f53-ac94-45c3b5dfd5bc/images/icon_note.png)

Note Unmanaged packages don't support all metadata types. See [Components Available in Unmanaged Packages](https://developer.salesforce.com/docs/atlas.en-us.pkg1_dev.meta/pkg1_dev/packaging_unmanaged_components.htm).

For more advanced metadata backup options, API and CLI commands are available. See [Deploying and Retrieving Metadata](https://developer.salesforce.com/docs/atlas.en-us.api_meta.meta/api_meta/file_based.htm) in the Metadata API Developer Guide and [mdapi Commands](https://developer.salesforce.com/docs/atlas.en-us.sfdx_cli_reference.meta/sfdx_cli_reference/cli_reference_force_mdapi.htm) in the Salesforce CLI Command Reference. To review the metadata types that can be packaged using more advanced developer tools, see the [Metadata Coverage Report](https://developer.salesforce.com/docs/metadata-coverage).

#### See Also

- [Trailhead: _Package Development Readiness_](https://trailhead.salesforce.com/en/content/learn/modules/package-development-readiness)
- [Trailhead: _Package Development Model_](https://trailhead.salesforce.com/en/content/learn/modules/sfdx_dev_model)

## Create a New Version of Your Unmanaged Package

It's likely that your org's metadata is changing daily, and that new metadata types are added. To protect these changes, periodically create a new version of your unmanaged package.

1. In Setup, enter Package Manager in the Quick Find Box, and then select **Package Manager**.
2. Click the Package Name for the unmanaged package you created.
3. In the Components tab, select **Add**.
4. In the Component Type dropdown list, select any new types of metadata you want to add to your backup, and click **Add To Package** for each metadata type.
    
    ![Note](https://sf-zdocs-cdn-prod.zoominsoftware.com/tdta-xcloud-setup-264-0-0-production-enus/6f21df35-9ea0-4f53-ac94-45c3b5dfd5bc/images/icon_note.png)
    
    Note Changes to components that were added in a previous package version are captured automatically when you create a new version.
5. Click **Upload**, and in the Package Detail screen complete the Version Name field. Consider adding details in the Description field so you know when this version was created, and click **Upload**.

Each time you create a new package version, you've created a new snapshot of your metadata.

## Restore Your Metadata From an Unmanaged Package

We recommend restoring metadata in a sandbox org. Then use your standard method for deployment from a sandbox to your production org.

1. In Setup, enter Package Manager in the Quick Find Box, and then select **Package Manager**.
2. Click the Package Name for the unmanaged package you created.
3. From the Package Detail page, click the Versions tab, and select the package version number.
4. Copy the installation URL from the Package Version Detail page.
5. Use the installation URL to install your unmanaged package in a sandbox org.
6. Work with a developer to retrieve and redeploy the metadata to restore using either the [Metadata API](https://developer.salesforce.com/docs/atlas.en-us.api_meta.meta/api_meta/file_based.htm) or the [Salesforce CLI](https://developer.salesforce.com/docs/atlas.en-us.sfdx_cli_reference.meta/sfdx_cli_reference/cli_reference_force_mdapi.htm).

![Note](https://sf-zdocs-cdn-prod.zoominsoftware.com/tdta-xcloud-setup-264-0-0-production-enus/6f21df35-9ea0-4f53-ac94-45c3b5dfd5bc/images/icon_note.png)

Note Third-party release management apps that automate data and metadata backup are available on AppExchange.