/onboarding-cro

name: onboarding-cro
description: >
  Improve user onboarding flows to increase activation and retention. Use when
  asked to design welcome screens, setup wizards, product tours, onboarding
  checklists, or activation sequences. Trigger phrases: "onboarding flow",
  "user activation", "welcome screen", "product tour", "onboarding checklist",
  "first-run experience", "setup wizard", "aha moment", "time to value",
  "user onboarding", "activation rate".

Onboarding CRO

Design and optimize user onboarding flows that drive activation and long-term retention.

---

1. Onboarding Frameworks

Jobs-To-Be-Done (JTBD) Onboarding

The best onboarding flows are organized around the user's job, not the product's features.

**Process:** 1. Identify the user's primary job-to-be-done 2. Map the minimum steps to complete that job in your product 3. Guide the user through those steps, removing all distractions 4. Celebrate completion (aha moment)

**Example (Notion):**

• Job: "I need to organize my team's projects"
• Steps: Create workspace > Invite team > Create first page > Use a template
• The onboarding flow guides exactly this path, nothing more

**Anti-pattern:** Feature tours that show every feature. Users do not care about features during onboarding; they care about solving their problem.

Progressive Disclosure

Reveal functionality gradually as users demonstrate readiness.

**Levels:** 1. **First session:** Only show core functionality needed for primary job 2. **After first success:** Introduce secondary features that enhance the core workflow 3. **After repeated use:** Surface power features, integrations, customization 4. **After mastery:** Invite to advanced features, API, automation

**Implementation:**

• Use feature flags or user state to control what's visible
• Track user actions to determine when to advance disclosure level
• Never show everything at once

Activation Metrics

Define your activation metric before designing onboarding. The activation metric is the action most correlated with long-term retention.

**Examples:**

| Product | Activation Metric | Timeframe | |---------|------------------|-----------| | Slack | Send 2,000 messages (team) | First 30 days | | Dropbox | Upload 1 file from 2 devices | First 7 days | | Facebook | Add 7 friends | First 10 days | | Zoom | Host first meeting | First 7 days | | Notion | Create 3 pages | First 7 days | | Figma | Create first design | First 3 days | | HubSpot | Import contacts + send first email | First 14 days |

**How to find your activation metric:** 1. Cohort analysis: Compare retained vs churned users 2. Identify actions that retained users took that churned users did not 3. Find the action with strongest correlation to 30-day retention 4. Validate by testing whether guiding users to that action improves retention

Aha Moment Identification

The aha moment is when a user first experiences the core value of your product.

**Framework for identifying it:** 1. What do users say when they recommend your product? ("It's amazing because...") 2. When during their journey do users typically say "wow" or "this is cool"? 3. What single action separates users who stay from those who leave?

**The aha moment is NOT:**

• Signing up
• Completing onboarding
• Seeing a feature demo

**The aha moment IS:**

• Getting their first result
• Experiencing time saved
• Seeing their data visualized for the first time
• Completing their first task successfully

---

2. Onboarding Components

Welcome Screens

The first screen after signup. Serves two purposes: make the user feel welcomed and collect information for personalization.

**Best Practices:**

• Use the user's name ("Welcome, Sarah!")
• Keep it to 1-3 questions maximum
• Use visual selectors (cards with icons) instead of dropdowns
• Every question should directly affect their experience
• Always allow skipping

**Template:**

Welcome to [Product], [Name]!

Let's personalize your experience.

What's your primary goal?
[ ] [Goal 1 -- with icon]
[ ] [Goal 2 -- with icon]
[ ] [Goal 3 -- with icon]
[ ] Something else

[Continue]  [Skip for now]

**Example (Notion):**

What will you use Notion for?
[Personal] [Team] [School]

How big is your team?
[Just me] [2-10] [11-50] [50+]

Setup Wizards

Guided multi-step flows that set up the product for use.

**When to use:** When the product requires configuration before it can deliver value (CRM, analytics, marketing automation).

**Best Practices:**

• Maximum 3-5 steps
• Show progress indicator
• Pre-fill defaults where possible
• Allow skipping non-essential steps
• Provide "try it with sample data" option
• End with a clear next action, not a blank screen

**Template:**

Step 1: Connect your [data source]
  [Connect Google] [Connect manually] [Use sample data]

Step 2: Configure your [workspace/project]
  [Pre-filled sensible defaults with edit option]

Step 3: Invite your team (optional)
  [Email input] [Copy invite link] [Skip]

You're all set!
  [Go to your dashboard]

Product Tours

Interactive walkthroughs of the product interface.

**Types:** 1. **Tooltip tour:** Highlights UI elements with explanatory tooltips (Intercom, Appcues) 2. **Video walkthrough:** Short video showing key workflows 3. **Interactive tutorial:** User performs real actions with guidance 4. **Sandbox mode:** Pre-populated environment for safe exploration

**Best Practices:**

• Keep tours under 5 steps (3 is ideal)
• Focus on ONE workflow per tour
• Let users exit at any point
• Make the user DO something, not just read
• Trigger contextually (first time visiting a feature), not globally
• Never replay completed tours unless user requests it

**Anti-patterns:**

• 15-step tours that show every button
• Forced tours that cannot be dismissed
• Tours that explain obvious UI elements
• Tours that trigger repeatedly

**Template (per step):**

Step [X] of [Y]:

[Pointer to UI element]

"[Action verb] here to [achieve resu