Skip to content
Get a quote

How do I migrate from Salesforce to Zoho CRM including attachments?

Short answer

Use Zoho's file-based Salesforce migration. Run Salesforce's Data Export with "Include images, documents, and attachments" and "Include Salesforce Files" ticked. Then upload the CSVs to Zoho's Migration Wizard with an Attachments folder and a mapping CSV that links each file to its record. Migrate users first. Emails aren't on Zoho's list of migratable modules.

By

How the native path works

Zoho’s migration from Salesforce is file-based. You upload a zip of Salesforce CSVs, and Zoho maps them to Users, Leads, Accounts, Contacts, Deals, Campaigns, Notes, Activities, Attachments, Cases, Solutions, the inventory modules and Price Books. Attachments go in an Attachments folder, plus a CSV that maps each file to its parent record.

Steps

  1. Export from Salesforce. In Setup > Data Export, tick Include images, documents, and attachments and Include Salesforce Files and Salesforce CRM Content document versions. Salesforce delivers zips of up to about 512 MB each and deletes them 48 hours after the email, so download them straight away.
  2. Rebuild the parent links for Files. Legacy Attachments carry a ParentId. Salesforce Files don’t: the link to the record sits in ContentDocumentLink, and ContentVersion holds the file. Join the two before you build Zoho’s mapping CSV. If you skip this, the files upload without any parent records.
  3. Migrate users first. Zoho’s FAQ says the user file has to be migrated before the other modules, because record owners and attachments refer to users.
  4. Keep the original folder structure. Upload the folder exactly as described (Data.zip). Zoho warns that extra folders can make the upload fail.
  5. Put parents and children in the same migration so lookups resolve.
  6. Check Import History. You can undo the migration there if the result is wrong.

What the native tool does / where it stops

ItemZoho’s Salesforce migrationGap
Standard modulesCoveredCustom objects need careful mapping to custom modules
AttachmentsAttachments folder plus mapping CSVYou build the mapping; Files need the ContentDocumentLink join
Size2 GB per file, 25 GB total; zip up to 10 GB or 200 CSVsLarge file sets go in several batches
Skipped recordsMigration pauses if more than 5,000 records in a module are skippedYou have to fix the source data and retry
EmailsNot listedA separate load is needed
Workflows, validation rulesNot migratedRebuild them as Zoho workflows and Blueprints

Where FlitStack AI fits

FlitStack AI reads Salesforce through its API and resolves file links for you. It migrates users first and loads attachments with their records, with a sample run to check. See Salesforce to Zoho CRM or the Zoho CRM migration page.

Questions, answered

A few useful answers.

Is Zoho's Salesforce migration an API connection?

No. Zoho runs API migrations for apps like HubSpot and Pipedrive, but for Salesforce you upload a zip of CSV files exported from Salesforce.

How large can the upload be?

Zoho accepts files up to 2 GB each and 25 GB in total, with zip files up to 10 GB or 200 CSV files. Large attachment sets have to be split across uploads.

What happens to Salesforce emails?

Emails aren't among the modules Zoho's Salesforce migration lists. Pull them from Salesforce (EmailMessage or email Tasks) and load them as notes or into a custom module, or sync the mailboxes to Zoho going forward.

A closer look

Tell us what you’re moving.

Share your source, destination and rough record counts. We scope the migration and the process work with you and send you a quote.

Get a quote