Skip to content

Metadata on Pages

You can add fields (queryable information) to a markdown page (a note) in three different ways - via Frontmatter, Inline fields and Implicit fields. Read more about how to add metadata.

A simple Markdown page which includes both user-defined ways to add metadata:

---
duration: 4 hours
reviewed: false
---
# Movie X

**Thoughts**:: It was decent.
**Rating**:: 6

[mood:: okay] | [length:: 2 hours]

Implicit Fields

Dataview automatically adds a large amount of metadata to each page:

  • file.name: The file title (a string).
  • file.folder: The path of the folder this file belongs to.
  • file.path: The full file path (a string).
  • file.ext: The extension of the file type; generally '.md' (a string).
  • file.link: A link to the file (a link).
  • file.size: The size (in bytes) of the file (a number).
  • file.ctime: The date that the file was created (a date + time).
  • file.cday: The date that the file was created (just a date).
  • file.mtime: The date that the file was last modified (a date + time).
  • file.mday: The date that the file was last modified (just a date).
  • file.tags: An array of all unique tags in the note. Subtags are broken down by each level, so #Tag/1/A will be stored in the array as [#Tag, #Tag/1, #Tag/1/A].
  • file.etags: An array of all explicit tags in the note; unlike file.tags, does not include subtags.
  • file.inlinks: An array of all incoming links to this file.
  • file.outlinks: An array of all outgoing links from this file.
  • file.aliases: An array of all aliases for the note.
  • file.tasks: An array of all tasks (I.e., - [ ] blah blah blah) in this file.
  • file.lists: An array of all list elements in the file (including tasks); these elements are effectively tasks and can be rendered in task views.
  • file.frontmatter: Contains the raw values of all frontmatter; mainly useful for checking raw frontmatter values or for dynamically listing frontmatter keys.

If the file has a date inside its title (of form yyyy-mm-dd or yyyymmdd), or has a Date field/inline field, it also has the following attributes:

  • file.day: An explicit date associated with the file title.

If you use the Obsidian Core Plugin "Starred Files", the following metadata is also available:

  • file.starred: If this file has been starred by the "stars" Obsidian plugin.