Data Loader Guide

Data Loader
When to Use Data Loader
Install Data Loader
Configure Data Loader
Using Data Loader
Data Types Supported by Data Loader
Export Data from Salesforce
Define Data Loader Field Mappings
Insert, Update, or Delete Data Using Data Loader
Upload Attachments
Upload Files and Links with Data Loader
Review Data Loader Output Files
Data Import Dates
View the Data Loader Log File
Configure the Data Loader Log File
Run in Batch Mode (Windows Only)
Command-Line Quick Start (Windows Only)
Data Loader Third-Party Licenses
PDF

Configure the Data Loader Log File

You can customize the Data Loader log file for advanced troubleshooting and tracking.
Available in: both Salesforce Classic (not available in all orgs) and Lightning Experience
Available in: Enterprise, Performance, Unlimited, and Developer editions

log-conf.xml

The log-conf.xml file is included with the Data Loader installer version 35.0 and later. To change the location of the log-conf.xml file, specify the full path, incuding the full file name, in the LOG4J_CONFIGURATION_FILE environment variable.

  • In Windows, the log-conf.xml file is at C:\Users\{userName}\dataloader\version\configs
  • In macOS, the log-conf.xml file is at /Users/{userName}/dataloader/version/configs

Configure Log Levels

Change @LOG_LEVEL@ to TRACE, DEBUG, INFO, WARN, ERROR, or FATAL for the needed level of log tracking. For Log4J log levels, see https://logging.apache.org/log4j/2.0/manual/architecture.html.

To implement enhanced logging, use a copy of log-conf.xml.