Migration Tool maintains the various components that form an application as metadata. It is often necessary to move metadata from one system to another, such as when you are:

  • copying components from one organization to another
  • transferring metadata from a local development system to your organization
  • pushing changes from sandbox to production orgs

The Migration Tool is a Java/Ant-based command-line utility, based on the Metadata API, for moving metadata between a local system directory and a organization. The Migration Tool is especially useful in the following scenarios:

  • Development projects—Populate a test environment with large amounts of setup changes, quickly.
  • Multistage release processes—A typical development process requires iterative building, testing, and staging before releasing to a production environment. Scripted retrieval and deployment of components can make this process much more efficient.
  • Repetitive deployment using the same parameters—You can retrieve all the metadata in your organization, make changes, and deploy a subset of components. If you need to repeat this process, it's as simple as calling the same deployment target again.
  • When migrating from stage to production is done by IT—If you prefer deployment via a scripting environment.

Recommended Migration Tool Learning Path

To begin learning about the Migration Tool, follow this path.

  1. Metadata API Quick Start
  2. Using the Migration Tool (Login Required)
  3. Community-Provided Video (embedded above)

Related Migration Tool Resources