Skip to content

Group the API product switcher like the catalog page - #4488

Merged
reakaleek merged 3 commits into
mainfrom
api-switcher-dropdown-gro-eb14669e
Oct 16, 2026
Merged

reakaleek merged 3 commits into
mainfrom
api-switcher-dropdown-gro-eb14669e

Conversation

@reakaleek

@reakaleek reakaleek commented Oct 16, 2026 •

Copy link
Copy Markdown
Member

The API product menu now shows the same labelled groups as the catalog landing page, Elastic Stack and Orchestration, instead of one flat list.

Affects: API reference, Site UI

Prompt summary: Add grouping to the API switcher dropdown, similar to the grouping on the landing page, using common dropdown group patterns from Mobbin as the reference.

Why

The product menu lists every API in one run, so a reader cannot tell the core stack APIs from the Cloud ones. The landing page already separates them, and the two surfaces should read as one site.

What

Grouped menu

Each group gets a small muted uppercase label, and a thin divider separates groups. An API outside any group follows in an unlabelled group. A menu with only one group shows no label. The look follows the Snowflake account switcher pattern on Mobbin.

One source of grouping

The menu builds its groups from the same grouping the catalog page uses, so the two cannot drift. Inside a group the order is unchanged, so each Serverless API still sits right after its parent.

Verify

./build.sh unit-test
dotnet run --project src/tooling/docs-builder -- serve
# open /api/doc/elasticsearch/ and open the product menu in the context bar

Check on the preview

  • Elasticsearch API — open the product menu: group labels, dividers, selected row and the All APIs footer.
  • API catalog — control page: the groups the menu now matches.

🤖 Generated with Claude Code

The product menu listed every API in one flat run. It now shows the same
Elastic Stack and Orchestration bands as the catalog landing page, built
from the same grouping so the two cannot drift.

Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
@reakaleek
reakaleek requested a review from a team as a code owner October 16, 2026 11:01
@reakaleek
reakaleek requested a review from akira28 October 16, 2026 11:01
Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
@reakaleek

Copy link
Copy Markdown
Member Author

LGTM

image

Comment thread src/Elastic.Documentation.Site/Assets/api-context-bar.css Outdated
…w by @infra-vault-gh-plugin-prod)

Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
@github-actions

Copy link
Copy Markdown
Contributor

Docs preview (local build)

Handbook preview: https://docs-v3-preview.elastic.dev/elastic/docs-builder/pull/4488/

@reakaleek
reakaleek enabled auto-merge (squash) October 16, 2026 11:16
@reakaleek
reakaleek disabled auto-merge October 16, 2026 11:21
@reakaleek
reakaleek merged commit 5e6d8dc into main Oct 16, 2026
32 checks passed
@reakaleek
reakaleek deleted the api-switcher-dropdown-gro-eb14669e branch October 16, 2026 11:21
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants