Obsidian / Properties

Align the values of the notes and connect them to the list

Use properties in Obsidian
From frontmatter to a list

This page was machine-translated from Japanese. Read the Japanese original

Save the state, number, check, date, and tag in the note, and display the record that meets the conditions in Dataview. This is an introduction to the real GUI operation using three fictional cases and the saved Markdown confirmed.

The property is the UI that handles the YAML at the beginning of the note

The names and values entered in Properties will be stored in the frontmatter at the beginning of the note. For example, if you have status: 進行中, you can select the "in progress" note in the WHERE condition of Dataview. The treatment is different from the normal sentence written in the text.

First, decide what you want to compare and use a small number of items. In this example, the status is status, the priority is priority, the completion is done, the expiration date is due, and the classification is tags. It is a fictional record created by the author, not the user's data.

Decide the name, type, and value in order

  1. Open the note and add an item from Add property or the official Ctrl/Cmd+;. In the actual machine example, click Add property and add priority.
  2. Press the type icon next to the item name, open Property type and select the type. On the actual machine, I selected Number, entered 3, and saved it.
  3. The existing status has selected Text and changed it from "unstarted" to "in progress". I have confirmed that the check, date input, and tags input will also be changed in the actual UI and reflected in the saved YAML.
  4. Tags do not end with just entering characters, but press Enter to confirm with focused input. This auxiliary operation could not be confirmed once, so I checked the save by Enter and focus move again.
NameType and value of this exampleWhat I did on the actual machine
statusText / 進行中Selected Text; changed 未着手→進行中
priorityNumber / 3Add items, select Number, enter 3
doneCheckbox / true or falsefalse→true→false, finally true
dueDate / 2026-10-03October 1→October 3
tagsTags / Verification, PropertiesAdd a property and confirm

In the official document, the type with the same name is common throughout the vault. Before reusing the same name for a value with another meaning, check the type and purpose. Types that are not covered here, such as List and Date & time, are not included in this operation confirmation.

Real Obsidian property screen with priority saved in 3 as Number
Number type of priority and save value 3. The date has not been changed yet. Open the original image
The status of the final state is in progress, two tags, completion check, October 3 deadline, priority3 visible actual screen
Final preservation status. Done has been checked. Open the original image

Check the saved frontmatter

The following is the full text of the last saved text of Survey A, 211 bytes. After changing the done to true in the GUI, it is the same content as the original Markdown, including the text.

View the full text of the save Markdown of Survey A
---
status: 進行中
tags:
  - 検証
  - プロパティ
done: true
due: 2026-10-03
priority: 3
---

# 調査A

著者が検証用に作成した架空の記録です。顧客データではありません。

In the official document, frontmatter surrounds the beginning of the file with --- and describes it in the YAML format of 名前: 値. Do not duplicate property names in one note. The numbers 3 and check true in this example are saved as numbers and booleans, respectively. Date is a confirmation that saves this value, not the result of verifying the correctness of all date formats and inputs.

Make the same value a condition for TABLE and LIST

We copied the three files from the official stable Dataview release into an isolated vault in advance, then enabled the plugin through the actual trust confirmation. This does not test the Browse/Install interface. Because plugins execute third-party code, check the distribution source and terms before choosing one.

The release name was 0.5.70, and the distribution manifest and the actual screen display version was 0.5.68. The minimum version of Obsidian required is 0.13.11 on manifest, and the Obsidian that actually moved is 1.13.7. The DataviewJS setting is false, and the following DQL is entered into the actual editor and displayed in the Reading view.

Match the folder name 記録, item name, and status string. Survey A/B is in progress, C is complete.

# Properties接続検証

著者が作成した架空の3件だけを表示します。

## 進行中の表

```dataview
TABLE status AS "状態", priority AS "優先度", done AS "完了", due AS "期限"
FROM "記録"
WHERE status = "進行中"
SORT file.name ASC
```

## 未完了の一覧

```dataview
LIST
FROM "記録"
WHERE done = false
SORT file.name ASC
```

## 保留の該当なし

```dataview
LIST
FROM "記録"
WHERE status = "保留"
SORT file.name ASC
```

TABLE displays the two in-progress entries in a table; LIST displays notes whose done property is false. The final LIST selects pending notes, and we also checked its actual display when no notes matched. We did not test every DQL feature, inline fields, or DataviewJS here.

