guanghu/site/reference/frontmatter-fields.md
Guanghu Domestic Migration 9b41d51231
Some checks are pending
Auto-update PR branches / Update open PR branches (push) Waiting to run
CI / Frontend Static Quality Checks (push) Waiting to run
CI / Frontend Tests & Coverage (push) Waiting to run
CI / Rust Tests & Quality Checks (push) Waiting to run
CI / Linux build verification (push) Waiting to run
Deploy docs / Build VitePress site (push) Waiting to run
Deploy docs / Deploy to GitHub Pages (push) Blocked by required conditions
Release (Alpha) / Compute alpha version (push) Waiting to run
Release (Alpha) / Build release artifacts (push) Blocked by required conditions
Release (Alpha) / GitHub Release (alpha) (push) Blocked by required conditions
Release (Alpha) / Update docs and release pages (push) Blocked by required conditions
chore: import sanitized domestic snapshot for REPO-004
Source snapshot: 514ab1975951d94342ea38e64101d5a0f1c51c77
2026-07-17 15:55:28 +08:00

1.3 KiB

Frontmatter Fields

Tolaria uses conventions instead of a required schema.

Field Meaning
type The note's entity type.
status Lifecycle state.
icon Per-note icon.
url External URL.
date Single date.
belongs_to Parent relationship.
related_to Lateral relationship.
has Contained relationship.
_width Per-note editor width override.
_display Display mode. Omit for text notes; use sheet for spreadsheet notes.
_icon, _color Type or note appearance metadata.
_sidebar_label, _order Type sidebar label and order.
_pinned_properties Properties pinned for a type.
_sheet Sheet-note presentation metadata such as grid settings, column widths, row heights, and cell formatting.

Custom Fields

You can add your own fields. If a field contains wikilinks, Tolaria can treat it as a relationship.

System Fields

Fields starting with _ are reserved for system behavior and hidden from standard property editing. They remain plain YAML, so they can still be inspected or changed in raw mode when needed.

Nested keys under a system field are also system-owned. For example, _sheet.cells.B6.num_fmt belongs to the sheet editor and should not appear as a normal user property.