For AI agents: a documentation index is available at the root level at /llms.txt and /llms-full.txt. Append /llms.txt to any URL for a page-level index, or .md for the markdown version of any page.
Book a demoLog inStart for free
  • Getting started
    • Overview
    • How it works
    • Quickstart
    • Project structure
    • Customer showcase
    • Changelog
  • Configuration
    • Overview
    • Site-level settings
    • Page-level settings
  • Writing content
    • Markdown basics
    • Rich media in Markdown
    • Fern Editor
    • Reusable snippets
  • AI features
    • Overview
    • Fern Writer
    • AI-generated examples
    • Markdown access
      • Overview
      • Customize LLM output
      • Agent directives
      • Analytics and integration
    • MCP server
    • API catalog discovery
  • Public API
    • GETJWT from Fern API key
    • GETAlgolia search credentials
    • GETCurrent user information
  • Fern Writer API
    • GETGet Fern Writer Install Link
Checking status...
SOC2Soc 2 Type II
© 2026 Fern • Birch Solutions, Inc., a Postman company

Documentation

SDKsDocsAsk FernCLI Reference

API Definitions

OpenAPIAsyncAPIOpenRPCgRPC

Resources

BlogSupportPricing

Company

Brand KitPrivacy PolicyTerms of Service
LogoLogo
Book a demoLog inStart for free
On this page
  • May 28, 2026
  • Scope search by product or version
  • May 19, 2026
  • Markdown rendering for API components
  • May 14, 2026
  • CLI link checker
  • May 4, 2026
  • Custom robots.txt
  • Multi-source docs
  • May 1, 2026
  • API catalog discovery
  • Custom URL actions on the Prompt component
  • April 29, 2026
  • Redesigned dynamic OG images
  • April 27, 2026
  • Prompt component
  • Global themes
  • April 24, 2026
  • "Connect to Claude Code" page action
  • April 23, 2026
  • Clean up GitHub Actions preview deployments on merge
  • April 22, 2026
  • Clean up GitLab preview deployments on merge

Changelog


May 28, 2026
May 28, 2026

May 19, 2026
May 19, 2026

May 14, 2026
May 14, 2026

May 4, 2026
May 4, 2026

May 1, 2026
May 1, 2026

April 29, 2026
April 29, 2026

April 27, 2026
April 27, 2026

April 24, 2026
April 24, 2026

April 23, 2026
April 23, 2026

April 22, 2026
April 22, 2026

Older posts

Next

Scope search by product or version

You can now control how search results are ranked and filtered for sites with multiple products or versions using the new settings.search object in docs.yml.

  • prioritize-current-product boosts results from the current product higher in the ranking without hiding other products.
  • default-filter-by-current-product auto-selects the current product as a facet filter so only current-product results appear by default.

These options can be used independently or together.

Read the docs

Markdown rendering for API components

Interactive API components now render as fenced code blocks and structured content in your site’s Markdown output. AI agents consuming your docs via .md URLs, llms.txt, or llms-full.txt receive the full request and response examples without parsing HTML, reducing content disparity between the rendered page and its Markdown representation.

This applies to the following components:

  • <EndpointRequestSnippet>
  • <EndpointResponseSnippet>
  • <EndpointSchemaSnippet>
  • <RunnableEndpoint>
  • <WebhookPayloadSnippet>
  • <Schema>
  • <SchemaSnippet>
Read the docs

CLI link checker

You can now check for broken links on your live documentation site directly from the Fern CLI with fern docs link check. The command scrapes every page on your published site, checks all internal and external links, and reports broken (404) and blocked (403) URLs along with the source pages where they appear.

$fern docs link check --url https://buildwithfern.com/learn
$fern docs link check --url https://elevenlabs.io/docs

This complements the existing broken-links rule in fern check, which validates internal links against your local YAML navigation tree. Use fern docs link check after publishing to catch live 404s and broken external URLs that local validation can’t detect.

Read the docs

Custom robots.txt

You can now serve your own robots.txt at the root of your documentation site by pointing agents.robots-txt at a file in your repo. Use this to opt in or out of specific AI crawlers like GPTBot or ClaudeBot, gate sensitive sections from indexing, or signal training and search preferences with the Cloudflare Content Signals Policy. Your file is served verbatim at /robots.txt, and Fern appends a managed block disallowing internal API routes after your content.

docs.yml
1agents:
2 robots-txt: ./robots.txt
Read the docs

Multi-source docs

