Your onboarding is a pile of ad-hoc calls, and every account gets a different version. Most frameworks make that worse, because they hand you virtues instead of stages: be scalable, find the aha moment. A customer onboarding framework is a set of named stages that carry a new customer from signed contract to repeated value. Each stage has an entry criterion, an exit criterion, an owner and a metric.

That definition earns its keep on the Tuesday your customer’s admin stops replying. It tells you whether the account advances or stays put. Below: four stages, one table, and the failure branch for each.

SECTION 01

Framework, process, or checklist: three different things

Customer onboarding framework contains the process, which contains the checklist, shown as nested layers

Three words describe three different layers. Teams swap them freely, and the mix-up costs real money.

A framework is the set of stages plus the criteria that move an account between them. That is this article. A customer onboarding framework answers one question: is this account on track?

A process is the sequence of steps inside a stage. Who sends what, in what order, by when.

A checklist is the task list inside a step. Our new customer onboarding checklist is that layer, and the client onboarding checklist is the agency version.

Now the expensive part. Teams adopt a checklist, call it a framework, and then cannot answer the only question that matters. A checklist can sit at 90% complete while the customer has seen zero value. Ticked boxes measure your effort. They say nothing about the customer’s progress.

So use this test. A customer onboarding framework tells you whether to move an account forward. A checklist only tells you what your team has done.

SECTION 02

The Signed, Activated, Adopted, Advocate loop

Signed, Activated, Adopted, Advocate loop with the feedback arrow from advocate back to signed

Our customer onboarding framework has four stages, and one arrow running back from Advocate to Signed.

The arrow is the point. Reference calls, case studies, referrals and expansion all originate in stage 4, and that is the cheapest pipeline a SaaS company has. A framework that ends at go-live throws it away. Then the same company buys ads to replace pipeline it already owned.

One rule governs the whole loop. An account advances only when the exit criterion is true, never because the calendar says so. Time-based progression is why your dashboard says "onboarded" while nobody logs in.

This article stays on the customer onboarding framework itself. The strategy that sits around it, including the build queue and the 90-day rollout, lives in our product adoption strategy guide.

A customer moving through a structured onboarding path
SECTION 03

The stage table (the part you can put on a wall)

The table below is an entire customer onboarding framework on one screen. Read the exit column first.

StageEntry criterionExit criterionOwnerPrimary metricRequired content
SignedCountersigned contractKickoff held, mutual success plan agreedOnboarding leadDays from signature to kickoffKickoff deck, success plan template, welcome email
ActivatedAccess and setup complete enough for one real workflowCustomer completes the target workflow unaided, on their own dataOnboarding lead, with product supportTime to first value from signatureRole-based path: admin setup and end-user workflow
AdoptedFirst value reached and repeated by the original userWorkflow runs weekly across more than one person, second use case startedCustomer successDistinct users completing the core action per account per weekSelf-serve library plus a rollout kit the champion forwards
AdvocateDocumented result the customer attributes to the productResult lives somewhere reusable, and the account expanded, renewed or referredCustomer success with marketingShare of accounts with a documented outcome inside 6 monthsStory capture, advanced or certification content

Fill this in for your own product before you read further. Copy the table, change nothing but the exit column, then argue about the wording until one sentence per stage survives. The stage names matter far less than the exit criteria. Your customer onboarding framework is only ever as good as that column, because the criteria are what your team applies under pressure.

SECTION 04

Stage 1: Signed

Entry: a countersigned contract, plus the deal context handed over from sales. Your customer should never repeat their goals to a new face. When they do, they learn you were not listening.

Exit: kickoff held. Mutual success plan agreed in the customer’s own words. First-value milestone named and dated. Stakeholder map complete, covering the economic buyer, the champion, the admin and the end users.

Owner: the onboarding lead. Below roughly 20 new accounts a month, that person is you.

Metric: median days from signature to kickoff. Set the target from your own last ten successful onboardings, then segment it by customer size. Enterprise usually needs a separate target because security and procurement sit in the path.

Content required: kickoff deck, success plan template, welcome email. Structured intake earns its place here too, because a client onboarding questionnaire collects once what four calls otherwise collect twice.

What breaks it: the buyer is not the user. In B2B the person who signed may never log in. If you agree the success plan with the buyer alone, stage 2 has nobody to activate. Fix it inside the kickoff itself. Name the end-user cohort in the plan, then book calendar time with those people before the call ends.

