Migrate into Freshsales by listing what you need, mapping fields, piloting one seller’s book, dual-running for a week, then cutting over only after sellers sign off. If you can’t explain where companies, people, and open deals land — and what you will leave behind — don’t run a bulk import yet.
Inventory sources
Map fields & stages
Pilot one seller
Dual-run one week
Seller sign-off
Keep an exit copy
Freshsales migration media
Import/data-move surfaces and vendor migration walkthroughs for Freshsales when available — unrelated product tour footage is omitted.
Official Freshsales migration walkthrough
Vendor walkthrough of data move / UI migration surfaces. Validate against your own export and mapping checklist.
This video is hosted on YouTube
This content is hosted by YouTube. The player loads only after you allow marketing cookies.
Map to what this product supports — Freshsales research supports contact management, lead management, pipeline management, and deal management — your object model has to land inside that, not inside your old CRM's shape.
Pilot beats big-bang — One successful Freshsales import of a single owner's deals teaches more than a weekend bulk load.
Stage meaning is the real migration — Columns copy easily; “what qualified means” does not. Agree stage definitions before mapping.
Custom structure has limits — Custom fields is researched across every Freshsales plan we snapshot.
Keep an exit copy — Retain source exports until Freshsales passes seller spot-checks — and ask the export question before you sign, not at renewal.
Verify tooling, do not assume it — Import formats, record limits, and API behaviour belong in Freshsales documentation. Our pricing snapshot records a 21-day trial on Growth, Pro, and Enterprise — confirm current terms on the Freshsales pricing page before you build a schedule around it.
Prove mapping into Freshsales before you move every historical activity.
Freshsales checklist
Bring these questions to every demo
Ask vendors to show the workflow live, not just describe it.
1Inventory sources and objectsCRM, sheets, mailboxes — must/later/archive.
2Sign the field mapMeanings before bulk import.
3Pilot 20–50 clean recordsSeller spot-check before scale.
4Run a dual-run weekFreshsales as system of record; old system read-only.
5Validate counts and samplesOpen deals and seller-critical records.
1. Inventory objects against what Freshsales supports
Map meanings first; bulk import second.
Must move
Open deals, active contacts and companies, recent activities.
Later
Closed-won history for reporting — after cutover proves stable.
Archive only
Dead records and fields with no home in Freshsales. Export, store, move on.
List every source and object before you design a Freshsales import.
List every source: previous CRM, spreadsheets, mailboxes, invoicing tool, the one person's laptop.
List the objects: companies, people, open deals, closed history, activities, tasks, notes, files.
Map each object to a capability Freshsales research confirms — contact management, lead management, pipeline management, and deal management are the anchors.
Classify each object as must-move, later, or archive-only.
Count records per object.
Worked example: a 12-person B2B advisory team finds 3,100 contacts, 780 companies, 62 open deals, four years of closed history, and two spreadsheets. Only contacts touched in 24 months, all companies, and open deals are must-move into Freshsales; closed history stays in an exported archive.
2. Write the field map — including stage meanings
Map source fields and stages into Freshsales before you touch bulk import.
One-to-one
Name, email, company, owner, close date — mechanical.
Needs a rule
Stage, status, source, and inconsistent free-text.
Do not migrate
Fields with no owner, no decision, and no report behind them.
Map meanings first. Bulk import second.
Three columns: source field → Freshsales destination → transformation rule.
Map stages by buyer-verifiable meaning, not labels — merging stages is fine.
Every record needs an active Freshsales owner — no ex-employee owners.
Leftovers: Custom fields is researched across every Freshsales plan we snapshot — only if someone names the decision it drives.
In Freshsales, open the import or data-management area — confirm the current control labels in the product, docs, or trial.
Worked example: a 12-person B2B advisory team maps account → company and opportunity → deal, collapses seven stages into six, reassigns 40 orphaned records, and archives 22 unused columns.
3. Pilot one owner's book in Freshsales
Pilot a small clean segment into Freshsales and fix the map before bulk.
Pilot pass
Counts match, owners correct, stages sensible, seller recognises their deals.
Pilot fail
Fix the map, clear the sample, re-import. Do not scale a broken mapping.
Tooling limit hit
Confirm Freshsales import formats and limits in documentation before promising a date.
Pick one seller with a representative book — roughly 30–60 open deals and their contacts.
Import companies first, then people, then deals, then activities. Order matters: relationships need their parents to exist.
Run the import on the plan you actually intend to buy, not just Growth if your must-haves live higher. Our pricing snapshot records a 21-day trial on Growth, Pro, and Enterprise — confirm current terms on the Freshsales pricing page before you build a schedule around it.
Check counts against the source before you look at anything else: companies in, people in, deals in, activities in.
Sit with that seller for 20 minutes. Ask them to find three deals and tell you what looks wrong. Their answer is the acceptance test.
Fix the map and re-import the sample. Expect to do this twice; that is the point of a pilot.
Worked example: a 12-person B2B advisory team pilots 62 deals into Freshsales, discovers two stages mapped backwards and every activity timestamped as import day, fixes both, then re-runs the sample before touching the rest of the book.
4. Dual-run for one week, then validate with sellers
Dual-run Freshsales as system of record for one week before cutover.
Dual-run rule
New work in Freshsales; source frozen for edits.
Validation owners
Admin checks counts and structure; sellers check their own deals.
Rollback plan
Know exactly how to clear a bad bulk load and re-import from source.
Announce one rule for the dual-run week: all new activity goes into Freshsales; the old system is read-only for history.
Bulk-import the remaining must-move records at the start of that week, in the same object order as the pilot.
Run the validation checklist in Freshsales: every open deal has an owner and a stage; deal counts by owner match the source; contacts resolve to companies; no obvious duplicates on the top 50 accounts; activity dates are real, not import dates; required fields are populated.
Hold a 30-minute seller spot-check — each seller opens their own five biggest deals and signs off or flags. Admin approval is not validation.
Log every defect with an owner and a fix date. Unowned defects become permanent distrust.
Worked example: a 12-person B2B advisory team dual-runs for six working days, catches 14 duplicate companies and three deals with missing owners in Freshsales, fixes them all before Friday, and gets verbal sign-off from all eight sellers.
5. Cut over — and do your export diligence now
Cut over to Freshsales only after sellers sign off — then confirm export terms in writing.
Cutover ready
Validation passed, sellers signed off, defects closed.
Cutover blocked
Open defects with no owner — hold the date, fix the data.
After cutover
Follow Freshsales implementation gates; do not start adding apps.
Make Freshsales the system of record on a named date.
Cut over; revoke edit access to the old system the same day.
Store source exports with a note of what they contain and when.
Confirm in writing how you export companies, people, deals, activities, and files out of Freshsales — formats, attachments, post-cancellation.
Schedule the day-30 adoption review from the implementation guide.
Update the one-pager: what moved, what was archived, who signed off.
Worked example: once Friday’s Freshsales pipeline matched reality, a 12-person B2B advisory team revoked spreadsheet edits, archived exports, and asked in writing how a future export works — before renewal.
Freshsales migration mistakes
Big-bang import with no pilot
A weekend bulk load into Freshsales means Monday surprises and permanent seller distrust.
Bringing every legacy custom field
Clutter migrates faster than value. Custom fields is researched across every Freshsales plan we snapshot — that is not permission to recreate all of it.
Mapping stage names instead of stage meanings
Identical names hide different definitions; your forecast inherits the confusion.
Skipping seller validation
Admins approve structure; sellers notice their missing deals. Both have to sign off in Freshsales.
Importing records owned by ex-employees
Every Freshsales record needs an active owner, or it silently stops being worked.
No retained export and no exit answer
Keep source files until Freshsales proves trustworthy, and get the export process in writing before you sign.
Frequently asked questions
Can we migrate everything into Freshsales at once?
You can, but you should not. Decision rule: pilot one owner's book, fix the map, then scale. Bulk-importing an unvalidated map is the most common reason a CRM rollout loses seller trust.
Which objects should we move first?
Companies, then people, then open deals, then recent activities — parents before children. contact management, lead management, pipeline management, and deal management are the Freshsales anchors in our research; old closed history can stay in an archive export.
How do we map custom fields into Freshsales?
Custom fields is researched across every Freshsales plan we snapshot. Recreate a field only when someone can name the decision or report that depends on it; everything else goes to the archive CSV.
How long should the dual-run last?
One week is usually right: long enough to catch mapping defects, short enough that people actually switch. Freeze the old system for edits during that week or you will migrate twice.
Who should own the migration?
The Freshsales admin owner runs the mechanics; a sales champion owns stage meaning; each seller validates their own book. Not an intern alone with a CSV.
What do we validate before cutting over to Freshsales?
Deal counts by owner, every open deal has an owner and stage, contacts resolve to companies, no duplicates in the top accounts, activity dates are real rather than import dates, and required fields are populated. Then seller sign-off.
What about getting data back out later?
Ask before you sign: which objects export, in what format, whether notes and attachments come along, and what happens to data after cancellation. Keep your pre-migration exports either way.
What should I do next?
Run the Freshsales setup guide in parallel with the pilot so the target workspace is ready, then follow the implementation guide's 30/60/90 gates after cutover.