Organization

Define and Manage Properties

Properties are the structured fields of your world’s data. A “Character” type might have a “Birth Year” number property and an “Allegiance” text property. A “Spell” type might have a “Difficulty” select property with options “Novice”, “Adept”, “Master”. Once a property is defined and attached to a type, every page of that type carries that field in its properties panel.

Property value types

Inklings supports the following value types for property definitions:

Type	Accepts	Example
`text`	Any string	`"Court Mage"`
`number`	Numeric values	`34`, `1.5`
`yes/no`	True or false	`true`
`date`	ISO date strings	`"1987-04-12"`
`select`	One option from a predefined list	`"Draft"`
`multi_select`	Multiple options from a predefined list	`["Action", "Mystery"]`
`relation`	A reference to another page	—

The value type is set when the property is created and cannot be changed afterward.

Create a property definition

Property definitions are workspace-scoped — you create them once and can attach them to multiple types.

Open Settings → Properties or the property management surface.
Click + New Property.
Enter a name (for example, “Birth Year” or “Allegiance”).
Select a value type.
For select or multi_select types, add the predefined options with optional colors.
Confirm to create the property.

Inklings derives an identifier from the property name (“Birth Year” becomes birth-year). The identifier is how property values are stored and referenced internally.

Attach a property to a type

Creating a property definition does not automatically associate it with a type. You link them explicitly:

Open the type management surface (Settings → Types).
Select the type you want to add the property to.
Click + Add property and select the property from the list.
Confirm.

The property now appears in the properties panel for every page of that type. The type’s property list reflects the new addition immediately.

Detach a property from a type

Unlinking a property from a type removes it from that type’s structure but does not delete the property definition itself. The property can still be attached to other types or set as a freeform property on any page.

Open the type management surface and select the type.
Find the property in the type’s property list and click the remove action.

Open the page and navigate to the properties panel in the context sidebar. Find the property field and enter or select a value.

Type {{ in the editor body to open the property autocomplete. Select a property name, then enter a value. The property reference renders as an inline badge showing name:value. You can also use the /property slash command as an alternative trigger.

Property values set inline in the editor use the {{name:value}} format in the underlying markdown. For example, {{status:published}} sets the status property to “published”. Values set via the panel and values set inline are synchronized — they represent the same property data.

Clear a property value

Set the value to empty in the properties panel. The property is removed from the page entirely.

Type validation

If a property has a registered value type, Inklings validates the value when you set it. Passing a string to a number property, or passing a non-array to a multi_select property, returns a validation error. The page’s existing property values are not modified on a validation failure.

Freeform property identifiers — those that do not match any registered property definition — bypass type validation and are stored as arbitrary property values.

Properties in search

Property values are indexed in full-text search. If you set protagonist: "Lira the Cartographer" on a page, searching for “Lira the Cartographer” in the command palette returns that page even if the name does not appear in the title or body text.