You have this stage covered when a stranger can read the success plan and name who does what, by when.

SECTION 05

Stage 2: Activated

Entry: access granted, and setup complete enough to run one real workflow on real data.

Exit: the customer completes the target workflow themselves, on their own data, and gets the promised outcome once. Not a demo. Not a sandbox. Not your CSM sharing a screen and doing it for them.

Owner: the onboarding lead, with product support for anything needing a config change.

Metric: time to first value, counted from signature. Counting from first login flatters the number and hides the two weeks you lost to provisioning.

Content required: the role-based training path. Admin setup content and end-user workflow content are different assets, so build them separately. Short procedural video carries UI sequences better than text, which is why customer onboarding videos belong inside this stage rather than after it.

What breaks it: the demo trap. Teams count a walkthrough call as activation, then wonder why usage flatlines in week three. Publish this rule to your team: if your CSM’s hands were on the keyboard, the account is not activated.

Stalling here carries a price. OnRamp surveyed 161 customer success and onboarding leaders and found that 48% of customers abandon onboarding when value arrives slowly. Abandonment rarely announces itself, though. Usually it just looks like a rescheduled call.

You have this stage covered when you can name the event that fires in your product the moment a customer reaches first value.

SECTION 06

Stage 3: Adopted

Entry: first value reached, then repeated at least once by the same user without help.

Exit: the workflow runs weekly across more than one person, a second use case has started, and usage no longer depends on the champion.

Owner: customer success.

Metric: distinct users completing the core action per account per week. Raw logins measure curiosity, while depth measures habit. Our guide to customer education KPIs holds the definitions and formulas.

Content required: a self-serve library, plus a rollout kit your champion forwards internally without you in the room. Your customer has to onboard their own colleagues at this point. Almost no vendor hands them anything to do it with, so the rollout dies quietly at the champion’s desk. A customer training plan is where you specify that kit.

What breaks it: single-champion dependency. The signal is precise. After 60 days, usage still concentrates in one user ID. The fix is an asset the champion sends, rather than another live session you run.

This is where our thesis lands. If CS explains the same workflow more than three times, that explanation belongs in structured content. Price it in hours, never in vague efficiency. Count the live teaching hours one account consumes, then multiply by new accounts per quarter. That number is what a single asset gives back, and whoever approves your budget can convert hours to money without help.

You have this stage covered when the account survives a full month with no contact from your team.

SECTION 07

Stage 4: Advocate

Entry: the customer holds a documented result they attribute to your product.

Exit: that result lives somewhere reusable, such as a reference call, a case study, a QBR slide or a review. The account has also expanded, renewed or referred.

Owner: customer success, with marketing. Two names on the stage, or nothing happens.

Metric: share of accounts producing a documented outcome inside six months. Track revenue retention on that cohort beside it, since advocacy without expansion is just a nice quote.

Content required: a story capture process, plus advanced or certification content that gives power users a reason to go deeper. Power users who run out of things to learn stop advocating and become quiet renewals. Examples of what that content looks like sit in our portfolio.

What breaks it: nobody owns it. Advocacy is the stage most companies leave to whoever happens to remember. Assign it, or your customer onboarding framework quietly becomes a funnel again and you pay for pipeline instead.

You have this stage covered when a customer has said something on the record that you did not draft for them.

SECTION 08

Where the customer onboarding framework meets reality: four failure branches

Four failure branches hanging off the onboarding loop with the recovery move for each

Every customer onboarding framework survives the happy path. These four branches are where real accounts leave it, so decide your recovery move before you need it.

The champion leaves

Trigger: a bounced email, or a role change on LinkedIn.

Diagnosis: your relationship lived with a person rather than an account, so it left when they did.

Recovery: the stakeholder map from stage 1 is the only reason you have a second name to call. Restart at Signed with the successor. Run a short kickoff, agree the success plan again, and stop reporting the account as Adopted until the new person clears stage 2.

The customer goes quiet during setup

Trigger: no reply for five working days at stage 2.

Diagnosis: priorities moved, or the admin hit a wall they feel embarrassed about.

Recovery: escalate to the economic buyer with the success plan attached. Send the milestone and the date both sides agreed, never another "just checking in" note. Our client onboarding email templates cover the exact wording.

IT or security blocks the integration

Trigger: setup stalls on a review your team cannot influence.

