Skip to main content
A page’s settings live in a block of YAML frontmatter at the top of the file, delimited by ---. They set the page’s title and can override the project-wide defaults (from evidence.config.yaml) for that page only. 
---
title: My Page
page_width: full
cards: true
sidebar_position: 2
auto_refresh: 300000
---

# Page content here
Most pages only need a title. Add other keys to override a setting for that page; anything you leave out is inherited from the project.

​
Supported keys

KeyTypeDescription
titlestringThe page’s display name (used in the sidebar, breadcrumbs, and tab title).
page_widtharticle | fullOverride the project’s page width for this page.
cardsbooleanOverride whether components are wrapped in cards.
table_of_contentsbooleanOverride whether the table-of-contents sidebar is shown.
auto_refreshnumber (ms)Override how often the page re-runs its queries. 0 disables it.
sidebar_positionnumberOrder the page within its sidebar group (lower numbers first). Page-only — not a project default.
iconstringThe icon shown next to the page in the sidebar. Page-only.
themeobjectPer-page theme overrides (colors, palettes, scales). See below.
typepartialMarks the file as a partial. Only used for partials.

​
Inheritance

The layout keys (page_width, cards, table_of_contents, auto_refresh) override the project’s layout in evidence.config.yaml for that page. sidebar_position and icon are page-only settings; they have no project-wide default.

​
theme

Per-page theme overrides are nested under theme:, mirroring the structure of theme.yaml. Anything you set here overrides the project theme for this page only; anything you leave out is inherited. 
---
title: Revenue
theme:
  colors:
    base:
      light: '#ffffff'
      dark: '#0b1020'
  colorPalettes:
    default:
      light: ['#236aa4', '#45a1bf']
---

​
Frontmatter variables

Any key that isn’t one of the settings above is treated as your own custom value and preserved as-is. This is how page variables are defined — in the same frontmatter block, alongside your page settings — and then referenced elsewhere on the page with {{ $my_var }}. See Variables → In Frontmatter.