Changelog

Docs sites without a site-wide og:image or twitter:image now get a generated preview image per page, replacing blank link placeholders in Slack, X, and LinkedIn; pages with their own og:image in frontmatter keep it. Set og:dynamic: false under metadata in docs.yml to opt out.

Visitors can drag the standalone AskAiChat widget anywhere on the page by its header, or drag the launcher button and the card follows, staying inside the viewport with the card opening above or below the launcher based on available room. Dragging is on by default in @fern-api/search-widget 0.6.0; pass draggableCard={false} to keep the chat pinned to its placement corner.

A new sort-by-availability option orders endpoints in the API Reference by their availability, listing provided values first and remaining values in default order, with unset positioning endpoints that have no availability. It can be combined with alphabetized: true to sort alphabetically within each availability.

Passing lang=php to /llms.txt and per-page .md or .mdx URLs now returns only PHP SDK code examples. A new excludeChangelog=true parameter omits changelog sections from llms.txt, and nonexistent .md requests return up to five similar-page suggestions instead of three.

An api navigation item can now point at OpenAPI, AsyncAPI, or GraphQL specification files with a specs list, without creating a generators.yml. Each entry takes a type and a path relative to the configuration file, plus optional overrides, overlays, and namespace, and existing api-name setups are unchanged.

Set ai-search.disclaimer in docs.yml to replace the default Ask Fern disclaimer text, which appears beneath answers in the chat panel, standalone modal, mobile drawer, and search widget.

Playground-only authentication descriptions

Custom search metadata for faceting

Fern Agent automations

Card images in Fern Editor

You can now configure a Card's image title, link, source, position, and badge directly in Fern Editor. Repo-relative image paths resolve in the Editor, and the preview matches the published Card component.

GraphQL schemas split across multiple files

Fern Agent

Local library docs generation from git inputs

WebSocket channels defined in an AsyncAPI specification can now hide the API Explorer Playground by setting x-fern-explorer: false at the document root, with per-channel overrides using x-fern-explorer: true.

Standalone Ask AI sidebar panel

Scroll-synced code walkthroughs

Readable API Reference Markdown for agents

Build a docs version from a git ref

Send defaults for optional parameters in the API Explorer

Organization-wide CLI version policy