Zoho CRM has two ways in. The import tool loads one module from a spreadsheet. The Migration Wizard loads a whole CRM, either from a zip of files or, for a handful of sources, straight from the source’s API. Both are free and built into Zoho CRM. Both have limits that decide whether your history arrives intact. This guide covers the limits from Zoho’s documentation and the order of work that avoids the common failures.
Which Zoho CRM import option should I use?
| Situation | Option | Key limits |
|---|---|---|
| One module from a spreadsheet | Import tool | 25 MB per file; rows by edition; 500 columns |
| A whole CRM exported to CSVs | Migration Wizard (files) | Zip of Data and Attachments folders; 200 files and 25 GB total |
| Pipedrive, Capsule, HubSpot, Insightly, Highrise, Bitrix or Bigin | Migration Wizard (API transfer) | No custom modules; undo or rerun at most three times |
| Custom objects, full email and activity history, short cutover | A migration tool or service | Not limited by the wizard’s rules |
Zoho’s overview also mentions custom-made setups for Salesforce, other Zoho CRM accounts, Pipedrive, Highrise, Insightly, Microsoft Dynamics and Maximizer. Those are file-based: you supply the CSVs.
What are the Zoho Migration Wizard’s limits?
From Zoho’s migration pages:
- Who: an Administrator, or a profile with the Data Migration permission.
- Modules: Users, Leads, Accounts, Contacts, Deals, Campaigns, Notes, Activities (tasks, meetings, calls), Attachments, Custom Modules, Linking Modules, Cases, Solutions, Products, Quotes, Sales Orders, Invoices, Purchase Orders, Vendors, Price Books, Services and Appointments.
- New fields: up to 50 custom fields can be created during migration, counted against your edition’s overall limit.
- Field types: Autonumber and Formula fields can’t be created during migration.
- Skipped records: migration pauses if more than 5,000 records in a module are skipped, and you choose to discard or continue.
- Tags: only the first 10 tags per record migrate, each up to 25 characters.
- Currency: if a file’s currency differs from your home currency, Zoho uses the default currency. Its example converts INR amounts when the home currency is USD.
- Files: uploads are capped at 200 files and 25 GB in total. Zoho’s FAQ gives 2 GB per file and its overview gives 5 GB, so plan for the lower figure.
- Recovery: undo from Import History, discard and start over, or edit the mapping and re-run.
For API migrations (the HubSpot page is typical), Zoho adds: no custom modules, and undo or rerun at most three times.
How do I prepare files for the Zoho Migration Wizard?
- Export every module from the old CRM as CSV, one file per module.
- Export users to a users.csv file. Zoho’s FAQ says owner assignment uses migration IDs and needs the users file migrated alongside the other modules.
- Keep source IDs in every file. Zoho associates records between modules (for example contacts to accounts) using those IDs.
- Prepare sub-form files with the parent record’s ID in each row. Zoho’s FAQ also notes sub-forms have a maximum of 10 fields and can’t contain multi-select lookups.
- Build an attachments CSV that maps each file to its parent record, and put the files in an Attachments folder.
- Create Formula, Autonumber and any other fields the wizard can’t create, in Zoho, before you start.
- Zip the Data and Attachments folders together. Don’t re-compress an extracted folder or add extra folders; the upload may fail.
How do I run the migration in Zoho CRM?
- Go to Setup > Data Administration > Import and choose the source (or Zoho CRM for generic files).
- Upload the zip. Zoho auto-maps files to modules and columns to fields.
- Map any unmapped files. Create new modules if you need them, and map mandatory fields.
- Create custom fields where needed (up to 50), then save and review the mapping.
- Click Start Migration. Watch for a pause on skipped records.
- Check counts per module and open a sample of records with their notes, activities and attachments.
- If something is wrong, undo from Import History, fix the mapping and re-run.
What does the Zoho import tool allow per file?
For loading a single module, Zoho’s limits are:
| Edition | Rows per file |
|---|---|
| Free | 1,000 |
| Standard / Zoho One Standard | 20,000 |
| Professional | 50,000 |
| Enterprise / Zoho One Enterprise | 100,000 |
| Ultimate / CRM Plus | 200,000 |
| Users module (all editions) | 1,000 |
Files can be up to 25 MB with 500 columns, and each parent record can have up to 100 related records per dependent module in the file. To avoid duplicates in Add mode, choose a unique field; rows matching existing records are skipped.
How do I fix common Zoho migration errors?
- Owners not assigned: the users file wasn’t migrated alongside the other modules, or the owner IDs don’t match it.
- Records not linked: the child file is missing the parent’s source ID, or the parent module wasn’t in the same migration.
- File Not Found on attachments: the attachments CSV points to files that aren’t in the zip’s Attachments folder.
- Migration paused: more than 5,000 records in a module were skipped; check mandatory fields and value formats before choosing to continue.
Where does Zoho’s native migration stop?
- Emails. The migration pages don’t list email history as a module for file or HubSpot API migrations. Teams moving from Salesforce or HubSpot often lose the email timeline.
- Custom modules from API sources. You have to rebuild them as files.
- Calculated fields. Formula and Autonumber fields have to exist before migration; their historical values may need a separate field.
- Repeatability. Three undo-or-rerun attempts on an API migration leaves little room for a sample run, a fix and a final run.
- Cutover. Records changed in the old CRM after export need a second pass.
When to bring in FlitStack AI
FlitStack AI is a data-migration platform sold as software plus a done-for-you service. It reads the source CRM through its API, proposes the Zoho schema and field-level mappings with AI for you to review, matches owners by email, and moves activities with original timestamps and user attribution, along with attachments and custom objects. Every record is validated, every run can be rolled back in one click, and delta migration keeps both systems aligned during cutover. The Zoho CRM implementation service sets up blueprints, layouts and workflows.
Common routes: Salesforce to Zoho CRM, HubSpot to Zoho CRM and Pipedrive to Zoho CRM. See the Zoho CRM migration hub, or book a free scoping call.