Salesforce to Salesforce Migration Guide (2026 Edition)

Most Salesforce-to-Salesforce migrations still go through CSV: export, clean in Excel, fight Id mismatches, then hope related records land cleanly at cutover. In 2026 you can skip that middleman. Move records, files, and relationships directly between orgs, run a sample load first, and keep a path to roll back if a job goes wrong.

Dataimporter is built for org-to-org work—no Apex, no CSV hop. Start with the Salesforce to Salesforce migration tool, then follow the steps below. For sandbox projects, also see why sandbox seeding matters.

‍

Here are the key steps involved:

Why Choose Dataimporter?

• Migrate standard and custom objects, including relationships
• Seamlessly handle Attachments, Files, Tasks, and Emails
• Preserve lookup relationships automatically
• Apply SOQL filters, deduplication, and formulas
• Schedule one-off or recurring syncs

‍

1. Use Migration Templates for Multi-Object Migrations

Rather than migrating objects one-by-one, use Migration Templates to handle entire data models in a single flow. Whether you're moving Accounts with Contacts, Opportunities, and Files, or Cases with related Tasks and Attachments, Templates keep everything structured.

• Add top-level and related objects (e.g., Attachments related to Cases)
• Apply SOQL filters per object (e.g., RecordType.DeveloperName = 'BusinessAccount')
• Relationships are preserved automatically using reference keys

Tip: You can add the same object multiple times with different filters or mappings (e.g., Business vs Person Accounts).

‍

2. Connect Your Salesforce Instances

Log in to both your source and target Salesforce orgs from the Instances page. You can connect Production or Sandbox environments securely via OAuth.

‍

3. Add and Configure Objects

In the Migration Template:

• Choose source and target objects (they can be different between orgs)
• Optionally apply filters like: CreatedDate = LAST_N_DAYS:30
• Dataimporter supports standard, custom, and managed package objects

‍

4. Map Fields Automatically or Manually

Dataimporter automatically suggests field mappings. You can:

• Edit field mappings (e.g., map AccountSource to a custom field)
• Map lookup fields using external IDs or custom keys
• Rename or exclude fields as needed

‍

5. Apply Data Cleaning, Filters, and Formulas

Use built-in tools to refine your migration:

• Deduplicate records by email, name, or custom rules
• Replace Nulls or empty fields
• SOQL filters for record-level selection
• Dataimporter Formulas for transforming fields on the fly (e.g., map Record Types, format names, assign owners)

See Formula Reference

‍

6. Preview and Validate Your Migration

Before running, preview sample records:

• Validate field mappings and formulas
• Confirm SOQL filters are working as expected
• Adjust configuration before committing

‍

7. Run or Schedule Your Job

You can:

• Run the job immediately
• Schedule it for recurring syncs (e.g., nightly or weekly)
• Dataimporter stores your mappings, filters, and rules for reuse

‍

8. Monitor and Review Results

After execution:

• View result logs and success/error breakdowns
• Download detailed reports per object
• Re-run jobs or tweak configuration as needed

‍

Special Considerations for Files and Attachments

Salesforce limits API calls to 50MB per batch when transferring Files or Attachments. Dataimporter uses the REST API to ensure compatibility.

Tip: Reduce batch size when migrating large files to avoid hitting limits.

To migrate Files:

• Include ContentVersion and ContentDocumentLink (no need to add ContentDocument)

Salesforce File Limits Documentation

‍

Before cutover: sample load, backup, rollback

Don't jump straight to production cutover.

• Run a sample load into a sandbox or a filtered subset first
• Take a backup snapshot of the records you're about to touch
• Confirm you can roll back only those rows if mapping or filters were wrong
• If you're seeding sandboxes for testing, use a real subset instead of hand-built Accounts—see sandbox seeding
• Permission set assignments are easy to miss; see permission set assignment migrations

‍

Start Your Migration

Whether you're consolidating orgs after an acquisition, moving from sandbox to production, or setting up a recurring sync between orgs—Dataimporter makes it fast, accurate, and low-maintenance. Compare your options in our Salesforce migration tools guide, or dive into the Salesforce to Salesforce migration tool.

Ready to simplify your Salesforce migration? Sign up for a free Dataimporter account and start building your first Migration Template today or Book a Demo.

‍