- Settings
- Product Sections
Settings
Product Sections
Organize multiple products in one documentation site with a product dropdown.
Use a dropdown to switch between product areas such as Cloud and SDK.
Each area has a distinct route prefix and its own sidebar groups. This uses
navigation.dropdowns; there is no separate products setting in this configuration.
Example configuration
Create the referenced pages, then merge these navigation entries into your root
layout.json:
{
"navigation": {
"dropdowns": [
{ "dropdown": "Cloud", "href": "cloud", "icon": "cloud" },
{ "dropdown": "SDK", "href": "sdk", "icon": "code" }
],
"groups": [
{ "group": "Cloud", "pages": ["cloud/index", "cloud/deploy"] },
{ "group": "SDK", "pages": ["sdk/index", "sdk/install"] }
]
}
}
Selecting Cloud enters the cloud section and shows its matching pages. Selecting
SDK switches to the sdk section. Keep an index or clear first page for each area.
Choose the right control
- Use dropdowns for a compact product or section switcher.
- Use site tabs when the main areas should remain visible in the header.
- Use languages for translations of those areas, not for unrelated products.
- Use content tabs for alternatives within a single page.
Product sections organize navigation; they do not create separate workspaces, billing plans or access permissions. Use distinct documentation sets when those boundaries need to be separate.
