Import Overview
An intelligent way of importing records from Excel
Import

The Smart Import feature lets you bring data from Excel into Salesforce quickly, accurately, and with full control. It supports automatic field mapping, live preview, and multiple operation modes — making data import effortless and reliable.
Smart Import helps you upload, validate, and save records in Salesforce in just a few clicks. ✨
Key Highlights
Simplified import process with guided steps
Automatic and manual field mapping
Deduplication evaluation to manage duplicate records
Summary view before final import
Editable data preview
Insights dashboard for tracking import statistics
Note: Smart Import does not support Read-only fields, Related fields, Record type, Attachments, or Formula fields.
Accessing Smart Import
You can access Smart Import from the Import tab in the Wave Sidebar.

When you open the Import tab, you’ll see the main Smart Import dashboard with these sections:

File Upload
Drag and drop or browse to upload the Excel file for import.
Recent Imports
View previously completed imports and repeat an operation by clicking Import Again.
Recent Mapping
Access your saved mapping configurations. You can reuse one by clicking Use Mapping.
Insights
Displays key statistics like the total number of records imported, average records per file, and most frequently used Object.
Video Preview
A short video shows how Smart Import works in action. 🎥
Available Import Operations
Smart Import supports three key operations that define how your Excel data interacts with Salesforce:
Insert
Adds new records to Salesforce.
No Record ID required.
Update
Modifies existing records using Salesforce Record IDs.
Requires Salesforce Record IDs in Excel.
Upsert
Updates existing records or inserts new ones using an External ID.
Requires a Salesforce External ID field.
You can select one or more of these operations during the import process.
Import Process Overview
The import process includes four main stages: Import → Match → Deduplication Evaluation → Summary → (Optional Preview)
Step 1: Import Screen
Go to the Import tab in the Left Panel or open Smart Import from the Home screen.
Upload your Excel file by dragging and dropping or browsing from your computer.
Once the file is uploaded, click Continue.
The uploaded file appears in the Imported Files section.
To remove a file, click the Delete icon.
Select Object — Choose the Salesforce Object (Standard or Custom) you want to import records into.
Choose Operation — Choose one or more operations (Insert, Update, Upsert).
Refer to the table above for operation details before making your selection.
Review Recent Imports or Recent Mappings if you want to reuse a previous import configuration.
Click Next to continue to the Match screen.

Step 2: Match Screen (Field Mapping)
The Match screen displays how your Excel columns map to Salesforce Object fields.
Review the Mapped Fields automatically identified by Wave.
To unmap a field, click the Unmap icon.
For unmapped fields, click Map this field and manually select the Salesforce Object field.
For lookup fields, select the Lookup Via checkbox to map a related field using another Object’s value.
Example: If your Excel sheet includes a column Account Name and you’re importing into the Opportunity object, Wave will automatically map Account Name in Excel to Account Name in Opportunity.
Once mapping is complete, click Next to open the Deduplication Evaluation screen.

Step 3: Deduplication Evaluation
The Deduplication Evaluation screen identifies duplicate records in Salesforce through field comparison. This helps ensure your import doesn’t create duplicate records or unwanted overwrites.
Click Add Conditions to set your deduplication rules.
A new row appears showing:
Where — Logical condition AND
Mapped Field — Dropdown of Salesforce fields available for comparison
Matching Method — Currently supports Exact matching
Add multiple conditions if needed to define how duplicates should be detected.
Click the Apply Action button to decide how Smart Import handles duplicates.
From the dropdown, choose one of the following:
Ignore duplicate found
Overwrite when exactly one match found
Overwrite by oldest
Overwrite by newest
Click Submit to apply your deduplication preferences.
Click Next to proceed to the Summary screen.
Tip: Use deduplication conditions carefully — overly strict matching can cause valid records to be skipped, while broad matching may overwrite the wrong records.

Step 4: Summary Screen (Settings Overview)
The Summary screen provides a final review of your import configuration before you proceed.
This is where you’ll find your Settings section, previously available on the old Settings screen.
The Summary screen includes:
Mapping Name
Number of Records
Mapped Fields Summary
Selected Object
Operation Type
Batch Size
You can also set preferences such as:
✅ After successful import, Save as Wave Grid — Creates a Custom Grid of imported records in Wave.
Actions available:
Click Previous to go back and adjust settings if necessary.
Click Import to begin importing immediately.
Click Preview & Import to review your data first (recommended).

Step 5: Preview & Import
If you selected Preview & Import, you’ll see a preview of your data before final confirmation.
Review your data in the preview window.
Edit fields directly if needed.
For dropdown fields (e.g., Industry Type, Account Type), use the in-cell dropdown to modify values.
Once satisfied, click Import.
If errors appear (e.g., missing External IDs), Smart Import highlights them on-screen with guidance to correct the issue.
The imported records will be saved as a Custom Grid named Lead Insert. You can access it from the Grids of Object drop-down.

Detailed Operation Types
Insert
Use the Insert operation to add new records to Salesforce.
Steps:
Upload your Excel file using Smart Import.
Select the Salesforce Object and choose Insert.
Review field mappings and click Import.
Update
Use the Update operation to modify existing records in Salesforce.
Steps:
Export the data from Salesforce using the Data Export feature.
Edit the required fields in your Excel file.
Upload the file in Smart Import and select Update.
Note: You must include the Salesforce Record ID column to perform an update. Using Excel without Record IDs will result in an error. Because finding and entering Record IDs manually is time-consuming, using a standalone Excel file for the Update operation is not recommended.
Upsert
Use the Upsert operation to add new records or update existing ones using External IDs.
Steps:
Upload your Excel file.
Select Upsert as the operation type.
Map fields using the External ID field in Salesforce.
Finding or Creating an External ID
In Salesforce, go to Setup → Object Manager → [Your Object] → Fields & Relationships.
Locate a field already marked as an External ID in the Data Type column.

To create a new External ID:
Click on the field name.
Click Edit, and check the External ID box under General Options.
Salesforce supports Text, Email, and Number field types for External IDs.

Example: Importing New Contacts
Let’s look at an example of importing new contacts into Salesforce.
Go to the Import tab in the Left Panel.
Upload your Excel file (e.g.,
Contacts.xlsx
).Select the Object: New Contact and the Operation: Insert.
On the Match screen:
Verify mappings and manually map any unmapped fields.
Use Lookup Via for lookup relationships (e.g., Account Name → Website).
On the Settings screen:
Review details.
Select After successful import, Save as Wave Grid.
Click Preview & Import, review your data, and click Import.
Once imported, your new Contact records will appear in Salesforce. Because you selected Save as Wave Grid, the imported data will also be available as a Custom Grid named New Contact Insert, accessible from the Grids of Object dropdown.
Error Handling
If errors occur during import (such as unmapped fields or missing External IDs):
Review the error message displayed.
Correct the issue in Excel or field mapping.
Re-import once resolved.
The updated Smart Import process gives you complete control over how data is imported into Salesforce — from file upload to duplicate management and final review. With steps for Import → Match → Deduplication Evaluation → Summary → Preview, you can confidently insert, update, or upsert records with accuracy and ease.
Last updated
Was this helpful?