Support for Global Tabs That Preserve Page Outline

[IAm2XTr33M]

Feature Request: Support for Global Tabs That Preserve Page Outline ("What's on this Page")

Hi Mintlify team,

I'd like to request support for a global tab component that can toggle entire-page content (e.g., different platforms or environments) without breaking the “What’s on this page” sidebar.

---

Current Limitation

When I structure content like this:

<tabs>
  <Tab title="Platform A">
    ## Section A1
    ## Section A2
  </Tab>
  <Tab title="Platform B">
    ## Section B1
    ## Section B2
  </Tab>
</tabs>

The ## headings inside the <Tab> components do not appear in the right-side "On This Page" outline, which makes navigation difficult on long pages.

---

What I’d Like Instead

A way to structure pages like this:

<globalTabs>
  <Tab title="Platform A">
    ## Setup
    Content for Platform A

    ## Usage
    Content for Platform A
  </Tab>
  <Tab title="Platform B">
    ## Setup
    Content for Platform B

    ## Usage
    Content for Platform B
  </Tab>
</globalTabs>

And have ## Setup, ## Usage, etc., still appear in the sidebar, depending on the selected tab — or even better, grouped under the selected tab label.

---

Bonus Features (Nice to Have)

• Sync tab selection across the entire page (like a global context toggle)
• Automatically collapse/expand sidebar sections based on the selected tab

---

This would improve UX for documentation with multiple platforms, frameworks, or environments. Thanks for considering this feature request.

[dino475]

Hey there,
Have you checked out our global object?
I think it could be exactly what you're looking for!