Page Settings

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

Key	Type	Description
`title`	string	The page’s display name (used in the sidebar, breadcrumbs, and tab title).
`page_width`	`article` \| `full`	Override the project’s page width for this page.
`cards`	boolean	Override whether components are wrapped in cards.
`table_of_contents`	boolean	Override whether the table-of-contents sidebar is shown.
`auto_refresh`	number (ms)	Override how often the page re-runs its queries. `0` disables it.
`sidebar_position`	number	Order the page within its sidebar group (lower numbers first). Page-only — not a project default.
`icon`	string	The icon shown next to the page in the sidebar. Page-only.
`theme`	object	Per-page theme overrides (colors, palettes, scales). See below.
`type`	`partial`	Marks 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: ['#154886', '#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.

Get Started

Core Concepts

Features

CLI

Warehouses

Evidence Warehouse

Components

Supported keys

Inheritance

`theme`

Frontmatter variables

​Supported keys

​Inheritance

​theme

​Frontmatter variables

Supported keys

Inheritance

`theme`

Frontmatter variables