Gainsight documents how to load data from a CRM. It does not document how to arrive from another customer success platform, and that is the migration most teams are actually running.

The distinction decides your timeline. If you are coming off Salesforce or a spreadsheet, there is a supported path with three out-of-the-box sync jobs waiting for you. If you are coming off ChurnZero, Totango, Planhat, ClientSuccess, Custify or Vitally, there is no connector, no documented process, and a block of work nobody put in the quote.

This guide covers the second case. What transfers, what you rebuild, how long it honestly takes, and the question worth asking before you start.

We build GainTrace, which competes with Gainsight at the lighter end of this market. That is disclosed here rather than buried, and we get to where we fit at the very end. Everything before that is sourced, with the source named, so you can check it rather than trust us.

Gainsight is worth being accurate about. Launched in 2009, it more or less created the category. It has 3,500+ customers and is a Gartner Magic Quadrant Leader, and it is the deepest, most configurable customer success platform on the market. None of what follows says otherwise. It says that depth has a migration cost, and that the cost is knowable in advance.

Is Gainsight the right platform to move to?

Before the how, the gut check. Replacing a CS platform is one of the more disruptive projects a post-sale org takes on, so it should clear a real bar.

Move to Gainsight if:

  • You run customer success as an enterprise revenue discipline across a large book, with multi-product or multi-region account structures.
  • Salesforce sits at the centre of your stack and you want the deepest native integration available.
  • You have, or will fund, a dedicated administrator or CS Ops function. This is the single most reliable predictor of whether a Gainsight rollout succeeds.
  • You need orchestration depth: lifecycle programs, success plans, renewal forecasting and executive reporting in one system.
  • You are ready to rebuild your health scores, playbooks and automations rather than copy them across. You will be rebuilding them regardless. The only question is whether you planned for it.

Think twice if:

  • Nobody will own the configuration. "CS Ops will pick it up" is a reliable way to stall a rollout, and the reviews are full of teams who learned that after signing.
  • Your real problem is process, not platform. No defined customer journey, messy data, weak adoption. A new platform inherits all three and makes them more expensive.
  • You cannot fund the administrator. Reviewers consistently report needing a dedicated owner to keep scorecards, rules and the Salesforce sync working. That is a salary, not a line item.
  • What you actually need is early churn signals and a lighter footprint rather than a system to run your whole operation inside. More on that at the end.

Gainsight's two lowest-scoring metrics on G2 are Ease of Setup at 6.6 and Ease of Admin at 6.9, the lowest in its category. That is not a reason to avoid it. It is a reason to staff it properly.

What you are migrating into: the Gainsight object model

Gainsight loads business data into five destinations, and everything else is built on top of them:

  • User object. Gainsight users as active users, plus non-Gainsight users who need to receive dashboards and C360 layouts, as inactive users.
  • Company object. Your accounts.
  • Person object. Your contacts.
  • Relationship object. Your relationship entities, which is how Gainsight models multi-product or multi-team structures inside one account.
  • Custom objects. Any other business data.

That is the whole import surface. Read it again, because it explains the rest of this guide.

Gainsight provides configurable primitives, Customer 360, Scorecards, Cockpit CTAs, Playbooks, Journey Orchestrator and Renewal Center, and requires you to build your CS operation from them. Those primitives are configuration, not data. Configuration has no import path, from any system, including a previous Gainsight org.

The connector gap: Gainsight has no integration with any CS platform

Here is what Gainsight connects to, from its own connector documentation.

  • CRM: Salesforce, HubSpot, Microsoft Dynamics, Pipedrive, Zoho
  • Support: Zendesk, Freshdesk, Jira, ServiceNow
  • Product usage: Mixpanel, Segment
  • Warehouse: Snowflake, BigQuery, Databricks, SAP DataSphere
  • Other: S3 file ingestion, REST API, Zapier, Zuora, Intercom, SAP, SurveyMonkey
  • Gainsight products: PX, Customer Communities, Customer Education

There is no connector for ChurnZero. None for Totango, Planhat, ClientSuccess, Custify or Vitally.

This is not a criticism. No CS platform builds importers for its competitors, and it would be odd if one did. But it changes who does the work.

Your accounts and contacts will arrive without drama, because they live in your CRM, not in your CS tool. What will not arrive is everything that made the old platform worth paying for: health score history, CTA and playbook history, and the timeline of what each CSM actually did on each account. None of it has a supported route in. It moves as CSV through the Data Operations page or through S3 file ingestion, or it does not move.

