Docs articles can now have subpages: child articles nested one level under a top-level article. Use subpages to break a long topic into smaller pages without adding more top-level clutter to your docs sidebar.
This feature is rolling out gradually and may not be available in your workspace yet.
Hover over any top-level article in the docs sidebar and click the + button that appears next to it. This creates a new blank subpage nested under that article and opens it for editing.
A few rules:
Only a top-level article can have subpages. A subpage cannot have subpages of its own.
A subpage always belongs to the same group as its parent article.
A subpage has its own title, summary, icon, content, and publish state, just like any other article.
In the editor, the parent article's header shows a breadcrumb with the group name, a chevron, and the parent article's title once you're viewing a subpage. Click the parent's title in the breadcrumb to jump back up to it.
Published subpages also appear as a row of cards under the parent article's summary, both in the editor preview and on your public docs site. Each card shows the subpage's icon, title, and summary, and links straight to that subpage.
On your public docs site, a subpage's own breadcrumb reads group, then parent article, then the subpage itself, so readers always know which article a subpage belongs to.
A subpage has its own Draft/Published state, shown with the same pill used for top-level articles. Publish or unpublish it from the card menu on the parent article, or from the subpage's own editor.
Deleting a parent article deletes all of its subpages with it. Deleting a single subpage only removes that subpage.
