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 styling information. This enhancement helps users understand how to effectively use tags to highlight new, beta, deprecated, and other important content in their documentation navigation.

Files changed

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

Note

Adds a comprehensive "Tags and labels" section to organize/navigation.mdx describing how to use the tag field on navigation groups.

  • Provides examples for groups, nested groups, and usage within tabs and anchors via CodeGroup and AccordionGroup
  • Includes common tag use cases (e.g., NEW, BETA, DEPRECATED), best practices, and a warning that tags are visual-only
  • Documents styling behavior (theme-inherited colors, dark mode) and adds corresponding screenshots

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

Co-Authored-By: mintlify[bot] <109931778+mintlify[bot]@users.noreply.github.com>
- Tags have rounded corners and padding for visual separation
- Dark mode automatically adjusts tag colors for readability

You cannot customize individual tag colors directly. Tags use your theme's primary color defined in the `colors` field of your `docs.json`.
Copy link
Contributor

Choose a reason for hiding this comment

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

This reads like per-tag styling is impossible; you can’t do it via docs.json, but you can override tag styling with custom CSS.

Suggested change
You cannot customize individual tag colors directly. Tags use your theme's primary color defined in the `colors` field of your `docs.json`.
You can't customize individual tag colors via `docs.json`. Tags use your theme's primary color defined in the `colors` field of your `docs.json`, but you can override tag styling with custom CSS.


<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.

Heads up: images/navigation/tags-light.png (and the dark variant below) don’t exist in this PR/repo right now, so these will render as broken images. If the screenshot is intended, consider adding the assets (or swapping to an existing navigation screenshot).

@ethanpalm ethanpalm closed this Jan 27, 2026
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