Search boost

Bias your in-product documentation search ranking toward specific pages or sections using the boost multiplier in frontmatter or in docs.json navigation.

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.

boost only affects the search bar on your Mintlify-hosted documentation site. It does not change how external search engines index your pages.

Boost a single page

Set boost in a page’s frontmatter to multiply its search ranking.

---
title: "Custom domain"
description: "Connect your custom domain to your Mintlify documentation."
boost: 3
---

Boost a navigation group

Set boost on a group in your docs.json navigation to apply the multiplier to every page under it.

{
  "navigation": {
    "groups": [
      {
        "group": "Get started",
        "boost": 5,
        "pages": [
          "quickstart",
          "concepts"
        ]
      }
    ]
  }
}

A page inherits the boost factor from its nearest ancestor that sets one. A child page or nested group can override the inherited boost by setting its own boost value. A page’s frontmatter boost always wins over a value inherited from the navigation.

De-prioritize content

Use a value below 1 to push pages further down in search results. For example, boost: 0.5 halves a page’s relevance score relative to other pages. A boost of 1 is equivalent to no boost.

---
title: "Deprecated API"
description: "Documentation for the deprecated v1 API."
boost: 0.25
---

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.

Adjust the number of search results

By default, the search bar on your documentation site returns up to 6 results per query. To return more (or fewer) results, change the Maximum search results setting in your dashboard.

1. Go to Project Settings → Search in your dashboard.
2. Use the stepper to pick a value between 1 and 100.
3. Select Save changes.

The new limit applies to every search request from your documentation site. Returning more results increases the chance that the right page is visible, but very large values can make the search panel harder to scan.

You need the deployment.update permission to change this setting. The setting is not available on Atlas (self-hosted) deployments.