Worked Example: Throughout this guide, we’ll follow TeamFlow, a collaborative project management tool. TeamFlow has discovered that the first 30 days determine everything—customers who reach their “aha moment” become long-term retained customers, while those who never quite get started churn at renewal.
Why onboarding matters
The onboarding truth
Here’s what the data consistently shows across B2B SaaS:
The pattern is stark: customers who experience value quickly almost always stay. Customers who don’t almost always leave.
The silent failure problem
The challenge with onboarding failure is that it’s invisible:- Customers don’t complain—they just stop logging in
- They don’t ask for help—they assume the product isn’t for them
- They don’t cancel immediately—they drift until renewal and then churn
The intervention window
A customer stuck on Day 3 is still open to help. A customer who’s been stuck for 3 months has already checked out mentally.
Step 1: Define your onboarding stage
What you’re configuring
The onboarding stage parameters define when customers enter onboarding, how long they have to complete it, and what success looks like.How to think about onboarding boundaries
Entry considerations:- When does the customer first have access to your product?
- Do they need prerequisites before real onboarding begins?
- Is there a “Day 0” setup phase that should be tracked separately?
- How long does it typically take successful customers to onboard?
- How long are you willing to actively nurture before considering them stalled?
- When do diminishing returns kick in?
- What specific milestone(s) indicate successful onboarding?
- When should you stop trying and either escalate or accept failure?
Example configuration
- TeamFlow's Decision
- Configuration
TeamFlow analysed their customer data and found clear patterns:
- Successful customers typically completed onboarding in 7-14 days
- Customers who took >30 days had 3x higher churn
- After Day 30, additional onboarding effort showed minimal retention impact
Step 2: Define your onboarding objectives
Objective design principles
The best onboarding objectives are:Finding your “aha moment”
One objective should be your critical “aha moment”—the single milestone most predictive of long-term retention. To identify your “aha moment”:- Look at retained customers: What did they all do early on?
- Look at churned customers: What did they fail to do?
- Find the behaviour with the biggest retention gap between doers and non-doers
Example: TeamFlow’s onboarding objectives
Step 3: Configure onboarding interventions
Intervention design principles
- Specificity: One intervention per objective (don’t bundle)
- Timing: Intervene soon after the target date passes
- Helpfulness: Focus on unblocking them, not guilting them
- Urgency calibration: Earlier objectives warrant faster intervention
- Escalation path: Plan for what happens if intervention doesn’t work
Example intervention design
Intervention 1: No Login (Day 1 target missed)
Intervention 1: No Login (Day 1 target missed)
Problem: Customer signed up but never logged inUrgency: High (they may have already forgotten about us)Timing: 24 hours after signup if no loginGoal: Get them to log in and start exploring
Intervention 2: No Project (Day 3 target missed)
Intervention 2: No Project (Day 3 target missed)
Problem: Customer logged in but didn’t create a projectUrgency: Medium-high (they’re exploring but not committing)Timing: Day 4 if no project createdGoal: Help them create their first project
Intervention 3: No Tasks (Day 7 target missed)
Intervention 3: No Tasks (Day 7 target missed)
Problem: Customer created a project but it’s emptyUrgency: Medium (they started but got stuck)Timing: Day 8 if fewer than 5 tasksGoal: Help them add real work to their project
Intervention 4: No Teammate (Day 14 target missed) ⭐ PRIORITY
Intervention 4: No Teammate (Day 14 target missed) ⭐ PRIORITY
Problem: Customer is working alone—hasn’t invited anyoneUrgency: Highest (this is the aha moment!)Timing: Day 10 (early intervention—don’t wait until Day 15)Goal: Make inviting a teammate feel easy and valuable
Intervention 5: No Team Activity (Day 21 target missed)
Intervention 5: No Team Activity (Day 21 target missed)
Problem: Teammate was invited but isn’t engagingUrgency: Medium (teammate may need their own nudge)Timing: Day 22 if teammate hasn’t taken actionGoal: Get the invited teammate to participate
Step 4: Write your intervention messages
Message philosophy
Onboarding messages should feel like a helpful friend, not a marketing automation.Message structure
Effective onboarding messages follow a simple structure:- Acknowledge where they are (not accusatory)
- Explain the benefit of the next step (not the feature)
- Make the action extremely easy (direct link, clear CTA)
- Offer help if they’re stuck (open the door)
Example messages
- No Login
- No Project
- No Teammate ⭐
Step 5: Configure sender identity
Options
Step 6: Set message timing
Timing principles
Step 7: Configure follow-up logic
Follow-up design
Not every customer will respond to the first message. You need a plan for:- Persistence: Some customers need multiple touches
- Escalation: When to involve humans
- Exit: When to stop trying (to avoid annoying customers)
Example: “No teammate” follow-up sequence
Follow-up message example
Step 8: Configure internal notifications
Tiered notification system
Sample high-value alert
Step 9: Define success metrics
Metrics to track
Setting benchmarks
For your first month, focus on establishing baselines:- What % complete each objective without intervention?
- What % complete after intervention?
- How does timing affect completion?
Summary checklist
Onboarding stage defined with entry/exit criteria
4 to 7 objectives identified with clear completion criteria
”Aha moment” objective identified
Intervention triggers configured for each objective
Plain text messages written for each intervention
Follow-up sequences designed
Internal escalation paths configured
Success metrics defined
Next steps
Configure Adoption Jobs
Build sticky habits after customers complete onboarding
Building Jobs Guide
Detailed guide on job configuration