River
Y CombinatorBacked by Y Combinator

Free template

Customer Onboarding Plan Template

The plan you share with a new customer: success defined in their words, a timeline sized from your past onboardings, and sheets for milestones and adoption.

Free download · No account needed

What you get

Pack of 8 files: 4 documents, 4 spreadsheets

Customer Onboarding Plan Template
  • Readiness StandardDocument
  • Escalation PathDocument
  • Value DefinitionDocument
  • Onboarding PlanDocument
  • Readiness ReadSpreadsheet
  • Milestone TrackerSpreadsheet
  • Adoption by PersonSpreadsheet
  • Onboarding Cohort HistorySpreadsheet
RiverCustomer Onboarding Plan Template

Value Definition · Kelbrook Distribution · agreed at kickoff

“We know it's working when a depot manager publishes next week's rota on Thursday afternoon without ringing anyone.”

Their words, from the kickoff recording. Every clause below is load-bearing.

ClauseWhat it rules out
A depot managerNot their administrator, and not our implementation consultant
Without ringing anyoneNot a rota built in a training session, and not one that needed a call to head office
Thursday afternoonTheir operating cycle. Rotas go out Thursday so people know their week by Friday

Two events, two dates

Our activation event, first rota createdDay 4, by our consultant, in a sandbox
Their event, witnessed by D. FarrarDay 58, by S. Iqbal, unassisted
Their own deadline, peak season opensDay 62

Four days of slack. Measured from signature this reads as a four-day onboarding, which is a number nobody should say out loud. Measured against the date they published to their own customers, it is a plan that only just fitted.

Illustrative figures for one fictional workforce scheduling vendor and one of its customers.

Page 1 of 1182 words

How to create a customer onboarding plan

A customer onboarding plan is the shared schedule from kickoff to first value, the moment your product first does the job a new customer bought it for. A good one defines that moment in the customer's words and counts down to a date in their business. It sizes the timeline from facts you can check at kickoff and gives every milestone a named owner, yours or theirs.

Many templates run on your phases, your activation event and a clock starting at signature. Build this plan from the customer's side: the finish line, the deadline and many of the delays are theirs.

Four colleagues around a meeting room table, looking at a spreadsheet on a wall screen, with notebooks and a laptop open
Ask the readiness questions in the kickoff meeting, not in a form afterward. Photo: Beatriz Cattel on Unsplash

Define first value in their words

Lincoln Murphy, a customer success consultant, warns vendors not to confuse their definition of success with the customer's. His advice: if you don't know what success means to them, ask1. He suggests asking how they measure success and how their boss measures them.

Good answers describe a moment in someone's week, not a broad goal. Turn it into an event two people would agree happened, with a witness on their side, since usage data can't show whether anyone helped. Record your activation event, the product milestone you track, separately: your consultant can trigger it before the customer gets any value.

ExampleA value definition, clause by clauseAn illustrative example written for this guide. The distributor is made up.

Their words: “We know it's working when a depot manager publishes next week's schedule on Thursday afternoon without calling anyone.”

The event: a depot manager publishes a live schedule for a real week on a Thursday, unaided, confirmed by their administrator.

Our activation event: first schedule created, on day 4, by our consultant in a test account.

  • A depot manager. Not their administrator or your consultant.
  • Without calling anyone. Not one built in a training session.
  • Thursday afternoon. Their weekly cycle: staff learn their shifts by Friday.
  • Two dates. Yours came on day 4. Theirs came on day 58, four days before their deadline.

Find the date that matters to them

Signature and kickoff are your dates. Ask for theirs: a peak season, an audit, a store opening, the day their old contract ends. Some are fixed by law. A US federal agency's fiscal year ends on September 302, however late you kick off.

Then test it: ask what happens if it slips and whether they've told their own customers. A date their business runs on rarely moves. Count every milestone in days before that deadline, not days since signature.

If there's no date, write “none” rather than borrowing your quarter end. Without one, nothing in their business pushes their side along.

Ask the readiness questions at kickoff

