Skip to content

Add tags and labels documentation#3852

Open
mintlify[bot] wants to merge 1 commit intomainfrom
mintlify/add-tags-labels-metadata-docs-76812
Open

Add tags and labels documentation#3852
mintlify[bot] wants to merge 1 commit intomainfrom
mintlify/add-tags-labels-metadata-docs-76812

Conversation

@mintlify
Copy link
Contributor

@mintlify mintlify bot commented Feb 27, 2026

Added a comprehensive "Tags and Labels" section to the Pages documentation explaining how to use tags in Mintlify. The new section clarifies tag vs label terminology, demonstrates usage in both page frontmatter and navigation groups, provides common use cases, and explains custom metadata properties with a comparison of page-level vs global metadata approaches.

Files changed

  • organize/pages.mdx - Added new "Tags and Labels" section with subsections covering tag usage, common patterns, custom metadata, and page-level vs global metadata comparison

Note

Low Risk
Documentation-only change in organize/pages.mdx with no impact to runtime behavior.

Overview
Adds a new "Tags and labels" section to organize/pages.mdx documenting how to use the tag field in page frontmatter and docs.json navigation groups, including where tags surface (sidebar/search) and recommended conventions.

Expands guidance on organization by describing custom frontmatter metadata and clarifying when to use page-level frontmatter vs global docs.json metadata, with examples and a comparison table.

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

Co-Authored-By: mintlify[bot] <109931778+mintlify[bot]@users.noreply.github.com>
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