Labels

A label is an attribute of a note which has a name and optionally a value.

Common use cases#

• Metadata for personal use: Assign labels with optional values for categorization, such as #year=1999, #genre="sci-fi", or #author="Neal Stephenson". This can be combined with Promoted Attributes to make their display more user-friendly.
• Configuration: Labels can configure advanced features or settings (see reference below).
• Scripts and Plugins: Used to tag notes with special metadata, such as the "weight" attribute in the Weight Tracker.

Creating a label using the visual editor#

1. Go to the Owned Attributes section in the Ribbon.
2. Press the + button (Add new attribute) to the right.
3. Select Add new label for the relation.

While in the visual editor:

• Set the desired name
• Optionally, set the value of the label. Labels can exist without a value.
• Check Inheritable if the label should be inherited by the child notes as well. See Attribute Inheritance for more information.

Creating a label manually#

In the Owned Attributes section in the Ribbon:

• To create a label called myLabel with no value, simply type #myLabel.
• To create a label called myLabel with a value value, simply type #myLabel=value.
• If the value contains spaces, then the text must be quoted: #myLabel="Hello world".
• If the string contains quotes (regardless of whether it has spaces), then the text must be quoted with apostrophes instead: #myLabel='Hello "world"'.
• To create an inheritable label called myLabel, simply write #myLabel(inheritable) for no value or #myLabel(inheritable)=value if there is a value.

Predefined labels#

This is a list of labels that Trilium natively supports.

Label	Description
disableVersioning	Disables automatic creation of Note Revisions for a particular note. Useful for e.g. large, but unimportant notes - e.g. large JS libraries used for scripting.
versioningLimit	Limits the maximum number of Note Revisions for a particular note, overriding the global settings.
calendarRoot	Marks the note which should be used as root for Day Notes. Only one should be marked as such.
archived	Hides notes from default search results and dialogs. Archived notes can optionally be hidden in the Note Tree.
excludeFromExport	Excludes this note and its children when exporting.
run, runOnInstance, runAtHour	See Events.
disableInclusion	Scripts with this label won't be included into parent script execution.
sorted, sortDirection, sortFoldersFirst, sortNatural, sortLocale, top, bottom	Manages automatic/permanent sorting. See Sorting Notes.
hidePromotedAttributes	Hide Promoted Attributes on this note. Generally useful when defining inherited attributes, but the parent note doesn't need them.
readOnly	Marks a note to always be read-only, if it's a supported note (text, code, mermaid).
autoReadOnlyDisabled	Disables automatic read-only mode for the given note.
appCss	Marks CSS notes which are loaded into the Trilium application and can thus be used to modify Trilium's looks. See Custom app-wide CSS for more info.
appTheme	Marks CSS notes which are full Trilium themes and are thus available in Trilium options. See Theme development for more information.
appThemeBase	Set to next, next-light, or next-dark to use the corresponding TriliumNext theme (auto, light or dark) as the base for a custom theme, instead of the legacy one. See Customize the Next theme for more information.
cssClass	Value of this label is then added as CSS class to the node representing given note in the Note Tree. This can be useful for advanced theming. Can be used in template notes.
iconClass	value of this label is added as a CSS class to the icon on the tree which can help visually distinguish the notes in the tree. Example might be bx bx-home - icons are taken from boxicons. Can be used in template notes.
pageSize	Specifies the number of items per page in Note List.
customRequestHandler	See Custom Request Handler.
customResourceProvider	See Custom Resource Providers.
widget	Marks this note as a custom widget which will be added to the Trilium component tree. See Custom Widgets for more information.
searchHome	New search notes will be created as children of this note (see Saved Search).
workspace and related attributes	See Workspaces.
inbox	Default inbox location for new notes. See Note Inbox for more information.
sqlConsoleHome	Default location of SQL Console saved queries.
bookmarked	Indicates this note is a bookmark.
bookmarkFolder	Note with this label will appear in bookmarks as folder (allowing access to its children). See Bookmarks for more information.
share*	See the attribute reference in Sharing.
displayRelations, hideRelations	Comma delimited names of relations which should be displayed/hidden in a Relation Map (both the note type and the Note Map (Link map, Tree map) general functionality).
titleTemplate	Default title of notes created as children of this note. This value is evaluated as a JavaScript string and thus can be enriched with dynamic content via the injected now and parentNote variables. See Default Note Title for more info.
template	This note will appear in the selection of available template when creating new note. See Templates for more information.
toc	Controls the display of the Table of contents for a given note. #toc or #toc=show to always display the table of contents, #toc=false to always hide it.
color	defines color of the note in note tree, links etc. Use any valid CSS color value like 'red' or #a13d5f  Note: this color may be automatically adjusted when displayed to ensure sufficient contrast with the background.
keyboardShortcut	Defines a keyboard shortcut which will immediately jump to this note. Example: 'ctrl+alt+e'. Requires frontend reload for the change to take effect.
keepCurrentHoisting	Opening this link won't change hoisting even if the note is not displayable in the current hoisted subtree.
executeButton	Title of the button which will execute the current code note
executeDescription	Longer description of the current code note displayed together with the execute button
excludeFromNoteMap	Notes with this label will be hidden from the Note Map.
newNotesOnTop	New notes will be created at the top of the parent note, not on the bottom.
hideHighlightWidget	Hides the Highlights list widget
hideChildrenOverview	Hides the Note List for that particular note.
subtreeHidden	Hides all child notes of this note from the tree, displaying a badge with the count of hidden children. Children remain accessible via search or direct links.
printLandscape	When exporting to PDF, changes the orientation of the page to landscape instead of portrait.
printPageSize	When exporting to PDF, changes the size of the page. Supported values: A0, A1, A2, A3, A4, A5, A6, Legal, Letter, Tabloid, Ledger.
printScale, printMargins	Additional printing options, generally configured through the Printing & Exporting as PDF dialog.
geolocation	Indicates the latitude and longitude of a note, to be displayed in a Geo Map.
map:*	Defines specific options for the Geo Map.
calendar:*	Defines specific options for the Calendar.
viewType	Sets the view of child notes (e.g. grid or list). See Note List for more information.
webViewSrc	Defines the URL of the Web View.
tabWidth, indentWithTabs, wrapLines	Per-note Code editor settings: indentation width, indent with tabs vs. spaces, and word wrapping. See Code.
datePattern, weekPattern, monthPattern, quarterPattern, yearPattern	Customizes the title naming pattern of day / week / month / quarter / year notes. See Day Notes.
enableWeekNote, enableQuarterNote	Enables optional week and quarter notes in the calendar hierarchy; set on the calendar root. See Day Notes.
fullContentWidth	Expands the note to the full editor width, ignoring the configured content width (useful for wide tables). See Content width.
iconPack	Identifies a custom icon pack by its prefix. See Creating an icon pack.
clipperInbox	Overrides the default location where the Web Clipper saves clippings (defaults to the day note). See Web Clipper.
similarNotesWidgetDisabled	Disables the Similar Notes ribbon tab (old layout only)
docName , docUrl	Used internally for the in-app help.