Diagnosis: activation has become hostage to procurement.

Recovery: define a partial-value path that skips the integration. A manual import, a smaller data set, one team instead of the whole company. The customer then reaches a result while the review runs, and your loop keeps moving.

The dashboard says onboarded, but nobody uses it

Trigger: a stage advanced on a date rather than an exit criterion.

Diagnosis: somebody optimized the report instead of the account.

Recovery: re-audit against exit criteria, then move the account back a stage. Say this out loud to your team: moving an account backwards is a healthy signal, not an admission of failure. A customer onboarding framework that only moves forward is a reporting tool, not a management tool.

SECTION 09

How to install this customer onboarding framework in 90 minutes

Installing a customer onboarding framework takes one session, not a quarter. Block 90 minutes and run these two passes.

First pass, about 45 minutes.

  1. List your last 10 accounts.
  2. Place each one in a stage using exit criteria only, ignoring what the CRM claims.
  3. Count how many sit in the same stage.
  4. Look at the content that exists for that stage.

The stage where accounts pile up is almost always the stage with the weakest content, not the weakest process. Teams reach for another tool or another call. But those accounts stall because nobody has written down the thing a CSM explains by voice every week.

Second pass, about 45 minutes. Write the exit criterion for each stage in one sentence. Get CS and sales to agree the wording in the same room, and settle disagreements with a real account rather than a hypothetical one. Only then automate anything, because automated client onboarding built on vague criteria automates the vagueness.

Then instrument five events, so your customer onboarding framework stays measurable rather than aspirational. Signature date, kickoff held, first-value event, weekly active users per account, documented outcome. If an engineer quotes a week of work, it is the cheapest week you will buy this quarter.

Self-serve products apply the same criteria per user instead of per account, and our user onboarding checklist covers that version.

SECTION 10

What this customer onboarding framework does not do

Most articles on this topic never admit a limit. Here are ours.

It does not replace a project plan for complex implementations. A multi-month deployment with data migration still needs one underneath stage 2. The customer onboarding framework tells you which stage an account is in, while the plan tells you which week.

It does not fit compliance-driven onboarding. KYC, identity verification and regulated account opening run on legal exit criteria that a customer education loop has no business rewriting.

It does not fix a product with no repeatable value moment. If nobody in your company can name the workflow that proves the product works, you have no exit criterion to write for stage 2. Fix that first, then come back.

And it creates nothing on its own. Stages tell you where accounts stop. The content and the owners are what get them moving, which is the subject of how to increase product adoption.

SECTION 11

FAQ

What is a customer onboarding framework?

A customer onboarding framework is a set of named stages a new customer moves through, from signed contract to repeated value. Each stage carries an entry criterion, an exit criterion, one owner and one metric. Unlike a checklist, it tells you whether an account is on track rather than what your team has done.

What are the stages of customer onboarding?

Four stages: Signed, Activated, Adopted, Advocate. Signed ends at an agreed success plan. Activated ends when the customer completes the target workflow unaided. Adopted ends when that workflow runs weekly across more than one person. Advocate ends with a documented result plus an expansion, a renewal or a referral. Then the loop restarts, because advocates create your next signed accounts.

How is an onboarding framework different from an onboarding process?

A customer onboarding framework names the stages and the criteria between them. The process is the sequence of steps inside a stage: who sends what, in what order, by when. You need both. A process without a framework produces busy teams and stalled accounts, since nothing defines done.

How long should each onboarding stage take?

Any number quoted without integration depth and committee size is marketing. So measure your own. Take the last 40 accounts, record the days each spent per stage, then treat the median as reality and the 25th percentile as your target. Duration stays a diagnostic here. It never becomes a reason to advance an account.

Who owns the customer onboarding framework, CS or product?

One named person owns the outcome, normally the Head of Customer Success. Product owns the events that prove each exit criterion, and whoever owns education owns the content each stage requires. Below roughly 20 new accounts a month, the founder still owns it personally. Our customer onboarding best practices guide covers the wider operating rhythm around that split.

SECTION 12

Find the stage where teaching still happens live

Your customer onboarding framework will stall in exactly one place. It is usually the stage where your most expensive person still teaches by voice, on a call, one account at a time. Our Customer Adoption Pilot finds that stage, then rebuilds its content so the next 20 accounts clear it without a call.

Plan a customer adoption pilot