Much of what decides the timeline sits on the customer's side, and you can learn it in week one. Ask out loud at kickoff: a form sent afterward gets “we'll assign an owner” instead of a name and a share of someone's week.

Eight questions for the kickoff

FactorAskA risky answer
DataHow many systems hold the data, and which is right?Three, and the real one is a spreadsheet
AdministratorWho runs it day to day, and for how much of their week?“We'll assign someone”
Security reviewWhere are you in your review of us?Not started
UsersDid the people who'll use it help choose it?No, head office bought it
IntegrationsWhich ones must work before it's useful?All four, from day one
DeadlineWhat date does this have to work by?“Sometime next quarter”
Old contractWhen does your current contract end?Renews soon, and no notice given
Data exportCan you export from the old system, in what format?“We've never tried”

Mark each factor clear, friction or blocker. A blocker stops other work, like a security review that must finish before you can set up their account. Friction only costs days, like data in three systems.

If their review hasn't started, send your security documents, such as a SOC 2 report, within days. The AICPA, which sets the standards for these reports, says they give customers the information needed to assess the risks of outsourcing3. A security questionnaire template helps with any questionnaire they send.

Size the onboarding plan from your history

Don't pick 30, 60 or 90 days because they're round. Bent Flyvbjerg, a project management researcher building on Daniel Kahneman's work, explains one big reason plans run late. People focus on the plan in front of them4 rather than on how similar work turned out. The cure he describes, reference class forecasting, predicts from what comparable past projects actually took.

  1. Start from a base

    Use your fastest recent onboarding of a similar-sized customer where every factor was clear.

  2. Add what each risk cost

    For each factor that isn't clear, add the median extra days it cost past customers in the same state.

  3. State the sample

    Note how many past onboardings each number rests on. Below three, call it a rough estimate.

  4. Explain any outlier you drop

    Exclude an unusual project only when its known cause won't recur here, and write the cause down.

How one plan's 59 days add up

ComponentDaysBasis
Base, a clean onboarding at this size21Fastest similar past onboarding
Security review not started+18Median of 5 past onboardings
Data in three or more systems+11Median of 4
Bought centrally, used in six depots+9Median of 6
Predicted length59Their deadline is 62 days away

Illustrative figures. Show customers these parts: 18 days are their own review, which they can speed up.

Build the milestones backward

Work back from their event and their date, the way Murphy suggests backing out from initial success1 to the milestones before it. Give each milestone a side (yours, theirs or both), a named person rather than a team, and a date.

Mark the critical path, the chain of tasks where any delay moves first value. It often runs through their work, so count their tasks out loud at kickoff: a plan showing only yours is a promise you can't keep alone.

Push anything they want but don't need for first value, such as extra integrations, past their date, and agree that in writing. If sales used a mutual action plan, carry its named contacts into this one.

Agree escalation while nobody is annoyed. UK government project guidance calls the agreed leeway tolerance5: how far work may drift from the plan before it goes up a level of management. Set yours now, with one contact per side at each level and triggers such as a critical-path task more than three working days late.

Count adoption by person, then close

First value from one person is only a start. List everyone meant to use the product, by name, and track each one:

  • Independent: has done the core task alone, more than once
  • Assisted: has done it, but only with help
  • Trained, not started: trained, but hasn't done it yet
  • Not started: has never logged in
  • Viewer: looks at reports, often the buyer; not adoption

Before offering more training, find out why someone never logged in: some were never invited, and some joined after the plan was written. If only one person can do the core task alone, train a second before widening the rollout, or one resignation takes the account back to zero.

When the witness confirms their event, add a row to your onboarding history: readiness at kickoff, predicted and actual days, and one sentence on what cost the time. Then carry the value definition forward as a goal to score at each quarterly business review.

Before you close the onboarding

  • Their witness confirmed the event, and you know how it landed against their deadline
  • At least two of their people can do the core task alone
  • Deferred items have an owner, a date and written agreement
  • Your history has a new row, with what cost the time

This template has a file for each step. With Edit with AI, River takes the readiness read from your kickoff notes and sizes the plan from your past onboardings.

How to use this template

