Skip to content

Salesforce Data Loader vs. Data Import Wizard

  • Salesforce
  • Automation
Cover illustration for the Mastering Salesforce Data guide

What is the Salesforce Data Import Wizard for?

The Data Import Wizard ships in every Salesforce org and is the natural first choice for Contact and Account data. It also covers several standard objects — Leads, Solutions, Campaign Members — and any custom object in your configuration.

It's built for initial persona data: Contacts, Accounts, and Leads. Along the way it de-duplicates, links Contacts to Campaigns, and can trigger automations as records come in.

Key features of the Data Import Wizard

  • Guided interface. A web-based flow walks you through the import step by step.
  • Standard and custom object support. Import into Accounts, Contacts, Leads, and any custom object in your org.
  • Field mapping. Matches your import file's columns to the right Salesforce fields.
  • Validation and error checking. Flags failed records with a detailed log so you can fix and retry.
  • Duplicate management. Checks new records against existing ones and can block a match from importing.
  • Batch processing. Splits large files into batches so the import doesn't overwhelm the system.
  • A hard ceiling. Built for up to 50,000 records at a time — past that, Salesforce points you to the Data Loader.

Where the Import Wizard fits

  • Trade show leads. Map name, email, and company from a spreadsheet straight into the Lead object.
  • Bulk contact updates. Match existing contacts by email or ID and update fields across the batch.
  • Migrating from another CRM. Export the old system to CSV, then map its fields onto Salesforce's.
  • Populating a custom object. Load project details, warranty records, or any object built for your business.

How to use the Data Import Wizard

  1. Prepare your data. Export to a supported format (CSV) matching the structure of the object you're importing into.
  2. Open the wizard. In Salesforce, go to Setup and find Data Import Wizard.
  3. Choose the object you're importing into — Contacts, Accounts, Leads, or a custom object.
  1. Upload the file containing your data.
  2. Map the fields — line up each CSV column with the matching Salesforce field.
  1. Review and start. Check the mappings and settings, then run the import. You can watch progress and see a summary once it finishes.

Limits of the Data Import Wizard

  • Record volume. Recommended for small to medium data sets; larger loads need the Data Loader or a third-party tool.
  • Limited object support. Objects outside its supported list need a different method.
  • Basic field mapping. Not built for complex import scenarios that need advanced mapping logic.
  • No scheduling. It's a manual tool — no automated, recurring imports.
  • Error handling that's easy to trip on. Logs are provided, but diagnosing them takes some Salesforce familiarity.
  • No data reshaping. Whatever shape your data needs to be in has to happen before the import, not during it.
  • Counts against your API limit. Every import consumes calls from the same daily budget as everything else.
  • No tolerance for messy source data. The tool doesn't correct inconsistencies on the way in.
  • Missing advanced features. No deduplication logic beyond a basic match, no complex reformatting, and limited error handling compared with dedicated import tools.

What is the Salesforce Data Loader for?

The Data Loader is Salesforce's client-based tool for bulk data work — insert, update, upsert, delete, and export, all through Salesforce's own APIs, which keeps the data integrity and access controls intact.

Where the Import Wizard is guided and capped at 50,000 records, the Data Loader is a heavier tool built for volume: up to 5 million records in a single run. It takes more technical familiarity to operate, and it earns that back on anything large or recurring.

Where the Data Loader fits

  • Large volumes. Anything past 50,000 records — up to 5 million in one batch.
  • Complex operations. Imports spanning multiple related objects, or needing advanced field mapping.
  • Scheduled automation. Scriptable via its command-line interface, which makes it a fit for nightly syncs from an external system.
  • Bulk deletion. The safer, more efficient choice when removing large quantities of records.
  • Migrations. Moving data in from another CRM or a large external database.
  • Backups and exports. Pulling a large dataset out of Salesforce for archival.

How to use the Data Loader

  1. Install it. Download from the Salesforce Setup menu. Java needs to be installed on the machine running it.
  2. Log in with your Salesforce credentials — a sandbox or a security-token requirement may apply depending on your org's settings.
  3. Choose the operation — Insert, Update, Upsert, Delete, or Export — and the object you're working with. This walkthrough uses an Insert on Contacts.
  1. Prepare and upload the file. Build a correctly formatted CSV for insert, update, or upsert operations.
  2. Map the fields so each CSV column lands in the right Salesforce field.
  1. Run and monitor the operation, watching for errors as it processes.
  2. Review the results — the success and error files it generates tell you exactly which records didn't go through.

Practical tips for the Data Loader

  • Back up first, especially before a delete or update run.
  • Test on a small batch before running the full file.
  • Clean the CSV — no duplicate or incomplete rows, matching Salesforce's format requirements.
  • Know your API limits. Data Loader operations count against them.
  • Read the error files. Understand why a record failed before you retry it.
  • Get the record IDs right for any update or delete.
  • Use the CLI to automate recurring jobs instead of running them by hand each time.

Limits of the Data Loader

  • More complex to use than the Import Wizard, especially without database or command-line experience.
  • No cloud access. It's a desktop application that has to be installed locally.
  • Counts against your API limit, same as the Import Wizard.
  • No built-in duplicate checking — unlike the Import Wizard, it won't catch a duplicate before inserting it.
  • Local installation required, which can run into IT policy restrictions.
  • No correction for bad source data. Garbage in, garbage out, same as any import tool.
  • Error resolution takes more Salesforce knowledge to work through than the Import Wizard's logs do.

Between the two, most Salesforce orgs need both: the Import Wizard for the everyday, smaller-scale work, and the Data Loader for the bulk migrations and recurring syncs that outgrow it.

Next, we turn to a different kind of data quality control: validation and verification — the rules that check data as it's entered, rather than after the fact.

Hungry for more?

Frequently asked questions

What is the Salesforce Data Import Wizard used for?

It's a guided, web-based tool for importing Contact, Account, Lead, and custom object data, built for smaller jobs up to 50,000 records at a time. It also handles field mapping, basic duplicate checking, and validation during import.

How many records can the Salesforce Data Import Wizard handle?

Up to 50,000 records in a single operation. Larger imports need the Data Loader or a third-party tool.

How many records can Salesforce Data Loader handle?

Up to 5 million records in a single batch, which makes it the standard choice for large migrations, bulk updates, and recurring data syncs.

Does the Data Loader check for duplicates automatically?

No. Unlike the Data Import Wizard, the Data Loader has no built-in duplicate checking, so records need to be deduplicated before or after the load.

When should you use the Data Loader instead of the Import Wizard?

Once a job needs more than 50,000 records, touches multiple related objects, or has to run on a schedule via script — the Data Loader is built for volume and automation where the Import Wizard is built for guided, one-off imports.

Ready to take control?

With a product tour you can walk through the product yourself without installing anything, or book a demo for a guided look.