How to turn off the onboarding guide?

[kleinfreund]

Summary

How do I turn off the onboarding guide?

I'm referring to item in the settings/cog menu labelled "Onboarding guide" which shows a completion percentage indicator next to it.

I don't want to see it and I don't want it present for anyone else on my team as it's distracting, especially as there's a green orb on top of the gear icon suggesting there's something to take action on which there isn't.

There's seemingly no way to turn if off via configuration and, additionally, the steps in it can't be skipped completely. Neither is there a skip all or ignore button nor can all steps be skipped. Some steps seem to require a previous step to be completed and not skipped to become skippable.

Additional information

No response

Create a reproduction

No response

[dosubot[bot]]

There are a few separate pieces to the onboarding system, each controlled differently:

Sidebar checklist widget (the one with the green orb on the gear icon): You can disable it by setting this in your .storybook/main.js (or .storybook/main.ts):

export default {
  // ...
  features: {
    sidebarOnboardingChecklist: false,
  },
};

This flag was introduced in PR #33430 and should remove the checklist widget and the green notification indicator from the sidebar.

Interactive onboarding wizard (the step-by-step guided flow): This comes from @storybook/addon-onboarding. You can remove it with:

npx storybook@latest remove @storybook/addon-onboarding

"Guide" tab in settings: This is part of Storybook core and only renders in development mode [1]. Unfortunately, there is currently no configuration option to hide it [2]. It's independent of both the addon and the feature flag above.

---

So for your use case, setting features.sidebarOnboardingChecklist: false and removing @storybook/addon-onboarding should eliminate the green orb and the interactive steps. The Guide tab in settings will still be present in dev mode, but there's no way to disable that today.

Could you confirm which version of Storybook you're on? The feature flag has had compatibility issues in some older releases [3], so version info would help if the flag doesn't take effect for you.

To reply, just mention @dosu.

---

Docs are dead. Just use Dosu.

[kleinfreund]

• features.sidebarOnboardingChecklist is already false but the green orb is still there
• the onboarding addon isn't (and wasn't) even installed
• I'm on the most recent version of storybook

[dosubot[bot]]

The green orb on the gear icon is actually not related to the onboarding checklist or the onboarding addon — it's tied to the "What's New" notification system [1]. That's why features.sidebarOnboardingChecklist: false doesn't affect it.

To permanently disable the green dot, add this to your .storybook/main.js (or .storybook/main.ts) [2]:

export default {
  // ...
  core: {
    disableWhatsNewNotifications: true,
  },
};

Alternatively, you can click into Settings → What's New and toggle "Hide notifications" from the UI [3] — though the config approach ensures it's off for your whole team.

That said, if there's also a separate "Onboarding guide" item in the settings menu that bothers you (the Guide tab with the progress percentage), that's a core dev-mode feature with no configuration option to disable it today [4]. If that's the main issue, it might be worth filing a feature request specifically for a flag to hide the Guide tab.

To reply, just mention @dosu.

---

Share context across your team and agents. Try Dosu.

[fisherbyu]

Is there plans to remove the"Guide" tab?