Decide which of those you are doing before you sign, because it is the difference between a data task and a quarter.

How do you migrate to Gainsight? The documented steps

Gainsight's published onboarding sequence is CRM-first. These are the steps as documented.

Step 1: Install and authorise

Install the Gainsight connected app package in your Salesforce org. The Salesforce user whose credentials carry the connection must have API access. Teams on Microsoft Dynamics follow the equivalent Dynamics connector path.

This step is administrative and fast. It is also the only part of a CS-platform migration that Gainsight documents end to end, which tells you something about where the rest of the effort sits.

Step 2: Run the out-of-the-box sync jobs

The Salesforce Connector ships three jobs:

  • User Sync, Salesforce User to the Gainsight User object
  • Company Sync, Salesforce Account to the Gainsight Company object
  • Company Person Sync, Salesforce Contact to the Gainsight Person and Company Person objects

If your CRM is clean, this is the easy day. If it is not, this is where you find out.

Step 3: Load everything the connector does not carry

Four channels exist. The Salesforce Connector is the primary one. Beyond it: the Data Operations page for Company and Relationship objects, the User Management page for manual or CSV user loads, and the Person Admin page for bulk Person records.

Everything coming out of your old CS platform arrives here, by CSV. Budget real time for mapping, because your old platform's field names will not match Gainsight's object model and nobody will do that translation for you.

Step 4: Configure the operation

After signing, Gainsight assigns an implementation team that maps your CRM data model, defines scorecard measures and builds Calls to Action. This is the part that takes months rather than days, and the part no import touches.

Step 5: Validate before you cut over

Test health scores against accounts whose real status you already know. If the new score disagrees with your gut on accounts you understand, the model is wrong, and shipping it teaches your CSMs to ignore the number permanently.

Step 6: Go live and enable

The platform being ready is not the project being done. Adoption is where these rollouts succeed or fail, and the reviews are blunt about it.

What moves to Gainsight and what you rebuild

The single most useful thing to establish before anyone scopes this project: your records move, your logic does not.

WHAT YOU HAVE TODAYDOES IT MOVE?HOW
AccountsYesCompany Sync from CRM, or Data Operations
ContactsYesCompany Person Sync into Person
Users and CSM ownership YesUser Sync, or CSV via User Management
Multi-product relationshipsYesData Operations into the Relationship object
Product usageRe-pointed, not movedMixpanel, Segment, warehouse or S3
Support ticketsRe-pointed, not movedZendesk, Freshdesk, Jira, ServiceNow
Custom fieldsYes, if mapped first Custom objects
Timeline and activity historyCSV onlyNo connector exists
Health score historyCSV only, as numbersThe values land, the model does not
Health score modelNo. RebuildScorecards
Open alerts and tasksNo. RebuildCockpit CTAs
PlaybooksNo. RebuildPlaybooks
Lifecycle automationNo. RebuildJourney Orchestrator
Renewal forecastingNo. RebuildRenewal Center
Dashboards and reportsNo. RebuildC360 layouts and reports
What transfers and what gets rebuilt in Gainsight

Read the bottom six rows again, because that is the project.

A planning heuristic: the rows that move are days of work. The rows you rebuild are months. If a quote or a project plan treats the whole thing as one data exercise, it has priced the top of this table and ignored the bottom.

One operational detail worth knowing before you design anything: Gainsight scorecards resolve nightly at 23:59 UTC. If your team expects a score to move the moment a signal does, set that expectation now rather than in week six.

What to leave behind when you move to Gainsight

A migration is the cheapest opportunity you will ever get to delete things, and most teams waste it. Every record you carry over is one you pay to map, validate and then look at.

  • Churned and closed-lost accounts beyond the window you actually report on. Archive them at source.
  • Duplicates, test records and demo data. You are about to map these by hand. Do not map garbage.
  • Custom fields with low fill rates. If under roughly a tenth of records carry a value, that is a field somebody added once, not a field you use.
  • Automations nobody has fired in twelve months. Rebuilding them is real work in Journey Orchestrator. Make each one earn its place.
  • Health scores you never trusted. If CSMs already ignore the number, porting the logic preserves the distrust. You are rebuilding the model anyway. Rebuild it properly.
  • Playbooks tied to a segmentation you retired. These are the quiet source of post-go-live confusion.
  • Deactivated users and their account assignments. Re-assign ownership before cutover, not after.
  • Anything nobody will claim. If no named person will say "yes, we need that in Gainsight," that is your answer.

