Data Loader Guide

About Data Loader
When to Use Data Loader
Install Data Loader
Download and Install Data Loader
Considerations for Installing Data Loader
Uninstall Data Loader
Configure Data Loader
Using Data Loader
Running in Batch Mode (Windows Only)
Command-Line Quick Start (Windows Only)
Data Loader Third-Party Licenses
PDF

Newer Version Available

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

Download and Install Data Loader

Data Loader is available for MacOS and Windows operating systems. Download to install and configure the app on your local machine.
Available in: both Salesforce Classic (not available in all orgs) and Lightning Experience
Available in: Enterprise, Performance, Unlimited, and Developer editions

User Permissions Needed
To use Data Loader: API Enabled

AND

The appropriate user permission for the operation you’re doing, for example, Create on accounts to insert new accounts

AND

Bulk API Hard Delete (only if you configure Data Loader to use Bulk API to hard-delete records)

Data Loader is updated in every Salesforce Release. The major version number corresponds to the currently available API version.

  1. Install Java Runtime Environment (JRE) version 17 or later for your operating system, for example, Zulu OpenJDK version 17 or later for macOS and for Windows. Alternatively, install your preferred Java Runtime Environment (JRE) from a commercial vendor such as Oracle or IBM.
  2. Download the most recent version of Data Loader at https://developer.salesforce.com/tools/data-loader.
  3. Optionally, verify that the downloaded Data Loader zip file is signed by Salesforce. On macOS or Windows, run the command jarsigner -verify dataloader_v<version>.zip. Replace <version> with the version string in the download's filename. For example,
  4. After the download completes, open the .zip file and select Extract All.
  5. In the Data Loader folder, find and open the installation file. On macOS, look for the installer.command file. On Windows, look for the install.bat file. On macOS, ignore any error regarding unidentified developer message. Press the Control key while clicking the installer.command file, and select open from the menu.
  6. Specify a directory for the Data Loader installation. Overwrite the contents if a Data Loader directory already exists.
  7. Answer the prompts and decide your preferences to complete the installation.

To open Data Loader, use the Data Loader desktop icon, or find it from the Start menu (Windows) or in your Applications folder (macOS). You can also run dataloader.app (macOS) or dataloader.bat (Windows) from the installation folder.

If you have Data Loader version 44 or earlier installed and want to upgrade to the current version while retaining your current settings, move config.properties from /configs subdirectory of previous version of your Data Loader installation to the /configs subdirectory of your current version.