Docs
← Back to site

The Product Switcher

2 min readUpdated November 21, 2026

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.

The Choose a product window, with products grouped under their group names.

Mobile#

The mobile menu, with the Product switcher above the docs navigation.

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?

This website uses cookies to enhance your browsing experience and ensure the site functions properly. By continuing to use this site, you acknowledge and accept our use of cookies.

Accept All Accept Required Only