Newer Version Available

This content describes an older version of this product. View Latest

Retrieving Metadata from a Salesforce Organization

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

To retrieve Lightning Platform components:

  1. Open a command prompt.
  2. Run Ant by specifying a target name in build.xml. If it’s the first time you’re running Ant, use ant retrieveUnpackaged to retrieve unpackaged components specified in package.xml.
  • The sample build.xml contains some useful targets for various retrieve() and deploy() options that you can modify or use as is. To see a list of all your named targets in build.xml, enter ant -p at the command line.
  • You can deploy or retrieve up to 10,000 files at once. AppExchange packages use different limits: They can contain up to 35,000 files. The maximum size of the deployed or retrieved .zip file is 39 MB. If the files are uncompressed in an unzipped folder, the size limit is 600 MB. If you’re working with many components, use the listMetadata target to identify the subset of files that you want to retrieve. You can also retrieve batches of components as described in Retrieving Components in Bulk.

Note