Properties

Every property the plugin reads and writes. All of them start with mtm-, so they never clash with your own.

The plugin only reads and writes properties that start with mtm-. A property called status or type is yours; the plugin ignores it.

Notes are recognised by mtm-kind, not by folder, so Matters and Actions can live anywhere in your vault.

Matter notes

Property	Type	Values
`mtm-kind`	text	`matter`
`mtm-icon`	text	A Lucide icon name; `circle-dot` when absent
`mtm-state`	text	`active`, `dormant` or `closed`
`mtm-lane-order`	number	The lane’s place on the board, ascending
`mtm-sphere`	text	A Sphere’s ID from settings; absent means no Sphere
`mtm-review-every`	text	`2w`, `10d` or `1m` (days, weeks or calendar months); absent means never
`mtm-last-reviewed`	date	Set by Mark as reviewed
`mtm-outcome`	text	One line: what done looks like, or the standard to keep

Action notes

Property	Type	Values
`mtm-kind`	text	`action`
`mtm-type`	text	An Action type’s ID from settings
`mtm-status`	text	A status’s ID from settings
`mtm-matter`	link	`"[[Kitchen renovation]]"`
`mtm-start`	date & time	`2026-10-12` (all day) or `2026-10-12T09:00` (timed)
`mtm-due`	date & time	As for `mtm-start`
`mtm-priority`	number	`1` high, `2` medium, `3` low; absent means none
`mtm-waiting-on`	link	The person who has the ball; also added to `mtm-people`
`mtm-people`	list of links	The people involved
`mtm-waiting-since`	date	Set when `mtm-waiting-on` is set or changes; removed with it
`mtm-completed`	date	Set when the Action’s status becomes a closed one; removed when it leaves it
`mtm-order`	number	The card’s place in its cell on boards and lists in your own order, lower first; see Card order

Notes from the sample content also carry mtm-sample: true, which Remove sample content looks for.

Writing these notes from scripts or other apps? The note format says what to write and what to leave to the plugin.

Dates

The plugin sets mtm-start and mtm-due to Obsidian’s Date & time property type. They hold either a date (2026-10-15, all day) or a date and time (2026-10-15T10:00, timed). Seconds and a space instead of the T are read too.

All-day dates in Obsidian’s own panels

Obsidian’s Properties panel and Bases tables show an all-day date as “00:00”, and editing it with Obsidian’s date picker adds a time, which makes the Action timed. Edit dates in the inspector to keep them all day.

Card order

mtm-order is written only when you put cards in your own order (Cards in your own order). The first card you place numbers its cell 10, 20, 30…; later moves write a number between the card’s new neighbours. Cards without one come after the numbered cards, in the automatic order. Boards and lists sorted automatically ignore it.

The number belongs to one cell, so moving an Action to another status or Matter removes it, unless the move places it by hand. A script or another app that moves an Action should remove it too. Anyone can delete it at any time: the card simply goes back among the unplaced ones.

The note body

The body is plain Markdown that the plugin never restructures. The inspector shows:

Details: the text before the first list item, heading, embed or code block. When the details need a list or a heading, the inspector keeps them between two comment lines ( and ). Leave those lines in place.
Checklist: the task items (- [ ]) anywhere in the note.
Linked notes and attachments: the links and embedded files in the body.

An example

---
mtm-kind: action
mtm-type: call
mtm-matter: "[[Kitchen renovation]]"
mtm-status: next
mtm-due: 2026-10-15T10:00
mtm-priority: 1
mtm-waiting-on: "[[Charlie Carter]]"
mtm-people:
  - "[[Charlie Carter]]"
---
Confirm the worktop measurements before ordering.

- [ ] Ask for the revised quote