Linear onboarding

A fast issue tracker and project planning tool for software teams.

Linear

An eight-step onboarding that teaches the keyboard

Linear walks new users through the command menu, teams, GitHub, invites and updates in short dark screens, then drops them into the app with contextual tips.

B2BonboardingactivationreferralJan 2025

01

Meet the command menu

Step 3 of 8 asks you to press Cmd+K instead of just describing it.

Linear: Meet the command menu
  1. 1

    Benefit in one line (working)

    "Complete any action in seconds" sells the shortcut before teaching it.

    Reciprocity

  2. 2

    Try it now (working)

    Big keycaps invite you to press the shortcut, so you learn by doing.

    Show, don't tell

  3. 3

    Continue looks like text (not working)

    The only way forward has no button styling, so it is easy to miss.

    Affordance

  4. 4

    Short, visible flow (working)

    Eight dots tell you how long setup will take.

    Goal-gradient effect

02

Join or create a team

Existing teams in your company are listed with members, so joining is one click.

Linear: Join or create a team
  1. 5

    Your company by name (working)

    "Join or create a team at Metabase" shows the workspace was matched to your domain.

    Personalization

  2. 6

    Join first, create second (working)

    The default tab is joining existing teams, which avoids duplicates.

    Default effect

  3. 7

    Already added to Engineering (working)

    A check and "Leave" show you were placed in the biggest team for you.

    Default effect

  4. 8

    Faces and member counts (working)

    Avatars and "33 members" show where your colleagues already are.

    Social proof

  5. 9

    One clear primary action (working)

    A single filled Continue button ends the step.

    Clarity

03

Linear workflow with GitHub

The GitHub step explains the branch-to-PR loop and pre-fills status automation.

Linear: Linear workflow with GitHub
  1. 10

    Shortcut in context (working)

    "Copy branch name with Cmd Shift ." teaches the habit that starts the loop.

    Habit formation

  2. 11

    What happens automatically (working)

    Three checks spell out the links and status changes Linear will make.

    Expectation setting

  3. 12

    Pre-filled status rules (working)

    Each PR event already maps to In Progress, In Review or Done, so nothing needs configuring.

    Default effect

  4. 13

    No connect button (not working)

    The only action is Continue, so it is unclear whether GitHub is connected or just explained.

    Clarity

04

Invite co-workers

Inviting is framed as how Linear is meant to be used, with an optional team picker.

Linear: Invite co-workers
  1. 14

    Reason to invite (working)

    "Linear is meant to be used with your team" explains why before asking.

    Reason-giving

  2. 15

    Paste many emails (working)

    One field takes a comma-separated list, so bulk invites take seconds.

    Reduce friction

  3. 16

    Team is optional (working)

    "(optional)" removes a decision that could block the invite.

    Reduce friction

  4. 17

    Two ways out (not working)

    "Continue" and "I'll do this later" both skip, and it is unclear how they differ.

    Choice overload

05

Subscribe to updates

Step 7 asks for a changelog opt-in and an X follow.

Linear: Subscribe to updates
  1. 18

    Why subscribe (working)

    "Linear is constantly evolving" gives a reason to stay in touch.

    Reason-giving

  2. 19

    Opt-in, not pre-checked (working)

    The changelog toggle starts off and says how often you'll get it: bi-weekly.

    Informed consent

  3. 20

    Low-commitment channel (working)

    Following @linear on X is offered for people who don't want email.

    Flexibility and efficiency of use

  4. 21

    Marketing step in setup (not working)

    A newsletter ask at step 7 of 8 adds length without helping you get started.

    Reduce friction

06

You're good to go

The last screen names the first action and lists three things to do next.

Linear: You're good to go
  1. 22

    First action named (working)

    "Create your first issue by pressing C" ends onboarding with one concrete step.

    Clear call to action

  2. 23

    Domain sign-in (working)

    "Anyone with an @metabase.com email can now sign in" tells you the team can join without invites.

    Network effects

  3. 24

    Integration as a tip (not working)

    "Integrate GitHub & Slack" has no button, so it reads as advice rather than an action.

    Affordance

  4. 25

    One more shortcut (working)

    "Learn the keyboard commands by pressing ?" keeps the keyboard-first teaching going.

    Habit formation

  5. 26

    Open Linear (working)

    A single primary button closes the flow.

    Clarity

07

Active issues tip

Inside the app, opening a view for the first time shows a short explainer.

Linear: Active issues tip
  1. 27

    Tab you just opened (working)

    The tip appears when you open "Active", so it explains the view in front of you.

    Contextual help

  2. 28

    Visual for the concept (working)

    Status icons and a title show what "Active issues" means at a glance.

    Show, don't tell

  3. 29

    Copy contradicts the list (not working)

    It says "there are currently no active issues" while 39 Up Next issues sit behind it.

    Consistency and standards

  4. 30

    Dismiss or go deeper (working)

    "Got it" and "Documentation" let you close the tip or read more.

    Progressive disclosure

Takeaways from Linear

  1. Teach the one habit that makes your product fast (Linear's keyboard) by asking users to do it during onboarding.
  2. Default new users into the team where their colleagues already are, and show faces to prove it.
  3. Keep contextual tips in sync with real data, or they undermine trust.