Data Loader Guide

Data Loader
When to Use Data Loader
Install Data Loader
Configure Data Loader
Using Data Loader
Run in Batch Mode (Windows Only)
Installed Directories and Files
Encrypt from the Command Line
Upgrade Your Batch Mode Interface
Run Batch File With Windows Command-Line Interface
Configure Batch Processes
Data Loader Process Configuration Parameters
Data Loader Command-Line Operations and Exit Codes
Configure Database Access
Map Columns
Run Individual Batch Processes
Command-Line Quick Start (Windows Only)
Data Loader Third-Party Licenses
PDF

Note: This release is in preview. Features described here don’t become generally available until the latest general availability date that Salesforce announces for this release. Before then, and where features are noted as beta, pilot, or developer preview, we can’t guarantee general availability within any particular time frame or at all. Make your purchase decisions only on the basis of generally available products and features.

Installed Directories and Files

In version 8.0 and later, installing the Data Loader adds several directories under the installation directory that are needed for automated batch processing.
Available in: both Salesforce Classic (not available in all orgs) and Lightning Experience
Available in: Enterprise, Performance, Unlimited, and Developer editions

The Data Loader command-line interface is supported for Windows only.

Note

  • bin—Contains the batch files encrypt.bat for encrypting passwords and process.bat for running batch processes.

    For information on running Data Loader from the command-line, see Run Batch File With Windows Command-Line Interface.

  • configs—The default configuration directory. Contains the configuration files config.properties, Loader.class, and log-conf.xml.

    The config.properties file that is generated when you modify the Settings dialog in the graphical user interface is in C:\Users\{userName}\dataloader\version\configs.

    Data Loader runs the operation, file, or map listed in the configuration file that you specify. If you don’t specify a configuration directory, the current directory is used.

  • samples—Contains subdirectories of sample files for reference.

File Path Convention

The file paths provided in these topics start one level below the installation directory. For example, \configs means C:\Users\{userName}\dataloader\version\configs, provided you accepted the default installation directory. If you installed the program in a different location, use that directory path.