Use the files as they are, or open them in River. River asks for the sales handoff, your kickoff notes, anything about the customer's own timing and a rough list of past onboardings. It takes the readiness read first, writes the value definition from the customer's own words, then sizes the plan against your most similar past customers.

It never invents a deadline the customer didn't give, never reports your activation event as first value, and labels any estimate with no comparable past onboarding as uncalibrated.

  1. Download it or open it in River

    Download the four Word documents and four CSV sheets free, or open them in River to plan with AI.

  2. Take the readiness read

    Ask the eight readiness questions at kickoff and fill in the Readiness Read, or send River your kickoff notes.

  3. Size the plan

    Add each factor's cost from your Onboarding Cohort History, then fill the Milestone Tracker backward from their date.

  4. Track adoption, then close

    Mark who can do the core task alone in Adoption by Person, and add a history row when you finish.

What's in the template

Fifty-nine days, and where every one of them came fromThe readiness read that derives the plan length from customer-side facts, the adoption sheet that counts humans rather than accounts, and the history the prediction is calibrated against.
Customer Onboarding Plan Template
RiverReadiness Read

Readiness Read

Eight customer-side facts, asked out loud in the kickoff session rather than sent as a form afterwards. Days come from Merrow's own history, not from judgement.

FactorTheir answerStateDaysBasis
Security reviewNot started. Infosec lead back 22 SeptemberBlocker+18median of 5
Where the data livesThree systems plus two spreadsheets, one of which is the real oneFriction+11median of 4
Users in the roomNo. Bought centrally, used in six depotsFriction+9median of 6
Named administratorD. Farrar, one day a weekClear0a person and an allocation
Integrations before valueOne, payroll. The other three are wanted, not neededClear0scoped down in week 1
Their own deadlinePeak season opens 3 November. Published to their customersClear0anchors the plan
Incumbent contractEnds 31 January, notice already servedClear0no dual running
Getting the data outCSV export tested on 200 records in week oneClear0two field mismatches found early

21 base, plus 18, 11 and 9. Fifty-nine days against sixty-two to their deadline. Three days of slack, known in week one rather than in week six, which is what moved the assurance package to day two and scoped three integrations out of the plan.

Every mitigation names the side that can act on it. Four of the eleven critical-path items are the customer's, including the two longest.

RiverAdoption by Person

Adoption by Person

One row per human being, not one row per account. Account-level activation reads this account as activated.

PersonRoleCore taskUnassistedTrainedState
D. FarrarOps AdministratorYes4YesIndependent
S. IqbalDepot Manager, NorthgateWith help1YesAssisted
P. NakamuraDepot Manager, RiversideNo0YesTrained not started
R. DelgadoDepot Manager, KingsmeadNo0YesTrained not started
L. OkaforDepot Manager, FairfieldNo0NoNot started
B. WhitcombeDepot Manager, EastwayNo0NoNever invited
T. AwuahDepot Manager, LynwoodNo0NoJoined in September
M. ColeOperations Directorn/a0n/aViewer

One of seven operational people can do the task alone, and she is allocated one day a week. This account is one resignation, one illness or one busy Tuesday from zero, and no account-level activation metric can see it.

Never logged in has three different causes here and two of them are the vendor's fault. B. Whitcombe was left off the invitation list and T. Awuah joined after the rollout plan was written. A third group training invitation solves neither.

RiverCohort History

Onboarding Cohort History

Every completed onboarding with its readiness profile, what was predicted, what happened, and one sentence on what actually cost the time.

CustomerSourcesReview at kickoffPredActualVarTheir dateWhat cost the time
Bexley Freight1Complete2421-3noneNothing. This is the base case
Ashgrove Group2Complete2926-3MetUsers were in the room and it shows
Halloway Rail3Not started5954-5MetReview cleared in 9 days because their deadline was real
Torrance Estates4Not started6166+5noneReview ran 31 days. No deadline meant no pressure to start
Pinevale Federal3In progress5258+6MetContracting officer changed. The statutory date never moved
Northmoor Facilities5Not started7491+17noneThree non-blocking integrations scoped as blocking

