Skip to content

Document section-level search boost#5563

Open
mintlify[bot] wants to merge 1 commit intomainfrom
mintlify/search-boost-1777350840
Open

Document section-level search boost#5563
mintlify[bot] wants to merge 1 commit intomainfrom
mintlify/search-boost-1777350840

Conversation

@mintlify
Copy link
Copy Markdown
Contributor

@mintlify mintlify Bot commented Apr 28, 2026

Summary

Documents the new boost field for navigation groups and page frontmatter, which biases search ranking for specific sections of a docs site.

The triggering PR added boost (a numeric multiplier) to navigation groups in docs.json and to page frontmatter. Pages inherit the closest ancestor group's boost factor; entries with a resolved factor of 1 are treated as no boost. Server-side indexers use the resolved boost as a per-chunk weight at index time.

Changes

  • organize/navigation.mdx — New "Search ranking boost" subsection under Groups explaining the multiplier semantics, inheritance, and override behavior, with a docs.json example that boosts a "Get started" group and deprioritizes a "Legacy" group, plus a frontmatter snippet showing per-page override.
  • organize/pages.mdx — New boost ResponseField in the page metadata list, linking back to the navigation reference for full details.

Validation

  • mint broken-links: no broken links.
  • mint validate: pre-existing errors only (unrelated language config and redirects issues already present on main).

Note

Low Risk
Documentation-only changes that describe the new boost metadata; no runtime behavior or security-sensitive logic is modified.

Overview
Adds documentation for a new search ranking multiplier called boost.

Updates organize/navigation.mdx with a Search ranking boost section describing group-level boost, inheritance/override behavior, and a docs.json example, and updates organize/pages.mdx to document the page frontmatter boost field with a link back to the navigation section.

Reviewed by Cursor Bugbot for commit 0efde9c. Bugbot is set up for automated code reviews on this repo. Configure here.

Generated-By: mintlify-agent
@mintlify
Copy link
Copy Markdown
Contributor Author

mintlify Bot commented Apr 28, 2026

Preview deployment for your docs. Learn more about Mintlify Previews.

Project Status Preview Updated (UTC)
mintlify 🟢 Ready View Preview Apr 28, 2026, 4:38 AM

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.

0 participants