Run this as a decision pass, with an owner and a date, before mapping begins. Deciding what not to move is faster than moving it.

Going live: all at once or segment by segment

Two routes, and the choice sets your risk profile.

ALL AT ONCESEGMENT BY SEGMENT
Cutover riskConcentrated on one daySpread across waves
Parallel runningNone, old system goes read-onlyTwo systems live for weeks
Time to full valueShorter if it worksLonger by design
Where it hurtsEveryone hits the same bugs togetherSustained overhead, team works in two places
Best forClean data, small book, strong adminLarge books, messy data, multi-region
All at once vs segment by segment go-live comparison

If you phase it, migrate your least critical segment first, not your largest. The first wave is where you discover what the mapping actually got wrong, and you want that discovery on accounts that can absorb it.

Your Gainsight rollback plan

Almost nobody plans one, which is why a bad cutover becomes a bad quarter. You do not need a complex plan, you need decisions made in advance.

  • Set a freeze window. No edits in the old system between the final export and confirmed go-live.
  • Keep the old system read-only. Hold the license 30 to 60 days past go-live.
  • Take a final export you can actually restore from, and open it to confirm before you rely on it.
  • Agree the rollback triggers in writing. For example: record counts off by more than 2 percent, a broken CRM sync, or health scores that disagree with known account status.
  • Name one person who can call it, and a date after which you commit forward instead.
  • Reconcile counts on day one. Accounts, contacts, open CTAs, activity volume, against the source.
  • Write the day-one comms in advance. What CSMs do, and where they raise problems.

In practice the realistic fallback is rarely a full restore. It is pausing the rollout while the old system stays readable, which only works if you kept the license.

The realistic Gainsight migration timeline

Nobody agrees on how long this takes, including Gainsight. Here is every figure, and who said it.

  • 8 weeks. Gainsight's own marketing, describing delivery of an end-to-end Customer Success framework.
  • About 4 months. Also Gainsight, on the same page: average time to verified outcome.
  • About 5 months. What G2 reviewers report for go-live.
  • 6 to 26 weeks. The full spread reviewers report, which is the honest range.
  • Almost a year. A VP of CS on r/CustomerSuccess, who also hired a full-time Gainsight administrator to get there.
  • 19 months. Reported time to ROI. A different question from go-live, and the one your CFO asks second.

The two numbers on Gainsight's own page tell you most of it. Eight weeks is how long it takes to have a framework configured. Four months is Gainsight's own estimate of when that framework produces a verified outcome. Those are different milestones, and a plan that treats them as one will be late by exactly the difference.

Three things move your number, and none of them are Gainsight. Whether your data is clean. Whether one named person owns the configuration. And whether you are arriving from a CRM or from another CS platform.

Plan for the back half of the range if any of these are true: you are moving CS history by CSV, you have not yet named a dedicated admin, or your health score model still has to be designed rather than ported.

What a Gainsight switch costs beyond the license

Three lines, and the license is only the first.

  • License. Quote-based. The verified median contract is about $49,879 a year across 367 purchases.
  • Implementation and services. Quoted separately. Commonly adds 20 to 40 percent in year one.
  • The administrator. Reviewers consistently report needing a dedicated owner. Budget it as a salary, which commonly runs $60,000 a year or more.

A switch priced on license alone is under-priced by a wide margin. The full breakdown, including tiers, per-user licensing and where the hidden fees sit, is in our Gainsight pricing guide, and we have not repeated it here.

What actually breaks after a Gainsight go-live

This is the section the vendor page will not write. None of it means Gainsight is a weak platform. It is a Gartner-recognised leader, and these are the known costs of its depth.

The learning curve is real and it lands on CSMs. The executive reporting is why Gainsight gets bought; the day-to-day experience is where the complaints concentrate. One reviewer put it plainly: "At the CSM level it's tedious as hell. At the executive level, the analysis you can do on the data is why it was purchased."

It needs an owner, not a volunteer. The most-cited failure mode in reviews is a platform that sprawls into dashboards nobody maintains once the implementation team leaves.

It is a layer on Salesforce, and that friction is felt. Reviewers describe moving between the two systems as added work on routine interactions, not a seamless single pane.

Data debt follows you. Migration moves your data. It does not clean it. Whatever is wrong in your CRM today will be wrong in Gainsight in five months, with more places to surface.

