Sticky breadcrumbs and non-clickable section breadcrumbs
Two new breadcrumb settings under layout.breadcrumbs in docs.yml:
stickypins the breadcrumb row below the header while the page scrolls (Fern CLI 5.206.0 or later).disable-non-page-ancestorsrenders 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).
Popular searches
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.
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-propertyand.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.
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.
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.