<Subtitle /> <Description /> <Primary /> <Controls /> {visibleStories.length > 1 && <Stories />} </> ); }; export default { parameters: { docs: { page: CustomDocsPage, }, }, }; ``` Or with MDX, you can use `<Meta isTemplate />` and omit `<Stories />` if you only want the playground ([MDX docs](https://storybook.js.org/docs/writing-docs/mdx)). There’s no built-in config to auto-hide the duplicate, so customizing the template is the recommended workaround ([autodocs docs](https://storybook.js.org/docs/writing-docs/autodocs)). If you want to see if this changes in future releases, keep an eye on related issues and changelogs.  *To reply, just mention [@dosu](https://go.dosu.dev/dosubot).* --- <sup>How did I do? [Good](https://app.dosu.dev/response-feedback/47f74fc2-f658-43d3-b403-1ca61ad550c2?feedback_type=great_response) | [Irrelevant](https://app.dosu.dev/response-feedback/47f74fc2-f658-43d3-b403-1ca61ad550c2?feedback_type=irrelevant_answer) | [Incorrect](https://app.dosu.dev/response-feedback/47f74fc2-f658-43d3-b403-1ca61ad550c2?feedback_type=incorrect_sources) | [Verbose](https://app.dosu.dev/response-feedback/47f74fc2-f658-43d3-b403-1ca61ad550c2?feedback_type=too_verbose) | [Hallucination](https://app.dosu.dev/response-feedback/47f74fc2-f658-43d3-b403-1ca61ad550c2?feedback_type=hallucination) | [Report 🐛](https://app.dosu.dev/response-feedback/47f74fc2-f658-43d3-b403-1ca61ad550c2?feedback_type=bug_report) | [Other](https://app.dosu.dev/response-feedback/47f74fc2-f658-43d3-b403-1ca61ad550c2?feedback_type=other)</sup> [![Chat with Dosu](https://dosu.dev/dosu-chat-badge.svg)](https://app.dosu.dev/aeb86b10-c6fd-4458-9b50-3a72f4c7ee26/ask?utm_source=github) [![Open in Cursor](https://dosu.dev/dosu-in-cursor.svg)](https://cursor.com/link/prompt?text=This%20is%20a%20limitation%20of%20the%20default%20autodocs%20template%3A%20when%20you%20hide%20stories%20via%20tags%2C%20autodocs%20still%20counts%20all%20stories%20in%20the%20CSF%20file%2C%20so%20the%20Primary%20and%20Stories%20blocks%20both%20render%20the%20single%20visible%20story%2C%20causing%20duplication.%20The%20Stories%20block%20does%20have%20an%20%60includePrimary%60%20prop%20%28default%3A%20true%29%2C%20and%20if%20only%20one%20story%20is%20present%2C%20it%20should%20auto-suppress%20itself%E2%80%94but%20this%20only%20works%20if%20Storybook%20recognizes%20just%20one%20story%20after%20filtering%2C%20which%20isn%27t%20always%20the%20case%20with%20tags%20%28%5Bdocs%5D%28https%3A//storybook.js.org/docs/api/doc-blocks/doc-block-stories%29%29.%0A%0ATo%20avoid%20this%2C%20you%20can%20override%20the%20autodocs%20template%20using%20the%20%60docs.page%60%20parameter%20in%20%60.storybook/preview.js%7Cts%60%20or%20with%20an%20MDX%20template.%20In%20your%20custom%20template%2C%20you%20can%20conditionally%20render%20the%20Stories%20block%20only%20if%20more%20than%20one%20story%20is%20visible.%20Here%E2%80%99s%20a%20React%20example%20for%20%60.storybook/preview.ts%60%3A%0A%0A%60%60%60tsx%0Aimport%20%7B%20Title%2C%20Subtitle%2C%20Description%2C%20Primary%2C%20Controls%2C%20Stories%2C%20DocsContext%20%7D%20from%20%27%40storybook/blocks%27%3B%0Aimport%20React%2C%20%7B%20useContext%20%7D%20from%20%27react%27%3B%0A%0Aconst%20CustomDocsPage%20%3D%20%28%29%20%3D%3E%20%7B%0A%20%20const%20%7B%20componentStories%20%7D%20%3D%20useContext%28DocsContext%29%3B%0A%20%20const%20visibleStories%20%3D%20componentStories%28%29%3B%0A%20%20return%20%28%0A%20%20%20%20%3C%3E%0A%20%20%20%20%20%20%3CTitle%20/%3E%0A%20%20%20%20%20%20%3CSubtitle%20/%3E%0A%20%20%20%20%20%20%3CDescription%20/%3E%0A%20%20%20%20%20%20%3CPrimary%20/%3E%0A%20%20%20%20%20%20%3CControls%20/%3E%0A%20%20%20%20%20%20%7BvisibleStories.length%20%3E%201%20%26%26%20%3CStories%20/%3E%7D%0A%20%20%20%20%3C/%3E%0A%20%20%29%3B%0A%7D%3B%0A%0Aexport%20default%20%7B%0A%20%20parameters%3A%20%7B%0A%20%20%20%20docs%3A%20%7B%0A%20%20%20%20%20%20page%3A%20CustomDocsPage%2C%0A%20%20%20%20%7D%2C%0A%20%20%7D%2C%0A%7D%3B%0A%60%60%60%0A%0AOr%20with%20MDX%2C%20you%20can%20use%20%60%3CMeta%20isTemplate%20/%3E%60%20and%20omit%20%60%3CStories%20/%3E%60%20if%20you%20only%20want%20the%20playground%20%28%5BMDX%20docs%5D%28https%3A//storybook.js.org/docs/writing-docs/mdx%29%29.%0A%0AThere%E2%80%99s%20no%20built-in%20config%20to%20auto-hide%20the%20duplicate%2C%20so%20customizing%20the%20template%20is%20the%20recommended%20workaround%20%28%5Bautodocs%20docs%5D%28https%3A//storybook.js.org/docs/writing-docs/autodocs%29%29.%20If%20you%20want%20to%20see%20if%20this%20changes%20in%20future%20releases%2C%20keep%20an%20eye%20on%20related%20issues%20and%20changelogs.) [![Join Discord](https://img.shields.io/badge/join-5865F2?logo=discord&logoColor=white&label=)](https://go.dosu.dev/discord-bot) [![Share on X](https://img.shields.io/badge/X-share-black)](https://twitter.com/intent/tweet?text=%40dosu_ai%20helped%20me%20solve%20this%20issue!&url=https%3A//github.com/storybookjs/storybook/issues/33207)</article></body></html>

Hi @carlos22! I'm [Dosu](https://go.dosu.dev/dosubot) and I’m helping the storybook team. This is a limitation of the default autodocs template: when you hide stories via tags, autodocs still counts all stories in the CSF file, so the Primary and Stories blocks both render the single visible story, causing duplication. The Stories block does have an `includePrimary` prop (default: true), and if only one story is present, it should auto-suppress itself—but this only works if Storybook recognizes just one story after filtering, which isn't always the case with tags ([docs](https://storybook.js.org/docs/api/doc-blocks/doc-block-stories)). To avoid this, you can override the autodocs template using the `docs.page` parameter in `.storybook/preview.js|ts` or with an MDX template. In your custom template, you can conditionally render the Stories block only if more than one story is visible. Here’s a React example for `.storybook/preview.ts`: ```tsx import { Title, Subtitle, Description, Primary, Controls, Stories, DocsContext } from '@storybook/blocks'; import React, { useContext } from 'react'; const CustomDocsPage = () => { const { componentStories } = useContext(DocsContext); const visibleStories = componentStories(); return ( <> <Subtitle /> <Description /> <Primary /> <Controls /> {visibleStories.length > 1 && <Stories />} </> ); }; export default { parameters: { docs: { page: CustomDocsPage, }, }, }; ``` Or with MDX, you can use `<Meta isTemplate />` and omit `<Stories />` if you only want the playground ([MDX docs](https://storybook.js.org/docs/writing-docs/mdx)). There’s no built-in config to auto-hide the duplicate, so customizing the template is the recommended workaround ([autodocs docs](https://storybook.js.org/docs/writing-docs/autodocs)). If you want to see if this changes in future releases, keep an eye on related issues and changelogs.  *To reply, just mention [@dosu](https://go.dosu.dev/dosubot).* --- <sup>How did I do? [Good](https://app.dosu.dev/response-feedback/47f74fc2-f658-43d3-b403-1ca61ad550c2?feedback_type=great_response) | [Irrelevant](https://app.dosu.dev/response-feedback/47f74fc2-f658-43d3-b403-1ca61ad550c2?feedback_type=irrelevant_answer) | [Incorrect](https://app.dosu.dev/response-feedback/47f74fc2-f658-43d3-b403-1ca61ad550c2?feedback_type=incorrect_sources) | [Verbose](https://app.dosu.dev/response-feedback/47f74fc2-f658-43d3-b403-1ca61ad550c2?feedback_type=too_verbose) | [Hallucination](https://app.dosu.dev/response-feedback/47f74fc2-f658-43d3-b403-1ca61ad550c2?feedback_type=hallucination) | [Report 🐛](https://app.dosu.dev/response-feedback/47f74fc2-f658-43d3-b403-1ca61ad550c2?feedback_type=bug_report) | [Other](https://app.dosu.dev/response-feedback/47f74fc2-f658-43d3-b403-1ca61ad550c2?feedback_type=other)</sup> [![Chat with Dosu](https://dosu.dev/dosu-chat-badge.svg)](https://app.dosu.dev/aeb86b10-c6fd-4458-9b50-3a72f4c7ee26/ask?utm_source=github) [![Open in Cursor](https://dosu.dev/dosu-in-cursor.svg)](https://cursor.com/link/prompt?text=This%20is%20a%20limitation%20of%20the%20default%20autodocs%20template%3A%20when%20you%20hide%20stories%20via%20tags%2C%20autodocs%20still%20counts%20all%20stories%20in%20the%20CSF%20file%2C%20so%20the%20Primary%20and%20Stories%20blocks%20both%20render%20the%20single%20visible%20story%2C%20causing%20duplication.%20The%20Stories%20block%20does%20have%20an%20%60includePrimary%60%20prop%20%28default%3A%20true%29%2C%20and%20if%20only%20one%20story%20is%20present%2C%20it%20should%20auto-suppress%20itself%E2%80%94but%20this%20only%20works%20if%20Storybook%20recognizes%20just%20one%20story%20after%20filtering%2C%20which%20isn%27t%20always%20the%20case%20with%20tags%20%28%5Bdocs%5D%28https%3A//storybook.js.org/docs/api/doc-blocks/doc-block-stories%29%29.%0A%0ATo%20avoid%20this%2C%20you%20can%20override%20the%20autodocs%20template%20using%20the%20%60docs.page%60%20parameter%20in%20%60.storybook/preview.js%7Cts%60%20or%20with%20an%20MDX%20template.%20In%20your%20custom%20template%2C%20you%20can%20conditionally%20render%20the%20Stories%20block%20only%20if%20more%20than%20one%20story%20is%20visible.%20Here%E2%80%99s%20a%20React%20example%20for%20%60.storybook/preview.ts%60%3A%0A%0A%60%60%60tsx%0Aimport%20%7B%20Title%2C%20Subtitle%2C%20Description%2C%20Primary%2C%20Controls%2C%20Stories%2C%20DocsContext%20%7D%20from%20%27%40storybook/blocks%27%3B%0Aimport%20React%2C%20%7B%20useContext%20%7D%20from%20%27react%27%3B%0A%0Aconst%20CustomDocsPage%20%3D%20%28%29%20%3D%3E%20%7B%0A%20%20const%20%7B%20componentStories%20%7D%20%3D%20useContext%28DocsContext%29%3B%0A%20%20const%20visibleStories%20%3D%20componentStories%28%29%3B%0A%20%20return%20%28%0A%20%20%20%20%3C%3E%0A%20%20%20%20%20%20%3CTitle%20/%3E%0A%20%20%20%20%20%20%3CSubtitle%20/%3E%0A%20%20%20%20%20%20%3CDescription%20/%3E%0A%20%20%20%20%20%20%3CPrimary%20/%3E%0A%20%20%20%20%20%20%3CControls%20/%3E%0A%20%20%20%20%20%20%7BvisibleStories.length%20%3E%201%20%26%26%20%3CStories%20/%3E%7D%0A%20%20%20%20%3C/%3E%0A%20%20%29%3B%0A%7D%3B%0A%0Aexport%20default%20%7B%0A%20%20parameters%3A%20%7B%0A%20%20%20%20docs%3A%20%7B%0A%20%20%20%20%20%20page%3A%20CustomDocsPage%2C%0A%20%20%20%20%7D%2C%0A%20%20%7D%2C%0A%7D%3B%0A%60%60%60%0A%0AOr%20with%20MDX%2C%20you%20can%20use%20%60%3CMeta%20isTemplate%20/%3E%60%20and%20omit%20%60%3CStories%20/%3E%60%20if%20you%20only%20want%20the%20playground%20%28%5BMDX%20docs%5D%28https%3A//storybook.js.org/docs/writing-docs/mdx%29%29.%0A%0AThere%E2%80%99s%20no%20built-in%20config%20to%20auto-hide%20the%20duplicate%2C%20so%20customizing%20the%20template%20is%20the%20recommended%20workaround%20%28%5Bautodocs%20docs%5D%28https%3A//storybook.js.org/docs/writing-docs/autodocs%29%29.%20If%20you%20want%20to%20see%20if%20this%20changes%20in%20future%20releases%2C%20keep%20an%20eye%20on%20related%20issues%20and%20changelogs.) [![Join Discord](https://img.shields.io/badge/join-5865F2?logo=discord&logoColor=white&label=)](https://go.dosu.dev/discord-bot) [![Share on X](https://img.shields.io/badge/X-share-black)](https://twitter.com/intent/tweet?text=%40dosu_ai%20helped%20me%20solve%20this%20issue!&url=https%3A//github.com/storybookjs/storybook/issues/33207)</article></body></html>

[Bug]: autodocs pages that only contain a single story (hidden via tags) show the same story twice #33207

Company

Community

Support

Connect