1. Settings
  2. Product Sections

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.

The Cloud product selector open with Cloud and SDK choices

Cloud and SDK are separate product sections, selected from one dropdown.

​
Example configuration

Create the referenced pages, then merge these navigation entries into your root layout.json:

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.