The same profile, nine days or thirty-one. Halloway and Torrance arrived identical on paper. The only difference was that Halloway had a real date published to their own customers, so their infosec lead cleared the review in nine days instead of thirty-one.

Kelbrook's comparables are Halloway, Torrance and Northmoor: 54, 66 and 91 days. Northmoor's cause is known and does not apply here, so the working range is 54 to 66 and the sheet says the sample is three.

  • Value DefinitionThe customer's own sentence about what working looks like, turned into an observable event with a named witness.
  • Readiness StandardThe eight readiness factors, how to ask about each one, how to score it and where its days come from.
  • Onboarding PlanThe length with its arithmetic shown, the comparable past onboardings, the critical path and what moves past their date.
  • Escalation PathOne named contact per side at three levels, the triggers for escalating, and what each escalation must say.
  • Readiness Read sheetEach factor's question, the customer's answer, its state, the days it adds, the mitigation and who owns it.
  • Milestone Tracker sheetEvery milestone with its side, named owner, planned date, status and days left before the customer's deadline.
  • Adoption by Person sheetOne row per person meant to use it, showing whether they can do the core task alone and what's next.
  • Onboarding Cohort History sheetEvery past onboarding with its readiness at kickoff, predicted and actual days, and what really cost the time.

Common questions

What should a customer onboarding plan include?

A customer onboarding plan should include the customer's own definition of first value and the date in their business it has to happen by. It also needs a timeline built from what you learned at kickoff, and milestones that each have a named owner on your side or theirs. Add an escalation path and a list of the people who will use the product.

How long should customer onboarding take?

There's no standard length, so base it on how long similar onboardings took in your own records. Start from your fastest clean onboarding at that size. Add the typical extra days for each risk you found at kickoff, such as a security review that hasn't started, then compare the total with the customer's deadline. Round figures like 30, 60 or 90 days are guesses.

What is time to first value?

Time to first value is how long a new customer takes to get the first real result from your product. Measure it to the event the customer described at kickoff, confirmed by someone on their side. Your own activation event is a poor stand-in, because it can happen in a training session long before they see any value.

What if we have no records of past onboardings?

Start with what you remember. List your last eight or so customers with how long each onboarding really took and what slowed it down. Rough numbers are enough to begin, as long as you label each estimate uncalibrated until at least three similar onboardings stand behind it. Add a row every time one finishes.

Should the customer see the onboarding plan?

Yes. Share it at kickoff, with the parts of the timeline visible rather than only the total. A customer who can see which days come from their own security review or scattered data can act on them. Their tasks belong in the plan too, each with a named person on their side.

Is this customer onboarding plan template free?

Yes. All eight files, four Word documents and four CSV sheets, download free without signing up. They come filled in with a made-up distributor's onboarding, so you can see how each one works before you clear it for your own customer. Edit with AI opens the same template in a free River workspace.

What does Edit with AI do?

It sets the template up in a free River workspace. River then asks for the sales handoff, your kickoff notes, any dates the customer mentioned and a rough list of past onboardings. It takes the readiness read, writes the value definition in the customer's words and sizes the plan from your history. It never invents a deadline.

Sources

  1. Sixteen Ventures. “The Secret to Successful Customer Onboarding.” sixteenventures.com (opens in a new tab)

  2. GovInfo. “31 U.S.C. § 1102: Fiscal year.” govinfo.gov (opens in a new tab)

  3. AICPA & CIMA. “System and Organization Controls: SOC Suite of Services.” aicpa-cima.com (opens in a new tab)

  4. arXiv. “From Nobel Prize to Project Management: Getting Risks Right.” arxiv.org (opens in a new tab)

  5. Government Project Delivery. “Glossary.” projectdelivery.gov.uk (opens in a new tab)

Written by

Chandler Supple

Co-founder & CEO, River

Chandler has spent the last six years working in AI, building tools for millions of users and Fortune 100 companies. In 2025, he co-founded River to build a new kind of operating system for AI agents.

Reviewed by

Brian Joseff, Co-founder, River