Skip to content

Document search-metadata frontmatter key for Algolia records - #6789

Draft
fern-api[bot] wants to merge 2 commits into
mainfrom
2026-08-31-fern-ai-fe3932-1c9a3500
Draft

Document search-metadata frontmatter key for Algolia records#6789
fern-api[bot] wants to merge 2 commits into
mainfrom
2026-08-31-fern-ai-fe3932-1c9a3500

Conversation

@fern-api

@fern-api fern-api Bot commented Aug 31, 2026

Copy link
Copy Markdown
Contributor

Added a "Custom search metadata" section to the Search configuration page (between "Index external sitemaps" and "How results are ranked") explaining that Fern merges a page's search-metadata frontmatter mapping into its Algolia record, with string and array-value examples and a note that Fern's built-in search filters ignore these fields unless you configure Algolia facets and build or extend a search UI. Added a matching "Search metadata" subsection to the page settings reference with a ParamField, the same example, and a link to the canonical section.

@github-actions

Copy link
Copy Markdown
Contributor

The block is duplicated onto every record of a page, so keep it to the dimensions you actually facet on.
</Accordion>

Custom metadata is indexed for Markdown pages only. API reference and changelog records don't carry it.

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

🚫 [vale] <FernStyles.Reject> reported by reviewdog 🐶
Use 'API Reference' instead of 'API reference'.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant