***

title: Configuration overview
subtitle: Configure your Fern Docs site at the site level and page level
description: >-
Understand how to configure your Fern documentation site at the site level and
page level.
-----------

For clean Markdown content of this page, append .md to this URL. For the complete documentation index, see [https://buildwithfern.com/learn/llms.txt](https://buildwithfern.com/learn/llms.txt). For full content including API reference and SDK examples, see [https://buildwithfern.com/learn/llms-full.txt](https://buildwithfern.com/learn/llms-full.txt).

Fern documentation is configured at two levels: **site-level** settings in `docs.yml` that apply globally, and **page-level** settings in frontmatter that control individual pages.

## Site-level configuration

The `docs.yml` file controls your site's appearance, structure, and behavior. All of the settings below are configured in `docs.yml`.

<CardGroup cols={2}>
  <Card title="Site-level settings" icon="fa-duotone fa-sliders" href="/learn/docs/configuration/site-level-settings">
    Colors, typography, logo, layout, navbar links, and analytics
  </Card>

  <Card title="Sections, pages, and folders" icon="fa-duotone fa-bars" href="/learn/docs/configuration/navigation/navigation">
    Organize your sidebar with sections, pages, and folders
  </Card>

  <Card title="Tabs" icon="fa-duotone fa-folder-open" href="/learn/docs/configuration/tabs">
    Group content into switchable tabs with optional variants
  </Card>

  <Card title="Versions" icon="fa-duotone fa-code-branch" href="/learn/docs/configuration/versions">
    Add a dropdown version selector for multiple doc versions
  </Card>

  <Card title="Products" icon="fa-duotone fa-grid-2" href="/learn/docs/configuration/products">
    Add a product switcher for multi-product sites
  </Card>

  <Card title="Changelog" icon="fa-duotone fa-clock-rotate-left" href="/learn/docs/configuration/changelogs">
    Chronological record of changes with tagging and RSS
  </Card>
</CardGroup>

## Page-level configuration

Use frontmatter in individual `.mdx` files to override site-level defaults for a specific page, such as titles, meta descriptions, slugs, layout, and visibility of page elements.

<CardGroup cols={2}>
  <Card title="Page-level settings" icon="fa-duotone fa-file-lines" href="/learn/docs/configuration/page-level-settings">
    Titles, descriptions, slugs, layout, availability badges, and more
  </Card>
</CardGroup>