Skip to content
Get a quote

How does the Zoho CRM Migration Wizard work, and what are its limits?

Short answer

Zoho CRM's Migration Wizard takes a zip of CSV files plus attachments from any CRM, or connects by API to HubSpot, Pipedrive and a few others. It creates up to 50 custom fields, can't create formula or autonumber fields, and pauses when 5,000 records in a module are skipped. API migrations exclude custom modules. FlitStack AI handles the rest.

By

What we handle5
  • Migrate a whole CRM from files
  • Migrate from HubSpot, Pipedrive and other API sources
  • Create fields during migration
  • Owners and related records
  • Attachments

What the native tool does, and where it stops

TaskNative toolWith FlitStack AI
Migrate a whole CRM from filesMigration Wizard: a zip with Data and Attachments folders, auto-mapped to modules and fields. Undo from Import History.Extracts from the source's API, so you don't build CSVs or attachment mapping files.
Migrate from HubSpot, Pipedrive and other API sourcesAPI transfer for Pipedrive, Capsule, HubSpot, Insightly, Highrise, Bitrix and Bigin. No custom modules; undo or rerun at most three times.Includes custom objects and modules, with as many sample and full runs as the project needs.
Create fields during migrationUp to 50 new custom fields, counted against your edition's limit. Autonumber and Formula fields can't be created.Proposes the Zoho schema from the source and flags fields that must be built by hand first.
Owners and related recordsMigrate users.csv first. Associations work on source IDs. Sub-forms need the parent ID in their file.Matches owners by email and rebuilds relationships from source IDs automatically.
AttachmentsNeed an attachments CSV and the files in the same zip. Missing files cause File Not Found errors.Moves files with their parent records and reports any that can't be read.
Import into a single moduleImport tool: 25 MB per file, 1,000 to 200,000 rows by edition, 500 columns, 100 related records per parent.No per-file row limits; large volumes run with rate-limit handling.
Check and roll backPause on skipped records, undo from Import History, edit mapping and re-run.Field-level validation and hash checks on every record, with one-click rollback.

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?

SituationOptionKey limits
One module from a spreadsheetImport tool25 MB per file; rows by edition; 500 columns
A whole CRM exported to CSVsMigration Wizard (files)Zip of Data and Attachments folders; 200 files and 25 GB total
Pipedrive, Capsule, HubSpot, Insightly, Highrise, Bitrix or BiginMigration Wizard (API transfer)No custom modules; undo or rerun at most three times
Custom objects, full email and activity history, short cutoverA migration tool or serviceNot 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?

  1. Export every module from the old CRM as CSV, one file per module.
  2. 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.
  3. Keep source IDs in every file. Zoho associates records between modules (for example contacts to accounts) using those IDs.
  4. 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.
  5. Build an attachments CSV that maps each file to its parent record, and put the files in an Attachments folder.
  6. Create Formula, Autonumber and any other fields the wizard can’t create, in Zoho, before you start.
  7. 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?

  1. Go to Setup > Data Administration > Import and choose the source (or Zoho CRM for generic files).
  2. Upload the zip. Zoho auto-maps files to modules and columns to fields.
  3. Map any unmapped files. Create new modules if you need them, and map mandatory fields.
  4. Create custom fields where needed (up to 50), then save and review the mapping.
  5. Click Start Migration. Watch for a pause on skipped records.
  6. Check counts per module and open a sample of records with their notes, activities and attachments.
  7. 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:

EditionRows per file
Free1,000
Standard / Zoho One Standard20,000
Professional50,000
Enterprise / Zoho One Enterprise100,000
Ultimate / CRM Plus200,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.

Questions, answered

A few useful answers.

Who can use the Zoho CRM Migration Wizard?

Zoho's migration pages say you need an account with Administrator privileges, or a profile with the Data Migration permission. The wizard is under Setup > Data Administration > Import.

Does the Zoho Migration Wizard bring custom modules?

From files, yes: Custom Modules and Linking Modules are on the supported list. From API sources such as HubSpot, no: Zoho says it does not support custom modules in API migrations.

How many records can I import into Zoho CRM at once?

With the single-module import tool, rows per file are 1,000 on Free, 20,000 on Standard, 50,000 on Professional, 100,000 on Enterprise and 200,000 on Ultimate, with 25 MB per file. The Migration Wizard works on much larger zip uploads, up to 200 files and 25 GB in total.

Why did my attachments fail to migrate into Zoho CRM?

Zoho's FAQ says a File Not Found error means the attachment files weren't found during migration. The attachments CSV and the files must be zipped together, and records' owners should be migrated first so the files have a valid parent.

Get a quote

Rather have it done for you?

FlitStack AI maps, validates and migrates your data, sets up the process in the new system, and keeps a one-click rollback.

Get a quote