Skip to content

Conversation

@mintlify
Copy link
Contributor

@mintlify mintlify bot commented Jan 27, 2026

Added detailed documentation for navigation tags and labels, including usage examples, best practices, and implementation across different navigation contexts. This enhancement provides users with clear guidance on how to effectively use tags to highlight new, beta, deprecated, and updated content in their documentation navigation.

Files changed

  • organize/navigation.mdx - Added new "Tags and labels" section with examples and best practices

Note

Adds a new Tags and labels section to organize/navigation.mdx explaining how to use the tag field in navigation groups.

  • Shows examples for groups (including nested groups) and usage within tabs, anchors, dropdowns, and products
  • Provides tag best practices (e.g., NEW, BETA, DEPRECATED, UPDATED, PREVIEW) and truncation note
  • Includes light/dark screenshots and clarifies styling/appearance behavior (auto theme-aware)

Written by Cursor Bugbot for commit 813ae61. This will update automatically on new commits. Configure here.

Co-Authored-By: mintlify[bot] <109931778+mintlify[bot]@users.noreply.github.com>

<img
className="block dark:hidden pointer-events-none"
src="/images/navigation/tags-light.png"
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Looks like these screenshots aren’t included in this PR—can you add /images/navigation/tags-light.png and /images/navigation/tags-dark.png (or update the paths) so the page doesn’t render broken images?

- **UPDATED**: Draw attention to recently refreshed documentation
- **PREVIEW**: Identify early-access features or experimental functionality

Keep tag text short and clear. Tags with more than 12 characters may be truncated in the sidebar.
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Not sure the 12-character truncation limit is stable across themes; keeping this generic might age better.

Suggested change
Keep tag text short and clear. Tags with more than 12 characters may be truncated in the sidebar.
Keep tag text short and clear. Longer tags may be truncated in the sidebar.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant