跳到导航

Sticky breadcrumbs and non-clickable section breadcrumbs

Two new breadcrumb settings under layout.breadcrumbs in docs.yml:

  • sticky pins the breadcrumb row below the header while the page scrolls (Fern CLI 5.206.0 or later).
  • disable-non-page-ancestors renders sections, API References, and API packages without an overview page as non-clickable text instead of linking to their first page (Fern CLI 5.219.0 or later).
docs.yml
layout:
breadcrumbs:
sticky: true
disable-non-page-ancestors: true
Read the docs

You can now show your site’s most-searched queries when a reader opens the search box. Set popular-searches to true under settings.search in docs.yml, then publish with Fern CLI 5.218.1 or later. Only queries that return results for logged-out readers appear, so gated content isn’t suggested.

docs.yml
settings:
search:
popular-searches: true
Read the docs

More CSS selectors for API Reference pages

API Reference pages have new stable CSS selectors, so you can style more of the page with custom CSS:

  • Section headings, the endpoint URL and its path parameters, and the Try it button
  • Code snippet headers, the response status code selector, and error rows
  • Enum values, union variant selectors, and property rows (.fern-api-property and .fern-api-property-header)
  • Webhook, WebSocket, GraphQL, and gRPC sections

If your custom CSS already targets .fern-api-property or .fern-api-property-header for <ParamField>, those rules now also apply to API Reference property rows.

Read the docs

MCP sign-in on password, JWT, and OAuth sites

Readers can now sign in to your site’s MCP server from their MCP client through your site’s password, JWT, or OAuth login, instead of pasting a token. Signed-in clients get results for the pages the reader’s roles can access. Set mcp-auth to true under page-actions.options in docs.yml, then publish with Fern CLI 5.221.0 or later.

docs.yml
page-actions:
options:
mcp-auth: true
Read the docs

Scrolling header tabs

Header tabs that don’t fit in the header now scroll horizontally instead of overflowing. Scrollable edges fade out and show a chevron button that scrolls the row, and the active tab scrolls into view on page load. No configuration is needed.

Read the docs