Ant Migration Tool Guide

Clouds with binary code floating aboveCloud with binary code floating above

No Results

Search Tips:

  • Please consider misspellings
  • Try different search keywords
Ant Migration Tool
Installing the Ant Migration Tool
Using the Ant Migration Tool
Entering Salesforce Connection Information
Constructing a Project Manifest
Creating Retrieve Targets
Retrieving Metadata from a Salesforce Organization
Editing Metadata
Deleting Files from an Organization
Deploying Changes to a Salesforce Org
Checking the Status of a Task
Common Migration Issues
PDF

Using the Ant Migration Tool

The Ant Migration Tool is retired with Spring ’24. The tool continues to function for future API versions but isn’t updated with new functionality and isn’t supported. To manage metadata changes, switch to Salesforce CLI for a modern, supported developer experience.

Note

The Ant Migration Tool is a Java/Ant-based command-line utility for moving metadata between a local directory and a Salesforce organization. You can use the Ant Migration Tool to retrieve components, create scripted deployment, and repeat deployment patterns.

The general procedure you will follow when using the Ant Migration Tool to copy metadata from one Salesforce organization to another is:

  1. Enter credentials and connection information for source Salesforce organization in build.properties
  2. Create retrieve targets in build.xml
  3. Construct a project manifest in package.xml
  4. Run the Ant Migration Tool to retrieve metadata files from Salesforce
  5. Enter credentials and connection information for destination Salesforce organization in build.properties
  6. Run the Ant Migration Tool to deploy metadata files or deletions to Salesforce