Get AI summaries of any video or article — Sign up free
Obsidian properties in YAML frontmatter (v1.4 - OUT NOW!) thumbnail

Obsidian properties in YAML frontmatter (v1.4 - OUT NOW!)

Nicole van der Hoeven·
5 min read

Based on Nicole van der Hoeven's video on YouTube. If you like this content, support the original creators by watching, liking and subscribing to their content.

TL;DR

Obsidian 1.4 adds a typed frontmatter UI that maps property icons to specific types like Text, List, Number, Checkbox, Date, and Time.

Briefing

Obsidian 1.4 introduces a redesigned YAML frontmatter experience that adds a real “properties” layer on top of plain text—complete with typed fields, clickable note links, and a dedicated properties pane. The practical payoff is fewer silent breakages (like malformed YAML or inconsistent property names) and less manual work to keep metadata and links working as notes evolve.

For years, YAML frontmatter has been powerful but fragile: a missing dash or an incorrectly defined key/value pair can break metadata without obvious warnings, and links inside frontmatter historically didn’t reliably update when a note was renamed. Many users responded by moving links into comments inside the note body—clickable, but redundant and harder to keep clean. Obsidian 1.4 tackles both problems by adding a new UI for frontmatter and properties, while still preserving the underlying text-based YAML for compatibility with external editors and IDEs.

In the new UI, each property shows an icon that corresponds to its type. Instead of typing raw YAML, users can add properties through the interface and select property types such as Text, List (multi-select), Number, Checkbox (Boolean), Date, and Time. The interface also infers types automatically in some cases—for example, choosing a date type when the value looks like a date. Most importantly, once a property type is set, Obsidian restricts what can be entered: a field defined as Number won’t accept arbitrary strings, and a Date field switches to a date picker rather than freeform typing.

Existing properties can be retagged with new types, but inconsistent historical data can trigger compatibility errors. If earlier notes stored mixed values for the same key (including placeholders like “none” or template-derived strings), changing the type forces those values to be reconciled. The workflow implication is clear: teams and individuals aiming for consistency may need to “rejig” older notes to match the new typed standard.

Link handling improves as well. In the frontmatter UI, note links become clickable and update when the target note name changes—eliminating the need for the old comment-based workaround. URL properties are also supported, and clicking them opens the linked resource in the browser.

Beyond the UI, Obsidian adds a new core plugin called Properties, enabled by default. It provides two panes accessible via the command palette: one for file properties (useful while editing) and another that lists all properties across the vault. That “all properties” view helps spot inconsistencies—such as near-duplicate keys or mismatched types—by letting users inspect and change property types from a centralized place.

Compatibility isn’t universal. Some plugins require adjustments: Templater can break if a property type is changed to Number/Date while templates still output templater strings; Fantasy Calendar may lose its nested-key date picker UI because the new model doesn’t support nested keys the same way; and the Banners plugin may mis-parse frontmatter depending on whether it expects source mode. Other tools, including Dataview and ExcaliBrain, continue to parse frontmatter, though users may need to adjust list formatting (e.g., comma-separated values may need to become explicit arrays).

Overall, Obsidian 1.4 reframes frontmatter from “typed-by-hand YAML” into a typed metadata system—trading some migration friction for stronger consistency, better link behavior, and a smoother editing experience for heavy frontmatter users.

Cornell Notes

Obsidian 1.4 adds a typed UI layer for YAML frontmatter, letting users define properties with explicit types like Text, List, Number, Checkbox, Date, and Time. The interface enforces those types, provides date/time pickers, and auto-infers types in some cases, reducing silent metadata errors. Note links in frontmatter become clickable and update on rename, removing the need for comment-based link workarounds. A new core plugin, Properties, adds panes for file-level metadata and a vault-wide “all properties” view to help enforce consistency. Some plugins may need workflow changes—especially those relying on templater strings, nested keys, or specific frontmatter parsing behavior.

What problem with YAML frontmatter does Obsidian 1.4 try to fix first?

It targets silent breakage and inconsistency. YAML syntax mistakes (like missing dashes or malformed key/value pairs) can previously fail without clear guidance, and property naming/value formats could drift over time. The new properties UI adds typed fields and enforcement, so invalid inputs are blocked or flagged rather than quietly accepted as wrong metadata.

How do property types change day-to-day editing?

Users can add properties through the UI and choose types such as Text, List (multi-select), Number, Checkbox (Boolean), Date, and Time. Once a property is typed, Obsidian restricts what can be entered—for example, a Number field won’t accept arbitrary strings, and Date/Time fields use pickers instead of freeform typing.

What happens when a note link inside frontmatter points to a renamed note?

In the updated frontmatter UI, links to notes are clickable and update when the target note is renamed. That removes the older workaround where links were placed in body comments solely to keep them clickable and rename-safe.

Why can changing a property type break existing notes?

Because older notes may contain incompatible values for the same property key. If a property key previously stored mixed content (e.g., “none,” template placeholders, or non-numeric strings) and the user later changes the property type to Number, Obsidian raises an incompatibility error. Fixing it may require updating prior notes so all values match the new type.

What does the new Properties core plugin add beyond the frontmatter UI?

It provides separate panes: one for file properties and another for all properties across the entire vault. The vault-wide view helps identify inconsistencies (like duplicate or mismatched property keys/types) and allows type changes from a centralized list. Both panes stay in sync with the frontmatter UI in real time.

Which plugins are most likely to need attention after upgrading?

Templater can fail if a property type is changed to Number/Date while templates still output templater strings, causing template-generated fields to become empty or incompatible. Fantasy Calendar may lose its nested-key date picker UI because the new model doesn’t support those nested keys the same way. Banners may mis-parse frontmatter depending on whether it expects source mode. Dataview and ExcaliBrain generally still parse frontmatter, but list formatting may need to be converted into explicit arrays for correct multi-value behavior.

Review Questions

  1. How does typed property enforcement reduce the likelihood of metadata errors compared with raw YAML editing?
  2. What migration steps might be required before changing an existing property key from Text to Number?
  3. How do the “file properties” and “all properties” panes differ in purpose, and how can they help enforce consistency across a vault?

Key Points

  1. 1

    Obsidian 1.4 adds a typed frontmatter UI that maps property icons to specific types like Text, List, Number, Checkbox, Date, and Time.

  2. 2

    Property types are enforced, so invalid values are blocked and Date/Time fields use pickers instead of freeform input.

  3. 3

    Note links placed in frontmatter are now clickable and update automatically when the target note is renamed, eliminating older comment-based link workarounds.

  4. 4

    Changing property types for existing keys can trigger incompatibility errors if older notes contain mixed or placeholder values, requiring cleanup.

  5. 5

    A new core plugin, Properties, adds synchronized panes for file-level metadata and a vault-wide “all properties” view to spot and fix inconsistencies.

  6. 6

    Some plugins may break or degrade after the change—especially those depending on templater strings, nested frontmatter keys, or specific parsing expectations—while Dataview and ExcaliBrain remain largely compatible.

Highlights

Typed properties turn YAML frontmatter into a constrained metadata system, with enforcement that prevents many silent mistakes.
Frontmatter note links become clickable and rename-safe, removing the need to duplicate links in comments.
The Properties core plugin’s “all properties” pane helps detect inconsistent keys and types across an entire vault.
Compatibility isn’t uniform: Templater, Fantasy Calendar, and Banners may need workflow adjustments, while Dataview continues to parse frontmatter effectively.

Topics

  • YAML Frontmatter
  • Typed Properties
  • Obsidian Properties UI
  • Dataview Compatibility
  • Plugin Migration

Mentioned