Multi-source docs lets each team publish independently to a shared custom domain — for example, docs.nvidia.com spans sub-paths like /nvcf, /brev, and /aiperf, each owned by a different product team and repository.

Set multi-source: true on the instance and reference a global theme for consistent branding across repositories.

docs.yml
1global-theme: my-org-theme
2
3instances:
4 - url: example.docs.buildwithfern.com/product-a
5 custom-domain: docs.example.com/product-a
6 multi-source: true
Read the docs

API catalog discovery

AI agents, MCP clients, and API catalog crawlers can now discover your APIs automatically. Every Fern Docs site exposes a standards-based (RFC 9727) /.well-known/api-catalog endpoint generated from your visible API Reference navigation.

Read the docs

Custom URL actions on the Prompt component

You can now point <Prompt> actions at any AI tool, not just Cursor, Claude, and ChatGPT. Send readers to Perplexity, your own internal AI assistant, or any other URL.

Generate a TypeScript SDK
Generate a TypeScript SDK from my OpenAPI spec. Follow the [TypeScript SDK quickstart](https://buildwithfern.com/learn/sdks/generators/typescript/quickstart.md).
Markdown
1<Prompt
2 title="Generate a TypeScript SDK"
3 actions={[
4 { label: "Open in Perplexity", url: "https://www.perplexity.ai/search?q={prompt}", icon: "magnifying-glass" },
5 "cursor"
6 ]}
7>
8Generate a TypeScript SDK from my OpenAPI spec. Follow the [TypeScript SDK quickstart](https://buildwithfern.com/learn/sdks/generators/typescript/quickstart.md).
9</Prompt>
Read the docs

Redesigned dynamic OG images

Dynamic OG images have a new layout with fine-grained control over the logo variant, text and background colors, and which elements appear (section, description, URL, gradient).

docs.yml
1metadata:
2 og:dynamic: true
3 og:dynamic:background-image: ./images/og-background.png
4 og:dynamic:text-color: "#1a1a1a"
5 og:dynamic:background-color: "#ffffff"
6 og:dynamic:logo-color: dark
7 og:dynamic:show-logo: true
8 og:dynamic:show-section: true
9 og:dynamic:show-description: true
10 og:dynamic:show-url: true
11 og:dynamic:show-gradient: true
Read the docs

Prompt component

The <Prompt> component displays an AI prompt card with a title, icon, copy button, and optional “Open in” action buttons. Add it to any page so readers can copy instructions or open them directly in Cursor, Claude, or ChatGPT.

Use it in tutorials, quickstarts, migration guides, or any page where you want readers to hand off a task to an AI assistant — for example, scaffolding a project, generating an SDK, or applying a code change.

Create a docs site
You are a **docs setup assistant**. Help the user create and publish a new docs site. Follow the [Quickstart guide](https://buildwithfern.com/learn/docs/getting-started/quickstart) step by step.
Markdown
1<Prompt
2 title="Create a docs site"
3 icon="rocket"
4 actions={["cursor", "claude", "chatgpt"]}
5>
6You are a **docs setup assistant**. Help the user create and publish a new docs site.
7
8Follow the [Quickstart guide](https://buildwithfern.com/learn/docs/getting-started/quickstart) step by step.
9</Prompt>
Read the docs

Global themes

Define your documentation branding in a single control repository and share it across multiple sites. Use the fern docs theme CLI commands to export, upload, and manage themes, then reference a theme by name in any child repository’s docs.yml with the global-theme property.

Read the docs

“Connect to Claude Code” page action

Fern Docs sites with Ask Fern enabled now display a “Connect to Claude Code” button alongside existing page actions. Clicking the button copies a claude mcp add command. Readers can paste it into their terminal to register your site’s MCP server with Claude Code.

The action is enabled by default and can be toggled off with page-actions.options.claude-code: false in docs.yml.

Read the docs

Clean up GitHub Actions preview deployments on merge

The GitHub Actions preview workflow now has an optional companion cleanup-preview.yml workflow that deletes a pull request’s preview deployment once the PR merges, so stale previews don’t linger.

To adopt this workflow, add .github/workflows/cleanup-preview.yml alongside your existing preview workflow.

Read the docs

Clean up GitLab preview deployments on merge

The updated GitLab CI/CD pipeline now includes a cleanup_preview stage that deletes a merge request’s preview deployment once the MR merges into the default branch, so stale previews don’t linger.

To adopt this workflow, replace your .gitlab-ci.yml file with the updated version.

Read the docs