All specs
uxmedium complexity

Onboarding & Activation

Used in 9 specs

Guide new users from sign-up to their first meaningful outcome — the moments that determine whether they ever come back.

Options

Onboarding Format*

No dedicated onboarding UI — every empty screen contains a clear primary action pointing to the next step.
A dismissible checklist ("Invite teammate • Create project • Connect integration") visible until complete.
Step-through overlays point at UI elements on first use.
User cannot access the product until they complete N configuration screens.

Personalization Signals

Ask one or two questions to route the user to a tailored first experience.
Present starter templates ('Blank', 'Team docs', 'Marketing site') as the first interaction.
Every new workspace starts with an example project the user can play with.

Activation Support

Email nudges when a user signed up but has not yet hit the key activation action (e.g. created their first project).
A persistent help button that opens relevant docs or a short walkthrough based on the current page.
Intercom-style chat surface active for new users in their first few days.

Decision Points

Do you know what the "aha moment" / activation event is for your product?

If yes

Design onboarding backwards from that event. Every step should reduce friction to it.

If no

Fix this before investing in onboarding UI. Instrument product events and find activation empirically.

Is the first use of your product collaborative (requires inviting a teammate)?

If yes

Surface the invite action prominently in empty states or checklist; single-user usage is often not the activated state.

If no

Optimize for a single-user first success.

Is your product self-serve, or sales-led / waitlisted?

If yes

Optimize every step for a frictionless signup: single-field email, magic link, and empty-state-driven first action.

If no

Replace signup with a waitlist form + personal outreach; add a wizard (domain verification, SSO) post-sales.

Is email verification strictly required before first use?

If yes

Send magic link or OTP, but let the user explore read-only state while waiting. Blocking on verification is a major conversion leak.

If no

Skip upfront verification — prompt later when the user takes an action that actually needs a verified email.

Would a 1-2 question questionnaire meaningfully personalize the first experience?

If yes

Ask role/use-case upfront and route to a tailored template or empty state. Cap at 2 questions — each additional one costs conversion.

If no

Skip the questionnaire; ship the same empty state to everyone and let them self-select via templates.

Does your product suffer from the blank-page problem (hard to see value empty)?

If yes

Pre-populate a labeled, deletable sample workspace. Essential for analytics, dashboards, and issue trackers.

If no

An empty-state prompt to "Create your first X" is cleaner and avoids clutter.

Is team invites in the first session a leading indicator of activation?

If yes

Surface the invite step inside the checklist during onboarding — not after. A team workspace that stays single-user usually churns.

If no

Move invites out of onboarding — prompt only when the user takes a collaborative action.

Does the product only deliver value once external data is connected (integrations, imports)?

If yes

Make the connect-data step the checklist centerpiece. Offer sample data as a fallback so users can explore before committing.

If no

Skip data connection in onboarding — offer it contextually when the user takes an action that needs it.

Is your product complex enough that new users will miss key capabilities without guidance?

If yes

Add a short guided tour (under 5 steps) with a clear skip control. Never block the UI behind the tour.

If no

Skip the tour — empty-state prompts and in-app help cover it without the friction.

Does your product surface more features as users mature (advanced settings, integrations)?

If yes

Progressively disclose — hide admin/API/settings until they are needed. Surface them via contextual prompts when the user is ready.

If no

Show the full surface from day one; simpler mental model.

Do different user roles (admin, member, viewer) need materially different first experiences?

If yes

Branch onboarding on role — admins get setup checklist (billing, SSO, invites); members land directly in the workspace.

If no

One flow for all users is simpler and easier to iterate on.

Can your empty states double as the onboarding surface?

If yes

Invest in empty-state-driven onboarding first. Every empty screen should show the next primary action, not marketing copy.

If no

Supplement with a checklist — but fix the empty states first; they will carry users further than any tour.

Have you defined and instrumented a product activation metric (time-to-value)?

If yes

Track it in your analytics and optimize onboarding against it. Every step should either reduce TTV or get cut.

If no

Instrument this before building onboarding UI — without a metric you are guessing.

Do a meaningful fraction of signups drop off before activation?

If yes

Enable behavior-triggered activation emails. A nudge at day 1 and day 3 recovers 5–15% of dropped signups.

If no

Skip — nudges on already-activated users feel spammy.

Do you have the analytics maturity and signup volume to A/B test onboarding variants?

If yes

Use an experimentation framework (Statsig, LaunchDarkly, GrowthBook) and test one variable at a time.

If no

Iterate with qualitative feedback first — A/B tests need thousands of signups per week to reach significance.

Does your product require payment or a card before the user sees value?

If yes

Only if you can justify it (enterprise, physical goods). For SaaS, defer card collection until after the user reaches their aha moment.

If no

Keep payment setup out of onboarding — gate it on usage or trial expiry.

Do enterprise customers need to complete setup steps (domain verification, SSO, SCIM) before go-live?

If yes

Build a separate admin wizard post-signup for these. Keep end-user onboarding lightweight; admin work should not block the team.

If no

Skip the enterprise wizard entirely until you have paying enterprise customers requesting it.

Tradeoffs

UXSetup wizard as format

Controls first-experience but introduces sign-up drop-off proportional to wizard length

ComplexityActivation emails enabled

Requires event tracking + scheduled jobs + segmentation infrastructure

CostLive chat during onboarding

Staffing cost scales with signup volume — not viable for self-serve products below a certain ACV

Dependencies

user-system

Implementation Examples

Appcues / Pendo

No-code tour and checklist tooling — the default for non-engineering teams to build onboarding.

Linear onboarding

Reference for checklist-driven onboarding that feels product-native rather than bolted-on.

UserGuiding / Intro.js

Open-source and commercial tools for building guided tours without building the framework yourself.

Used by specs

Slack-like Messaging AppCRM PlatformE-commerce StorefrontProject Management ToolSaaS StarterMarketplace PlatformSocial / Community AppAI-Powered SaaSNote-taking / Knowledge Base