> For the complete documentation index, see [llms.txt](https://learn.capstorm.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://learn.capstorm.com/copystorm-restore/common-tasks/restoring-salesforce-metadata.md).

# Restoring Salesforce Metadata

The following video demonstrates how to restore metadata to Salesforce with CopyStorm/Restore:

{% embed url="<https://www.youtube.com/watch?v=p9va97bRYBQ>" %}

## Metadata Restore Overview

Restoring metadata using CopyStorm/Restore is a simple point-and-click process — this can be used to:

* Promote code, permissions, or other metadata changes from Sandbox environments to Production.
* Roll-back metadata to previous versions if metadata has been incorrectly updated in Production.

All versions that have been backed up with CopyStorm are available to restore, providing an easy way to undo changes to metadata or migrate metadata between environments. CopyStorm/Restore can upload or roll back changes to dozens of metadata types, including:

* Apex Classes, Pages, and Triggers.
* Permission Sets, Profiles, Roles, and Groups.
* Custom Objects, Page Layouts, and Translations.

To restore metadata to Salesforce with CopyStorm/Restore:

## Go to CopyStorm/Restore's Metadata Tab

CopyStorm/Restore’s [Metadata Tab](/copystorm-restore/reference/meta-data-tab.md) provides an easy way to surgically upload new or modified metadata from the CopyStorm backup database into Salesforce.

## Select the Metadata to Restore

Selected metadata will be uploaded to Salesforce – select part of a metadata item, or upload the full item to Salesforce.

The Version selector allows historical versions of the metadata item to be uploaded, updating Salesforce with the version of the metadata as of the selected date and time. Uploading a historical version is a simple way to revert changes and undo metadata modifications that are causing problems in production or sandbox Salesforce instances.

## Deploy Selected Metadata to Salesforce

Deploying the selected metadata is as easy as pressing the [Deploy button](/copystorm-restore/reference/meta-data-tab/deploy-action.md), CopyStorm/Restore will handle the rest! After pressing the [Deploy button](/copystorm-restore/reference/meta-data-tab/deploy-action.md) and confirming the upload, CopyStorm/Restore will:

1. Create a zip file containing the selected metadata items (and versions).
2. Upload the zip file to Salesforce’s Metadata deployment API.
3. Display the results of the upload.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://learn.capstorm.com/copystorm-restore/common-tasks/restoring-salesforce-metadata.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.