The Product Switcher
The product switcher lets readers jump between products without going back to the docs index. It only appears when there’s something to switch between.
When it shows#
The switcher appears only when both of these are true:
- You have more than one product
- Single-product mode is off (see Single-Product vs. Multi-Product Mode)
If either isn’t true, there’s nothing to switch between, so the switcher is hidden entirely rather than showing with one option.
Desktop#
A button in the topbar shows the current product’s name with a chevron. Clicking it opens a modal with a card for every product: its image (if set) and name. Clicking a card takes the reader to that product’s page.

Mobile#

In the mobile navigation drawer, the same switcher appears as a “Product” section near the top, showing the current product’s image and name. Tapping it opens the same modal used on desktop.
Accessibility#
The modal is keyboard accessible: pressing Escape closes it, and focus moves to the first product card when it opens and returns to whatever you clicked to open it when it closes.
What it doesn’t do#
The product switcher only switches products. It doesn’t preserve your place within a doc, category, or version, since a different product has an entirely different set of docs. Switching products always lands the reader on that product’s page (/docs/{product}/), not on an equivalent doc in the new product.
This is a separate feature from the version switcher, which lets readers move between versions within the same product. See The Version Picker & Cookie Persistence for that.
Was this helpful?
Thanks for your feedback!
✓ Feedback received. Thank you!