Document the search boost feature#5562
Merged
skeptrunedev merged 3 commits intomainfrom Apr 28, 2026
Merged
Conversation
Add an optimize/search-boost page explaining how to bias in-product search ranking by setting a numeric boost multiplier in page frontmatter or on a docs.json navigation group, including inheritance rules and de-prioritization with sub-1 values. Cross-reference from the boost frontmatter ResponseField in organize/pages and add the new page to the Optimize navigation group.
Contributor
|
Preview deployment for your docs. Learn more about Mintlify Previews.
|
Add a navigation.groups[].boost subsection under navigation.groups in the docs.json schema reference page, with a link out to the topic page.
Bias in-product search ranking toward onboarding content and away from the changelog. Doubles as a live test of the search boost feature.
ethanpalm
approved these changes
Apr 28, 2026
| keywords: ["search ranking", "search boost", "boost", "search prioritization"] | ||
| --- | ||
|
|
||
| Use `boost` to bias the in-product search ranking of specific pages or sections. The value is a numeric multiplier applied to each chunk's relevance score: `boost: 3` makes a chunk three times as relevant as it would be without a boost. |
Collaborator
There was a problem hiding this comment.
Suggested change
| Use `boost` to bias the in-product search ranking of specific pages or sections. The value is a numeric multiplier applied to each chunk's relevance score: `boost: 3` makes a chunk three times as relevant as it would be without a boost. | |
| Use `boost` to bias the in-product search ranking of specific pages or sections. The value is a numeric multiplier applied to each chunk's relevance score. For example, `boost: 3` makes a chunk three times as relevant as it would be without a boost. |
Comment on lines
+58
to
+60
| <Note> | ||
| Boost factors compose with the existing relevance score. Use them sparingly. Large multipliers can cause less-relevant pages to dominate search results and degrade overall search quality. | ||
| </Note> |
Collaborator
There was a problem hiding this comment.
Suggested change
| <Note> | |
| Boost factors compose with the existing relevance score. Use them sparingly. Large multipliers can cause less-relevant pages to dominate search results and degrade overall search quality. | |
| </Note> | |
| <Tip> | |
| Boost factors compose with the existing relevance score. Use them sparingly. Large multipliers can cause less-relevant pages to dominate search results and degrade overall search quality. | |
| </Tip> |
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
2 participants
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
optimize/search-boost.mdxpage covering: howboostworks as a numeric multiplier on in-product search ranking, frontmatter usage on a single page, group-level usage indocs.jsonnavigation (with inheritance and override rules), and de-prioritization via sub-1 valuesboost<ResponseField>toorganize/pages.mdxnext tonoindex, with a link to the new pageoptimize/search-boostin the Optimize navigation group ofdocs.jsonThe boost feature shipped in mintlify/server#4740 and mintlify/mint#7238. This PR is the user-facing documentation.
Test plan
mint broken-linkscleanmint devrenders the new page and the updated frontmatter ResponseField correctlyvale optimize/search-boost.mdx organize/pages.mdxcleanNote
Low Risk
Low risk documentation-only change; the only behavioral impact is docs-site navigation ordering/search weighting examples in
docs.json.Overview
Adds new documentation for Search boost (
optimize/search-boost.mdx), explainingboostas a multiplier for in-product search ranking, including page-frontmatter anddocs.jsongroup usage with inheritance/override rules.Updates existing references to surface the new option: introduces a
boostfrontmatter field inorganize/pages.mdx, documentsnavigation.groups[].boostinorganize/settings-reference.mdx, and registersoptimize/search-boostin the Optimize navigation; also adds sampleboostvalues to theGet startedgroup andChangelogtab indocs.json.Reviewed by Cursor Bugbot for commit 383a1a4. Bugbot is set up for automated code reviews on this repo. Configure here.