If you change the completion check, the unfinished list will change from 2 to 1

ConditionsSurvey A's done=falseAfter changing to done=true in the GUI
TABLE with status = 進行中Survey A・B / 2 casesSurvey A・B / 2 cases. Display the completion value of A true
done = false LISTSurvey A・C / 2 casesSurvey C / 1 cases
status = Pending LISTNot applicableNot applicable
Reading screen that shows survey A and survey C in the list of uncompleteds before the change, and does not apply to the pending conditions
Two entries in the LIST before the change, and no results for pending notes. Open the original image
Reading screen where only TABLE survey A and B after completion and change, and incomplete LIST survey C can be seen
After the change: two entries in the TABLE and one entry in the LIST. This is the actual screen. Open the original image

We verified the two TABLE entries before the change in the actual Reading view DOM, but the PNG captured at that time was scrolled below the table. The post-change PNG above shows the two table entries and one entry in the unfinished-notes list. We did not recreate the view or replace the images.

Open survey A and list notes again from the file list, and also confirm that the bytes of saved Markdown and SHA256 are the same. It is a re-display while the same app is running, and it is not a restart of the entire app or a confirmation of another device. As a result of the value being reflected in the display under this condition, the causality of increasing work speed and productivity is not measured.

Save four files in the final state

This is a file that copies the bytes of the original Markdown saved on the actual machine. The done of survey A is true. In the following configuration, the FROM of the query and the folder name are matched. The import in the reader's vault has not been verified.

保管庫/
  一覧.md
  記録/
    調査A.md
    調査B.md
    調査C.md
Relative path in the vaultSaved original
記録/調査A.mdSave 調査A.md (211 bytes)
記録/調査B.mdSave 調査B.md (152 bytes)
記録/調査C.mdSave 調査C.md (150 bytes)
一覧.mdSave 一覧.md (472 bytes)

The initial contents of the three records are created directly before verification. Item changes in survey A and query input of list notes are within the scope of GUI operation. B/C is not a record created from scratch in the GUI.

Frequently Asked Questions

Are the properties and frontmatter of Obsidian different data?
property is a UI that manipulates the structured value of the note, and the value is saved as the YAML frontmatter at the beginning of the file. In this actual machine, status, tags, done, due, and priority were manipulated with the GUI and compared with the saved values of Markdown.
Do you want to set the type of property for each note?
In the official document, the same type is used for the same property name throughout the repository. Open the Property type from the type icon next to the name and select the type. In this actual machine, I selected Number as priority and saved 3. Not all type and date inputs have been verified.
What is the basic form of listing properties in Dataview?
In a dataview code block, write TABLE or LIST with FROM and WHERE. For our three sample notes, FROM "記録" selected the folder. The TABLE with status = "進行中" returned two entries. The LIST with done = false returned two entries before the completion checkbox was changed and one afterward.
What is the state of the downloaded example?
These are the saved originals after changing the done property of study A to true through the GUI. The layout places studies A, B, and C inside 記録 folder, with 一覧.md at the vault root. The actual results were two TABLE entries, one unfinished LIST entry for study C, and no pending matches. Importing into a reader’s vault and behavior in other environments were not tested.

Official documents and the scope of this actual machine confirmation

The UTC date for GUI confirmation is September 30, 2026, and Japan time is October 1, 2026. The actual screen, saved original, fixed source, auxiliary correction, and the lack of end record are summarized in verification record. End Close was sent, but the end code of Obsidian has not been recorded due to the end order of the recorder.

  • Confirmed: Linux Obsidian 1.13.7, five types of finite GUI operation, save YAML, DQL three-condition real Reading display, value change and re-display, save match during the same startup.
  • Official description: Share the storage format and type of Properties, and confirm the frontmatter/QUERY/TABLE/LIST/WHERE of Dataview with fixed materials.
  • Unconfirmed: Verification of all types and all inputs, security audits of plug-ins, all DQL/JS, app restart, iOS, synchronization, SimpleMemo cooperation, large storage, speed, productivity.

Official Properties (fixed commit) · Dataview official materials (fixed commit) · Confirmed stable release

Next, expand how to write queries

value are aligned, check the display format and writing method of Dataview. The differences between general DQL, inline, and JS will proceed to the existing explanation.

Read how to use Dataview