Attributes

Note attributes are key-value records owned by (assigned to) given note.

There are four types of attributes:

• Labels - simple key-value text record
• Relation - specifies named relation (link) to another note
• Label and relation definition - these are described in Promoted attributes page

Sometimes we're talking about labels and relations - keep in mind that both of them are types of attributes and are very similar.

Labels

Labels are used for several things:

• user can use them as labels with optional value - e.g. when catalogizing books, you might add labels like @year=1999, @genre=sci-fi, @author=Neal Stephenson
• attributes can be used to configure some advanced features / settings - see below
• plugins / scripts can use these to mark notes with some special values / metadata (e.g. Weight Tracker will have "weight" attribute on day notes based on whose it can create chart).

Labels can be used for searching.

Standard labels

Following labels are used for advanced configuration:

• disableVersioning - disables auto-versioning. Useful for e.g. large, but unimportant notes - e.g. large JS libraries used for scripting
• calendarRoot - marks note which should be used as root for day notes. Only one should be marked as such.
• archived - notes with this label won't be visible in autocomplete-based search (jump to, add link). Applies also to all its sub-notes.
• excludeFromExport - notes (with their sub-tree) won't be included in any note export
• run - defines on which events script should run. Possible values are:
  • frontendStartup - when Trilium frontend starts up (or is refreshed).
  • backendStartup - when Trilium backend starts up
  • hourly - run once an hour
  • daily - run once a day
• disableInclusion - scripts with this label won't be included into parent script execution.
• sorted - keeps child notes sorted by title alphabetically
• hidePromotedAttributes
• hideChildrenOverview
• readOnly - editor is in read only mode. Works only for text notes. See some use cases here.
• cssClass - value of this label is then added as CSS class to the node representing given note in the tree. This can be useful for advanced theming.

Relations

Relation is a kind of link between two notes.

This could be used when you e.g. keep a people database, you can use relations to keep formal links between people - e.g. note "Mike" will have relation "is husband of" note "Kate".

More importantly relations are used for some more advanced things - like attaching scripts to events happening on certain note.

Standard relations

• runOnNoteView - attached script will be run whenever the note has been loaded
• runOnNoteTitleChange - attached script will be run whenever the note title has been changed
• runOnAttributeChange - attached script will be run whenever the note's attribute has been changed
• template - attached note's attributes will be inherited even without parent-child relationship

Multiplicity

Attributes allow multiplicity - there can be multiple attributes with the same name. We're then calling such attributes "multivalue".

Attribute inheritance

See Attribute inheritance.