Adoption is the real risk, not the data load. The platform going live and the team using it are separate events, often separated by months.

Go in expecting these and you can plan around them. Go in on the marketing version and they arrive as surprises in month four.

Your Gainsight migration checklist

Before you sign

  • Named administrator, funded, with start date
  • Source system identified: CRM or CS platform, because it changes everything below
  • Decision pass complete on what you are not migrating
  • CRM data quality assessed, not assumed
  • Budget covers license, services at 20 to 40 percent, and the admin salary

During the build

  • Connected app installed, API access confirmed on the connection user
  • Three sync jobs running clean: User, Company, Company Person
  • CSV mapping complete for anything leaving your old CS platform
  • Health score model designed from scratch, not ported
  • Scores validated against accounts whose status you already know

Before cutover

  • Freeze window agreed and communicated
  • Final restorable export taken and opened
  • Rollback triggers written down, with a named decision-maker
  • Old system license held for 30 to 60 days
  • Day-one comms drafted

After go-live

  • Record counts reconciled against source
  • CSM adoption measured, not assumed
  • A date in the calendar to review whether the score is trusted

Do you need Gainsight, or just the signal?

We build GainTrace, so weigh this section accordingly. It is here because an honest migration guide has to ask the question, and because a fair number of Gainsight evaluations turn out not to be about Gainsight.

Gainsight is a platform. You are meant to run your entire post-sale operation inside it: health scoring, success plans, lifecycle orchestration, renewal forecasting, executive reporting. When that is genuinely the job, it is the deepest tool in the category and the rollout is the price of the depth. Teams who need it should buy it.

But many teams start this project with a narrower problem. They cannot see which accounts are slipping, early enough to act. That is a signal problem, not a platform problem, and solving it does not require rebuilding your scorecards, CTAs, playbooks, Journey Orchestrator programs and dashboards inside a new system first.

CONNECT GAINTRACEMIGRATE TO GAINSIGHT
What you doConnect your existing product, billing, support and CRM dataRebuild your health scores, CTAs, playbooks and dashboards in a new system
Time to liveAbout a weekAbout 5 months
Who runs itNo admin requiredA dedicated administrator
Cost$99 a month, or $990 billed annuallyAbout $49,879/yr median, plus 20 to 40 percent in year one
Best whenYou need early churn signalsYou run the whole operation in one system
GainTrace vs Gainsight comparison

If the real job is seeing risk before the renewal conversation rather than running your operation inside a suite, GainTrace flags at-risk accounts about 45 days out with the reason attached, because billing and support signals move before usage does. It connects to the systems you already run and goes live in about a week. There is a permanently free plan covering 25 companies with no credit card, so you can test the premise against your own accounts before committing to a five-month project.

And if you genuinely need the orchestration depth, buy Gainsight and run the migration properly. Everything above is how.

Moving the other way, off Gainsight rather than onto it? That decision has its own shape, and we cover it in switching to Planhat and in our guide to Gainsight alternatives.

Frequently asked questions

Can you import health scores into Gainsight?
You can import the numbers as data, through CSV into a custom object. You cannot import the model that produced them. Scorecards are configuration and must be rebuilt in Gainsight, which is the single most underestimated part of a switch.
Does Gainsight integrate with ChurnZero, Totango or Planhat?
No. Gainsight's published connectors cover CRM, support, product analytics and warehouses. There is no connector for any competing customer success platform, so data from one moves by CSV or S3 file ingestion.
How long does it take to switch to Gainsight?
Gainsight's own marketing cites 8 weeks for an end-to-end framework and about 4 months to a verified outcome. G2 reviewers report about 5 months to go live, within a reported range of 6 to 26 weeks. Teams migrating CS history by CSV, or without a dedicated admin, should plan for the back half of that range.
What data can you move into Gainsight?
Gainsight loads into five destinations: the User, Company, Person and Relationship objects, plus custom objects. Accounts, contacts, users and relationship structures move. Health score models, CTAs, playbooks, lifecycle automations, renewal forecasting and dashboards are configuration and are rebuilt.
Can a CSM run Gainsight without a dedicated administrator?
Reviews say no, consistently. Ease of Admin is Gainsight's lowest-scoring metric at 6.9 on G2, the lowest in its category, and reviewers repeatedly describe needing a dedicated owner to keep scorecards, rules and the Salesforce sync working. Budget it as a salary.