Skip to content

Build your personal knowledge base with Trilium Notes

feat(collections/board): set date attributes from the card menu

Elian Doranc9f8fb18c8ce
diff --git a/apps/client/src/translations/en/translation.json b/apps/client/src/translations/en/translation.json
index dd7034fbd0..6bfdce3ef3 100644
--- a/apps/client/src/translations/en/translation.json
+++ b/apps/client/src/translations/en/translation.json
@@ -3088,7 +3088,10 @@
},
"attribute_menu": {
"attributes": "Attributes",
- "not-set": "Not set"
+ "not-set": "Not set",
+ "today": "Today",
+ "tomorrow": "Tomorrow",
+ "next-week": "Next week"
},
"link_context_menu": {
"open_note": "Open note",
diff --git a/apps/client/src/widgets/collections/attribute_menu.spec.ts b/apps/client/src/widgets/collections/attribute_menu.spec.ts
index 848f1ab4a3..9338c4f46e 100644
--- a/apps/client/src/widgets/collections/attribute_menu.spec.ts
+++ b/apps/client/src/widgets/collections/attribute_menu.spec.ts
@@ -1,4 +1,4 @@
-import { beforeEach, describe, expect, it, vi } from "vitest";
+import { afterEach, beforeEach, describe, expect, it, vi } from "vitest";
import type FNote from "../../entities/fnote";
import type { MenuCommandItem, MenuItem } from "../../menus/context_menu";
@@ -17,6 +17,11 @@ vi.mock("../../services/attributes", async (importOriginal) => ({
// i18next is never initialised under test, so `t` echoes the key it is given.
vi.mock("../../services/i18n", () => ({ t: (key: string) => key }));
+const weekOptions = vi.hoisted(() => ({ firstDayOfWeek: 1 }));
+vi.mock("../../services/options", () => ({
+ default: { getInt: (name: string) => (name === "firstDayOfWeek" ? weekOptions.firstDayOfWeek : null) }
+}));
+
beforeEach(() => vi.clearAllMocks());
describe("buildAttributeMenuItems", () => {
@@ -221,6 +226,77 @@ describe("buildAttributeMenuItems", () => {
});
});
+ describe("a date", () => {
+ const due = [ attribute({ name: "due", title: "Due", labelType: "date" }) ];
+
+ beforeEach(() => {
+ // A Wednesday.
+ vi.useFakeTimers({ now: new Date(2026, 9, 21, 15, 30) });
+ weekOptions.firstDayOfWeek = 1;
+ });
+ afterEach(() => vi.useRealTimers());
+
+ function entries(...notes: FNote[]) {
+ const items = buildAttributeMenuItems<string>({ notes, attributes: due });
+ const entry = items[1];
+ if (!entry || !("items" in entry)) throw new Error("expected a submenu");
+ return entry.items ?? [];
+ }
+
+ it("offers Not set, then today, tomorrow and next week", () => {
+ const items = entries(buildNote({ title: "Card" }));
+
+ expect(titles(items)).toEqual([
+ `<span class="tn-menu-name">attribute_menu.not-set</span>`,
+ "separator",
+ `<span class="tn-menu-name">attribute_menu.today</span>`,
+ `<span class="tn-menu-name">attribute_menu.tomorrow</span>`,
+ `<span class="tn-menu-name">attribute_menu.next-week</span>`
+ ]);
+ expect(marked(items)).toEqual([
+ `<span class="tn-menu-name">attribute_menu.not-set</span>`
+ ]);
+ });
+
+ it("writes each date, next week starting on the configured first day", () => {
+ const note = buildNote({ title: "Card" });
+
+ pick(entries(note)[2]);
+ expect(writes.setLabelValues).toHaveBeenCalledWith(note, "due", [ "2026-10-21" ]);
+ pick(entries(note)[3]);
+ expect(writes.setLabelValues).toHaveBeenCalledWith(note, "due", [ "2026-10-22" ]);
+ pick(entries(note)[4]);
+ expect(writes.setLabelValues).toHaveBeenCalledWith(note, "due", [ "2026-10-26" ]);
+
+ weekOptions.firstDayOfWeek = 0;
+ pick(entries(note)[4]);
+ expect(writes.setLabelValues).toHaveBeenCalledWith(note, "due", [ "2026-10-25" ]);
+
+ pick(entries(note)[0]);
+ expect(writes.setLabelValues).toHaveBeenCalledWith(note, "due", []);
+ });
+
+ it("marks the date the items hold only while they all hold it", () => {
+ const tomorrow = buildNote({ title: "One", "#due": "2026-10-22" });
+
+ expect(marked(entries(tomorrow))).toEqual([
+ `<span class="tn-menu-name">attribute_menu.tomorrow</span>`
+ ]);
+ expect(marked(entries(tomorrow, buildNote({ title: "Two", "#due": "2026-10-22" }))))
+ .toEqual([ `<span class="tn-menu-name">attribute_menu.tomorrow</span>` ]);
+ expect(marked(entries(tomorrow, buildNote({ title: "Two" })))).toEqual([]);
+ expect(marked(entries(buildNote({ title: "Card", "#due": "2026-12-01" }))))
+ .toEqual([]);
+ });
+
+ it("leaves out a date and time, which a menu cannot set without its time", () => {
+ expect(build({ title: "Card" }, [
+ attribute({ name: "at", title: "At", labelType: "datetime" }),
+ attribute({ name: "time", title: "Time", labelType: "time" })
+ ])).toEqual([]);
+ });
+ });
+
it("escapes what a crafted name would plant in the menu", () => {
const crafted = `<img src=x onerror="alert(1)">`;
const items = build({ title: "Card" }, [ attribute({
diff --git a/apps/client/src/widgets/collections/attribute_menu.ts b/apps/client/src/widgets/collections/attribute_menu.ts
index 57ca7ee7e8..e5ec292029 100644
--- a/apps/client/src/widgets/collections/attribute_menu.ts
+++ b/apps/client/src/widgets/collections/attribute_menu.ts
@@ -1,8 +1,11 @@
+import { dayjs, type Dayjs, getWeekStartDate } from "@triliumnext/commons";
+
import type FNote from "../../entities/fnote";
import type { MenuCommandItem, MenuItem } from "../../menus/context_menu";
import { menuName } from "../../menus/context_menu_utils";
import { t } from "../../services/i18n";
import { clearLabelOnNotes, setLabelOnNotes, shared } from "../../services/note_set";
+import options from "../../services/options";
import { promotedAttributeIcon } from "../attribute_widgets/attribute_types";
import type { PromotedAttribute } from "./promoted_attributes";
@@ -30,9 +33,10 @@ export interface AttributeMenuOptions {
* Builds the section a collection's item menu uses to set the values shown on an item, so a flag or
* a state changes without opening the note.
*
- * Lists the attributes the items draw, in the order they are drawn, and only the two types a menu
- * can hold: `boolean`, which the entry marks and toggles, and `select`, whose options open in a
- * submenu. The other types need a field to type into and stay in the attribute editor. An
+ * Lists the attributes the items draw, in the order they are drawn, and only the types a menu can
+ * hold: `boolean`, which the entry marks and toggles, `select`, whose options open in a submenu,
+ * and `date`, whose submenu offers a few dates relative to today. The other types need a field to
+ * type into and stay in the attribute editor. An
* attribute the items define in different ways is left out, since one item's options might not
* apply to another.
*
@@ -56,6 +60,10 @@ export function buildAttributeMenuItems<T>({
return [ buildSelectItem<T>(notes, attribute, attribute.selectOptions) ];
}
+ if (attribute.labelType === "date") {
+ return [ buildDateItem<T>(notes, attribute) ];
+ }
+
return [];
});
@@ -120,6 +128,47 @@ function buildSelectItem<T>(
};
}
+/**
+ * A `date`, with Not set and then today, tomorrow and the first day of next week in a submenu,
+ * stored as `YYYY-MM-DD` like the field's own date input. The entry the items' value matches is
+ * marked; a date the submenu does not offer marks nothing.
+ */
+function buildDateItem<T>(notes: FNote[], attribute: PromotedAttribute): MenuCommandItem<T> {
+ const current = shared(notes, (note) => note.getLabelValue(attribute.name));
+ const today = dayjs().startOf("day");
+ const dates: [ string, Dayjs ][] = [
+ [ t("attribute_menu.today"), today ],
+ [ t("attribute_menu.tomorrow"), today.add(1, "day") ],
+ [ t("attribute_menu.next-week"), startOfNextWeek(today) ]
+ ];
+
+ return {
+ ...attributeEntry<T>(attribute),
+ items: [
+ {
+ title: menuName(t("attribute_menu.not-set")),
+ trailingIcon: current.agreed && !current.value ? CHECK : undefined,
+ handler: () => { void clearLabelOnNotes(notes, attribute.name); }
+ },
+ { kind: "separator" },
+ ...dates.map<MenuItem<T>>(([ title, date ]) => {
+ const value = date.format("YYYY-MM-DD");
+ return {
+ title: menuName(title),
+ trailingIcon: current.agreed && current.value === value ? CHECK : undefined,
+ handler: () => { void setLabelOnNotes(notes, attribute.name, value); }
+ };
+ })
+ ]
+ };
+}
+
+/** The first day of the week after `today`'s, as the `firstDayOfWeek` option sets it (0 is Sunday). */
+function startOfNextWeek(today: Dayjs) {
+ const firstDayOfWeek = options.getInt("firstDayOfWeek") ?? 1;
+ return getWeekStartDate(today, firstDayOfWeek === 0 ? 7 : firstDayOfWeek).add(7, "day");
+}
+
/** What every entry carries: the attribute's display name, under the icon of its type. */
function attributeEntry<T>(attribute: PromotedAttribute): MenuCommandItem<T> {
return {
diff --git a/apps/server/src/assets/help/help_content.json b/apps/server/src/assets/help/help_content.json
index c0b599a09f..a9b0776d71 100644
--- a/apps/server/src/assets/help/help_content.json
+++ b/apps/server/src/assets/help/help_content.json
@@ -175,7 +175,7 @@
"_help_GTwFsgaA0lCt": "<p>Collections are a unique type of note that don't have content, but instead display their child notes in various presentation methods.</p><h2>Main collections</h2><div class=\"trilium-tabs\"><section class=\"trilium-tab\"><p class=\"trilium-tab-title\"><span class=\"tn-icon bx bx-calendar\"></span>&nbsp;Calendar</p><div class=\"trilium-tab-panel\"><p><a class=\"reference-link\" href=\"#root/_help_xWbu3jpNWapp\">Calendar</a>&nbsp;displays a week, month or year calendar with the notes being shown as events. New events can be added easily by dragging across the calendar.</p><figure class=\"image\"><img style=\"aspect-ratio:1651/810;\" src=\"{{helpAssets}}/User%20Guide/Collections_collection_calendar.webp\" width=\"1651\" height=\"810\"></figure></div></section><section class=\"trilium-tab\"><p class=\"trilium-tab-title\"><span class=\"tn-icon bx bx-table\"></span>&nbsp;Table</p><div class=\"trilium-tab-panel\"><p><a class=\"reference-link\" href=\"#root/_help_2FvYrpmOXm29\">Table</a>&nbsp;displays each note as a row in a table, with&nbsp;<a class=\"reference-link\" href=\"#root/_help_OFXdgB2nNk1F\">Promoted Attributes</a>&nbsp;being shown as well. This makes it easy to visualize attributes of notes, as well as making them easily editable.</p><figure class=\"image\"><img style=\"aspect-ratio:1643/647;\" src=\"{{helpAssets}}/User%20Guide/Collections_collection_table.webp\" width=\"1643\" height=\"647\"></figure></div></section><section class=\"trilium-tab\"><p class=\"trilium-tab-title\"><span class=\"tn-icon bx bx-columns\"></span>&nbsp;Kanban Board</p><div class=\"trilium-tab-panel\"><p><a class=\"reference-link\" href=\"#root/_help_CtBQqbwXDx1w\">Kanban Board</a>&nbsp;displays notes in columns, grouped by the value of a label. Items and columns can easily be created or dragged around to change their status.</p><figure class=\"image\"><img style=\"aspect-ratio:1174/850;\" src=\"{{helpAssets}}/User%20Guide/Collections_collection_board.webp\" width=\"1174\" height=\"850\"></figure></div></section><section class=\"trilium-tab\"><p class=\"trilium-tab-title\"><span class=\"tn-icon bx bx-map-alt\"></span>&nbsp;Geo Map</p><div class=\"trilium-tab-panel\"><p><a class=\"reference-link\" href=\"#root/_help_81SGnPGMk7Xc\">Geo Map</a>&nbsp;which displays a geographical map in which the notes are represented as pins on the map. New markers can be easily added by pointing on the map. In addition <a href=\"#root/_help_C2H9HK4BzwG7\">shapes</a> such as paths, rectangles and circles can be added, as well as GPX tracks.</p><figure class=\"image\"><img style=\"aspect-ratio:844/639;\" src=\"{{helpAssets}}/User%20Guide/Collections_collection_geomap.webp\" width=\"844\" height=\"639\"></figure></div></section><section class=\"trilium-tab\"><p class=\"trilium-tab-title\"><span class=\"tn-icon bx bx-slideshow\"></span>&nbsp;Presentation</p><div class=\"trilium-tab-panel\"><p><a class=\"reference-link\" href=\"#root/_help_zP3PMqaG71Ct\">Presentation</a>&nbsp;which shows each note as a slide and can be presented full-screen with smooth transitions or exported to PDF for sharing.</p><figure class=\"image\"><img style=\"aspect-ratio:1120/763;\" src=\"{{helpAssets}}/User%20Guide/Collections_collection_presentation.webp\" width=\"1120\" height=\"763\"></figure></div></section></div><h2>Classic collections</h2><p>Classic collections are read-only mode and compiles the contents of all child notes into one continuous view. This makes it ideal for reading extensive information broken into smaller, manageable segments.</p><ul><li><a class=\"reference-link\" href=\"#root/_help_8QqnMzx393bx\">Grid View</a>&nbsp;which is the default presentation method for child notes (see&nbsp;<a class=\"reference-link\" href=\"#root/_help_0ESUbbAxVnoK\">Note List</a>), where the notes are displayed as tiles with their title and content being visible.</li><li><a class=\"reference-link\" href=\"#root/_help_mULW0Q3VojwY\">List View</a>&nbsp;is similar to&nbsp;<a class=\"reference-link\" href=\"#root/_help_8QqnMzx393bx\">Grid View</a>, but it displays the notes one under the other with the content being expandable/collapsible, but also works recursively.</li></ul><p>Classic collections make use of pagination to support a large number of notes. The size of a page can be customized via <code>pageSize</code>.</p><h2>Creating a new collection</h2><p>To create a new collection, right-click a note in the&nbsp;<a class=\"reference-link\" href=\"#root/_help_oPVyFC7WL2Lp\">Note Tree</a>&nbsp;and select <em>Insert child note</em> → <em>Collection</em> → the desired type.</p><p>By default, collections come with a default configuration and sometimes even sample notes. To create a collection completely from scratch:</p><ol><li>Create a new note of type <em>Text</em> (or any type).</li><li>Change the <a href=\"#root/_help_KSZ04uQ2D1St\">note type</a> to <em>Collection</em>.</li><li>In&nbsp;<a class=\"reference-link\" href=\"#root/_help_CssoWBu8I7jF\">Collection Properties</a>, select the desired view type.</li><li>Consult the help page of the corresponding view type in order to understand how to configure them.</li></ol><h2>Configuration</h2><p>To change the configuration of a collection or even switch to a different collection (e.g. from Kanban Board to a Calendar), see the&nbsp;<a class=\"reference-link\" href=\"#root/_help_CssoWBu8I7jF\">Collection Properties</a>&nbsp;bar at the top of the note.</p><h2>Archived notes</h2><p>By default, <a href=\"#root/_help_MKmLg5x6xkor\">archived notes</a> will not be shown in collections. This behavior can be changed by going to&nbsp;<a class=\"reference-link\" href=\"#root/_help_CssoWBu8I7jF\">Collection Properties</a>&nbsp;and checking <em>Show archived notes</em>.</p><p>Archived notes will be generally indicated by being greyed out as opposed to the normal ones.</p><h2>Hiding the child notes from the note tree</h2><p>For collections with a large number of items, it can be helpful to hide the items from the note tree for performance reasons and to reduce clutter. This is especially useful for standalone collections, such as a geomap or a task board.</p><p>To do so, go to&nbsp;<a class=\"reference-link\" href=\"#root/_help_CssoWBu8I7jF\">Collection Properties</a>&nbsp;and select <em>Hide child notes in tree</em>.</p><h2>Advanced use cases</h2><h3>Adding a description to a collection</h3><p>To add a text before the collection, for example to describe it:</p><ol><li>Create a new collection.</li><li>Change the <a href=\"#root/_help_KSZ04uQ2D1St\">note type</a> from <em>Collection</em> to <em>Text</em>.</li></ol><p>Now the text will be displayed above while still maintaining the collection view.</p><p>The only downside to this method is that&nbsp;<a class=\"reference-link\" href=\"#root/_help_CssoWBu8I7jF\">Collection Properties</a>&nbsp;will not be shown anymore. In this case, modify the attributes manually or switch back temporarily to the <em>Collection</em> type for configuration purposes.</p><h3>Using saved search</h3><p>Collections, by default, only display the child notes. However, it is possible to use the&nbsp;<a class=\"reference-link\" href=\"#root/_help_eIg8jdvaoNNd\">Search</a>&nbsp;functionality to display notes all across the tree, with advanced querying functionality.</p><p>To do so, simply start a&nbsp;<a class=\"reference-link\" href=\"#root/_help_eIg8jdvaoNNd\">Search</a>&nbsp;and go to the&nbsp;<a class=\"reference-link\" href=\"#root/_help_CssoWBu8I7jF\">Collection Properties</a>&nbsp;and select a desired type of collection. To keep the search-based collection, use a&nbsp;<a class=\"reference-link\" href=\"#root/_help_m523cpzocqaD\">Saved Search</a>.</p><aside class=\"admonition important\"><p>While in search, none of the collections will not display the child notes of the search results. The reason is that the search might hit a note multiple times, causing an exponential rise in the number of results.</p></aside><h2>Under the hood</h2><p>Collections by themselves are simply notes with no content that rely on the&nbsp;<a class=\"reference-link\" href=\"#root/_help_0ESUbbAxVnoK\">Note List</a>&nbsp;mechanism (the one that lists the children notes at the bottom of a note) to display information.</p><p>By default, new collections use predefined&nbsp;<a class=\"reference-link\" href=\"#root/_help_KC1HB96bqqHX\">Templates</a>&nbsp;that are stored safely in the&nbsp;<a class=\"reference-link\" href=\"#root/_help_2mUhVmZK8RF3\">Hidden Notes</a>&nbsp;to define some basic configuration such as the type of view, but also some&nbsp;<a class=\"reference-link\" href=\"#root/_help_OFXdgB2nNk1F\">Promoted Attributes</a>&nbsp;to make editing easier.</p><p>Collections don't store their configuration (e.g. the position on the map, the hidden columns in a table) in the content of the note itself, but as attachments.</p>",
"_help_xWbu3jpNWapp": "<figure class=\"image\"><img style=\"aspect-ratio:2016/1413;\" src=\"{{helpAssets}}/User%20Guide/Collections/1_Calendar_image.png\" width=\"2016\" height=\"1413\"></figure><p>The Calendar view will display each child note in a calendar that has a start date and optionally an end date, as an event.</p><p>The Calendar view has multiple display modes:</p><ul><li>Month view, where the entire month is displayed and all-day events can be inserted. Both time-specific events and all-day events are listed.</li><li>Week view, where all the 7 days of the week (or 5 if the weekends are hidden) are displayed in columns. This mode allows entering and displaying time-specific events, not just all-day events.</li><li>Day view, which views only a single day. Especially useful for heavy agendas or mobile views.</li><li>List view, which displays all the events of a given month in sequence.</li><li>Year view, which displays the entire year for quick reference.</li></ul><p>Unlike other Collection view types, the Calendar view also allows some kind of interaction, such as moving events around as well as creating new ones.</p><h2>Creating a calendar</h2><p>Right click on an existing note in the&nbsp;<a class=\"reference-link\" href=\"#root/_help_oPVyFC7WL2Lp\">Note Tree</a>&nbsp;and select <em>Insert child note</em> → <em>Collection</em> → <em>Calendar</em>.</p><h2>Creating a new event/note</h2><p>To create a new event:</p><ul><li>First, click the desired day (month &amp; year views) or the desired timeslot (day view).</li><li>Alternatively, drag across multiple days (or time slots) to set both the start and end date.</li></ul><p>In either cases, a small popup will show with a prompt for a title and the date &amp; time of the event that will be created. The date and time can be changed there the same way as in the popup view of an existing event (see below).</p><p>At this point, the event hasn't been created yet to protect against accidental clicks. Add a title optionally and press the <em>Create</em> button. If no title is provided, the event will follow the&nbsp;<a class=\"reference-link\" href=\"#root/_help_47ZrP6FNuoG8\">Default Note Title</a>&nbsp;rules.</p><p>The <span class=\"tn-icon bx bx-detail\"></span> template field below the date and time shows the note type or template the event's note is made from. To make the event from another one, press the field and select it from the list; the calendar remembers the choice for the next event. Select <em>More templates…</em> to change which templates are listed (see <a href=\"#event-templates\">Event templates</a>). The date and time entered for the event replace any dates and times the template carries.</p><p>To give the event a time before creating it (for example, after clicking a day in the month view), press <em>Add time</em> and set the start and end time; the duration is shown to the right of them. To make the event all-day again, press the <span class=\"tn-icon bx bx-x\"></span> button at the end of the row. Adding or removing a time keeps the dates, so an event can start at a time on one day and end at a time on another (for example, a night shift). Changing the start date or time moves the end by the same amount, keeping the duration. An empty end date means the event ends on the day it starts; setting the end time before the start time moves the end date to the next day.</p><p>After creating the event, it will show up on the calendar. To edit the content of the event (including recurrence), click on it to bring it into the popup view.</p><aside class=\"admonition note\"><p>Creating new notes from the calendar will respect the <code>~child:template</code> relation if set on the Collection note.</p></aside><h2>Interacting with events</h2><ul><li>Hovering the mouse over an event will display information about the note.<br><img src=\"{{helpAssets}}/User%20Guide/Collections/4_Calendar_image.png\"></li><li>Left clicking the event will open a&nbsp;dedicated popup to quickly configure the event or edit its note content.</li><li>Right click will offer more options including opening the note in a new split or window.</li><li>Drag and drop an event on the calendar to move it to another day.</li><li>The length of an event can be changed by placing the mouse to the right edge of the event and dragging the mouse around.</li></ul><p>On a <a href=\"#root/_help_CoFPLs3dRlXc\">read-only</a> calendar, events can't be dragged, resized or created, their context menu only offers the places to open them in, and the button to pin the current date is hidden. Switching between the month, week and day views still works, but the choice isn't saved.</p><h3>Popup view</h3><p>When an event is clicked, a popup will show near the event which contains the following inforamtion:</p><ul><li>The title and icon of the event, both editable.</li><li>Buttons to interact with the event:<ul><li>Open the event in the same pane, new tab, etc.</li><li>Color picker to change the color of the event.</li><li>Button to remove the event from the calendar, which can optionally delete its corresponding note.</li></ul></li><li>Calendar-specific features:<ul><li>The start date and, for an event spanning several days, the end date.</li><li>The start and end time with the duration to the right of them, and a <span class=\"tn-icon bx bx-x\"></span> button that removes the time, making the event all-day. An all-day event shows an <em>Add time</em> button instead.</li><li>A full recurrence editor, opened from the dropdown below the time, to have the same event show up weekly, monthly, etc.</li></ul></li><li>The&nbsp;<a class=\"reference-link\" href=\"#root/_help_OFXdgB2nNk1F\">Promoted Attributes</a>&nbsp;of the marker, if any.</li><li>The note's content which can be edited directly from the panel.</li></ul><p>To dismiss the popup:</p><ul><li>Press the X button at the top-right of the popup.</li><li>In the calendar, press anywhere outside the popup.</li><li>Or simply press the <kbd>Escape</kbd> key.</li></ul><p>It is possible to switch between events by clicking on them even when the popup view is already open.</p><p>Events can have&nbsp;<a class=\"reference-link\" href=\"#root/_help_hrZ1D00cLbal\">Internal (reference) links</a>&nbsp;between them and clicking on such a link will automatically navigate the calendar to the right date and the popup view to the new note.</p><h2>Interaction on mobile</h2><p>When Trilium is on mobile, the interaction with the calendar is slightly different:</p><ul><li>Clicking on an event displays the popup view, which allows editing the event.</li><li>Long-presing an event triggers the contextual menu, including the option to open in&nbsp;<a class=\"reference-link\" href=\"#root/_help_ZjLYv08Rp3qC\">Quick edit</a>.</li><li>To insert a new event, touch and hold the empty space. When successful, the empty space will become colored to indicate the selection.<ul><li>Before releasing, drag across multiple spaces to create multi-day events.</li><li>When released, a prompt will appear to enter the note title.</li></ul></li><li>To move an existing event, touch and hold the event until the empty space near it will become colored.<ul><li>At this point the event can be dragged across other days on the calendar.</li><li>Or the event can be resized by tapping on the small circle to the right end of the event.</li><li>To exit out of editing mode, simply tap the empty space anywhere on the calendar.</li></ul></li></ul><h2>Configuring the calendar view</h2><p>In the&nbsp;<a class=\"reference-link\" href=\"#root/_help_CssoWBu8I7jF\">Collection Properties</a>, it's possible to:</p><ul><li>Hide weekends from the week view.</li><li>Display week numbers on the calendar.</li><li>Hide routine events from the month, year and list views (see <a href=\"#hiding-routine-events\">Hiding routine events</a>).</li><li>Set the slot duration (the length of each time row in day/week view).</li><li>Set the slot label interval (how often time labels appear on the axis in day/week view).</li></ul><p>The same settings are also listed under <em>General</em> in the <span class=\"tn-icon bx bx-cog\"></span> <em>Calendar properties</em> dialog (see <a href=\"#event-templates\">Event templates</a> for how to open it). The time slots are listed there whichever view the calendar is in. Its <em>Included notes</em> section sets whether archived notes are shown and how deep the calendar looks for events (see <a href=\"#limiting-the-depth\">Limiting the depth</a>).</p><h3>Event templates</h3><p>By default, a new event is a&nbsp;<a class=\"reference-link\" href=\"#root/_help_iPIMuisry3hd\">Text</a> note. To make events from other note types, or from&nbsp;<a class=\"reference-link\" href=\"#root/_help_KC1HB96bqqHX\">Templates</a> with predefined content and attributes (such as a color), open the <span class=\"tn-icon bx bx-cog\"></span> <em>Calendar properties</em> dialog from the&nbsp;<a class=\"reference-link\" href=\"#root/_help_8YBEPzcpUgxw\">Note menu</a> or from the settings menu of the&nbsp;<a class=\"reference-link\" href=\"#root/_help_CssoWBu8I7jF\">Collection Properties</a>, and find <em>Event templates</em>. Here you can:</p><ul><li>Include a note type or note template already created in your knowledge base by pressing the <span class=\"tn-icon bx bx-list-plus\"></span> <em>Add existing template</em> button and then selecting the desired note type or template.</li><li>Create a new template by pressing the <span class=\"tn-icon bx bx-plus\"></span> <em>Create a new template</em> button. The template is created as a child of the calendar, and is not shown as an event.</li><li>Press the <span class=\"tn-icon bx bx-x\"></span> button to remove a template from the list. The template is removed only from the list, not deleted.</li><li>Press the <span class=\"tn-icon bx bx-dots-vertical-rounded\"></span> button of a custom template to edit, open in a new window, duplicate, or delete it.</li><li>Drag a template by its handle to reorder the list shown when creating an event.</li></ul><p>The dialog is not available on a read-only calendar, or on a calendar marked with <code>#calendarRoot</code> or <code>#workspaceCalendarRoot</code> (see <a href=\"#using-with-the-journal--calendar\">Using with the Journal / calendar</a>).</p><h3>Event attributes</h3><p>Events can show the values of their attributes below their title, in the month view, and in the week and day views for all-day events and for timed ones tall enough to hold them. To choose which attributes are shown, open the <span class=\"tn-icon bx bx-cog\"></span> <em>Calendar properties</em> dialog (see <a href=\"#event-templates\">Event templates</a> for how to open it) and find <em>Event attributes</em>. It lists the <a class=\"reference-link\" href=\"#root/_help_OFXdgB2nNk1F\">Promoted Attributes</a> the calendar defines, and those its events define themselves. Here you can:</p><ul><li>Turn an attribute on to show it on the events. New attributes are hidden until you turn them on, which keeps the calendar from getting cluttered.</li><li>Drag an attribute by its handle to change the order in which the events show them.</li><li>Create a new attribute, which is shown on the events right away, or edit or delete one the calendar defines.</li></ul><p>The dates, times and recurrence of the events are not listed, as the calendar always shows them itself.</p><p>If an event has a <code>#calendar:displayedAttributes</code> label, including one inherited from the calendar, the attributes listed in that label are shown instead.</p><h2>Configuring the calendar using attributes</h2><p>The following attributes can be added to the Collection type:</p><figure class=\"table\"><table><thead><tr><th>Name</th><th>Description</th></tr></thead><tbody><tr><td><code>#calendar:hideWeekends</code></td><td>When present (regardless of value), it will hide Saturday and Sundays from the calendar.</td></tr><tr><td><code>#calendar:weekNumbers</code></td><td>When present (regardless of value), it will show the number of the week on the calendar.</td></tr><tr><td><code>#calendar:hideRoutineEvents</code></td><td>When present (regardless of value), it will hide routine events from the month, year and list views. See <a href=\"#hiding-routine-events\">Hiding routine events</a>.</td></tr><tr><td><code>#calendar:initialDate</code></td><td>Change the date the calendar opens on. When not present, the calendar opens on the current date.</td></tr><tr><td><code>#calendar:view</code></td><td><p>Which view to display in the calendar:</p><ul><li><code>timeGridDay</code> for the <em>day</em> view;</li><li><code>timeGridWeek</code> for the <em>week</em> view;</li><li><code>dayGridMonth</code> for the <em>month</em> view;</li><li><code>multiMonthYear</code> for the <em>year</em> view;</li><li><code>listMonth</code> for the <em>list</em> view.</li></ul><p>Any other value will be dismissed and the default view (month) will be used instead.</p><p>The value of this label is automatically updated when changing the view using the UI buttons.</p></td></tr><tr><td><code>#calendar:slotDuration</code></td><td>Sets how long each timeslot is on the calendar. Defaults to <code>00:15:00</code> (15 minutes). Must have the format \"HH:MM:SS\". For example, to create timeslots for every 10 minutes, you would set <code>#calendar:slotDuration=\"00:10:00\"</code>.</td></tr><tr><td><code>#calendar:slotLabelInterval</code></td><td>Sets how often the timeslots on the calendar should be labeled. Defaults to <code>01:00:00</code> (1 hour). Must have the format \"HH:MM:SS\". For example, to label timeslots every 30 minutes, you would set <code>#calendar:slotLabelInterval=\"00:30:00\"</code>.</td></tr><tr><td><code>~child:template</code></td><td>Defines the template for newly created notes in the calendar (via dragging or clicking).</td></tr></tbody></table></figure><p>In addition, the first day of the week can be either Sunday or Monday and can be adjusted from the application settings.</p><h2>Configuring the calendar events using attributes</h2><p>For each note of the calendar, the following attributes can be used:</p><figure class=\"table\"><table><thead><tr><th>Name</th><th>Description</th></tr></thead><tbody><tr><td><code>#startDate</code></td><td>The date the event starts, which will display it in the calendar. The format is <code>YYYY-MM-DD</code> (year, month and day separated by a minus sign).</td></tr><tr><td><code>#endDate</code></td><td>Similar to <code>startDate</code>, mentions the end date if the event spans across multiple days. The date is inclusive, so the end day is also considered. The attribute can be missing for single-day events.</td></tr><tr><td><code>#startTime</code></td><td>The time the event starts at. If this value is missing, then the event is considered a full-day event. The format is <code>HH:MM</code> (hours in 24-hour format and minutes).</td></tr><tr><td><code>#endTime</code></td><td>Similar to <code>startTime</code>, it mentions the time at which the event ends (in relation with <code>endDate</code> if present, or <code>startDate</code>).</td></tr><tr><td><code>#recurrence</code></td><td>This is an optional CalDAV <code>RRULE</code> string that if present, determines whether a task should repeat or not. Note that it does not include the <code>DTSTART</code> attribute, which is derived from the <code>#startDate</code> and <code>#startTime</code> directly. For examples of valid <code>RRULE</code> strings see <a href=\"https://icalendar.org/rrule-tool.html\">https://icalendar.org/rrule-tool.html</a></td></tr><tr><td><code>#color</code></td><td>Displays the event with a specified color (named such as <code>red</code>, <code>gray</code> or hex such as <code>#FF0000</code>). This will also change the color of the note in other places such as the note tree.</td></tr><tr><td><code>#calendar:color</code></td><td><strong>❌️ Removed since v0.100.0. Use</strong> <code>#color</code> <strong>instead.</strong>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; <br> <br>Similar to <code>#color</code>, but applies the color only for the event in the calendar and not for other places such as the note tree.</td></tr><tr><td><code>#iconClass</code></td><td>If present, the icon of the note will be displayed to the left of the event title.</td></tr><tr><td><code>#calendar:title</code></td><td>Changes the title of an event to point to an attribute of the note other than the title, can either a label or a relation (without the <code>#</code> or <code>~</code> symbol). See <em>Use-cases</em> for more information.</td></tr><tr><td><code>#calendar:titleTemplate</code></td><td>Changes the title an event is displayed with on the calendar, filled in again for every occurrence of a repeating event. See <em>Use-cases</em> for displaying an age on a birthday.</td></tr><tr><td><code>#calendar:displayedAttributes</code></td><td>Takes precedence over the <a href=\"#event-attributes\">Event attributes</a> chosen in the calendar's properties. Allows displaying the value of one or more attributes in the calendar, in the order given, like this:&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; <br> <br><img src=\"{{helpAssets}}/User%20Guide/Collections/6_Calendar_image.png\"> &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; <br> <br><code>#weight=\"70\" #Mood=\"Good\" #calendar:displayedAttributes=\"weight,Mood\"</code>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; <br> <br>It can also be used with relations, case in which it will display the title of the target note:&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; <br> <br><code>~assignee=@My assignee #calendar:displayedAttributes=\"assignee\"</code></td></tr><tr><td><code>#calendar:startDate</code></td><td>Allows using a different label to represent the start date, other than <code>startDate</code> (e.g. <code>expiryDate</code>). The label name <strong>must not be</strong> prefixed with <code>#</code>. If the label is not defined for a note, the default will be used instead.</td></tr><tr><td><code>#calendar:endDate</code></td><td>Similar to <code>#calendar:startDate</code>, allows changing the attribute which is being used to read the end date.</td></tr><tr><td><code>#calendar:startTime</code></td><td>Similar to <code>#calendar:startDate</code>, allows changing the attribute which is being used to read the start time.</td></tr><tr><td><code>#calendar:endTime</code></td><td>Similar to <code>#calendar:startDate</code>, allows changing the attribute which is being used to read the end time.</td></tr></tbody></table></figure><h2>How the calendar works</h2><p><img src=\"{{helpAssets}}/User%20Guide/Collections/8_Calendar_image.png\"></p><p>The calendar displays all the child notes of the Collection that have a <code>#startDate</code>. An <code>#endDate</code> can optionally be added.</p><p>A text note with a start date is shown with the <span class=\"tn-icon bx bx-calendar-event\"></span> icon in the note tree and elsewhere, unless it has an icon of its own (set with <code>#iconClass</code>). The start date is read from the label <code>#calendar:startDate</code> names, if any.</p><p>The start date &amp; end date can easily be edited from the calendar collection itself by clicking on the event. To edit the date while in the event note itself, the following attributes can be added to the Collection note:</p><pre><code class=\"language-text-x-trilium-auto\">#viewType=calendar #label:startDate(inheritable)=\"promoted,alias=Start Date,single,date\"\n#label:endDate(inheritable)=\"promoted,alias=End Date,single,date\"\n#hidePromotedAttributes </code></pre><p>This will result in:</p><p><img src=\"{{helpAssets}}/User%20Guide/Collections/7_Calendar_image.png\"></p><p>When not used in a Journal, the calendar is recursive. That is, it will look for events not just in its child notes but also in the children of these child notes.</p><h3>Limiting the depth</h3><p>To limit how deep the calendar looks for events, set <em>Maximum nesting depth</em> under <em>Included notes</em> in the <span class=\"tn-icon bx bx-cog\"></span><em>Calendar properties</em> dialog (see <a href=\"#event-templates\">Event templates</a> for how to open it), or the <code>#maxNestingDepth</code> label: <code>0</code> shows only the child notes, <code>1</code> adds their children, and so on. Without a value, events are looked for at every level. The setting doesn't apply in a Journal.</p><h2>Recurrence</h2><p>The built in calendar view also supports repeating tasks (e.g. every week, every month as well as more complex recurrency rules).</p><p>Starting with v0.105.0, recurrence can be directly edited from the calendar by clicking on an event and then selecting the <em>Repeats</em> option.</p><h3>Custom recurrence using a subset of RRULE</h3><p>If the existing recurrence editor from the event popup is not sufficient, more complex rules can be manually set via the <code>#recurrence</code> label.</p><p>For example, to make a note repeat on the calendar:</p><ul><li>Every Day - <code>#recurrence=\"FREQ=DAILY;INTERVAL=1\"</code></li><li>Every 3 days - <code>#recurrence=\"FREQ=DAILY;INTERVAL=3\"</code></li><li>Every week - <code>#recurrence=\"FREQ=WEEKLY;INTERVAL=1\"</code></li><li>Every 2 weeks on Monday, Wednesday and Friday - <code>#recurrence=\"FREQ=WEEKLY;INTERVAL=2;BYDAY=MO,WE,FR\"</code></li><li>Every 3 months - <code>#recurrence=\"FREQ=MONTHLY;INTERVAL=3\"</code></li><li>Every 2 months on the First Sunday - <code>#recurrence=\"FREQ=MONTHLY;INTERVAL=2;BYDAY=1SU\"</code></li><li>Every month on the Last Friday - <code>#recurrence=\"FREQ=MONTHLY;INTERVAL=1;BYDAY=-1FR\"</code></li></ul><p>For other examples of valid <code>RRULE</code> strings see <a href=\"https://icalendar.org/rrule-tool.html\">https://icalendar.org/rrule-tool.html</a></p><p>Note that the recurrence string does not include the <code>DTSTART</code> attribute as defined in the iCAL specifications. This is derived directly from the <code>startDate</code> and <code>startTime</code> attributes</p><p>If you want to override the label the calendar uses to fetch the recurrence string, you can use the <code>#calendar:recurrence</code> attribute. For example, you can set <code>#calendar:recurrence=taskRepeats</code>. Then you can set your recurrence string like <code>#taskRepeats=\"FREQ=DAILY;INTERVAL=1\"</code></p><p>Also note that the recurrence label can be made promoted as with the start and end dates.&nbsp;</p><aside class=\"admonition warning\"><p>If the recurrence string is not valid, a toast will be shown with the note ID and title of the note with the erroneous recurrence message. This note will not be added to the calendar</p></aside><h3>Hiding routine events</h3><p>Events that repeat on most days of the week, such as sleep or working hours, fill every cell of the month view. To hide them from the views that show many days at once, check <em>Hide routine events</em> in the <a class=\"reference-link\" href=\"#root/_help_CssoWBu8I7jF\">Collection Properties</a> (or set <code>#calendar:hideRoutineEvents</code>).</p><p>An event counts as routine when it has a start time and repeats on 4 or more days a week on average, for example:</p><figure class=\"table\"><table><thead><tr><th>Event</th><th>Days a week</th><th>Hidden from the month, year and list views</th></tr></thead><tbody><tr><td>Every day from 23:00 to 07:00</td><td>7</td><td>Yes</td></tr><tr><td>Monday to Friday from 09:00 to 17:00</td><td>5</td><td>Yes</td></tr><tr><td>Every other day at 07:00</td><td>3.5</td><td>No</td></tr><tr><td>Monday, Wednesday and Friday at 18:00</td><td>3</td><td>No</td></tr><tr><td>Every day, without a start time</td><td>7</td><td>No, as it lasts the whole day</td></tr><tr><td>Every month or every year</td><td>—</td><td>No</td></tr></tbody></table></figure><p>The day and week views always show routine events. To show them everywhere again, uncheck the option.</p><h2>Customizing the slot duration and label interval</h2><p>Time slots in day and week views can be customized from&nbsp;<a class=\"reference-link\" href=\"#root/_help_CssoWBu8I7jF\">Collection Properties</a></p><ul><li><em>Slot duration</em> controls how tall each time slot is on the calendar (essentially the smallest unit of time the grid is divided into).<ul><li>A shorter duration means more rows and finer granularity; a longer one means fewer, chunkier rows.</li><li>The default is one row every 15 minutes.</li></ul></li><li><em>Label interval</em> controls how often a time label appears on the left-hand axis.<ul><li>This is independent of the slot size: you can have very small slots but only label every hour to keep the axis readable.</li><li>The default is a time label shown every hour.</li></ul></li></ul><aside class=\"admonition note\"><p>These values can also be customized directly via the <code>#calendar:slotDuration</code> and <code>#calendar:slotLabelInterval</code> <a href=\"#root/_help_HI6GBBIduIgv\">labels</a>. Both values use <code>HH:mm:ss</code> format. Hours can go up to <code>24</code> (<code>24:00:00</code>), while minutes and seconds must be between <code>00</code> and <code>59</code>. The minimum meaningful duration is 1 minute (<code>00:01:00</code>).</p></aside><h2>Use-cases</h2><h3>Using with the Journal / calendar</h3><p>It is possible to integrate the calendar view into the Journal with day notes. In order to do so change the note type of the Journal note (calendar root) to Collection and then select the Calendar View.</p><p>While in journal mode, the popup editor will not show dates, recurrence, colors or removal, since day notes aren't editable events.</p><p>Based on the <code>#calendarRoot</code> (or <code>#workspaceCalendarRoot</code>) attribute, the calendar will know that it's in a calendar and apply the following:</p><ul><li>The calendar events are now rendered based on their <code>dateNote</code> attribute rather than <code>startDate</code>.</li><li>Interactive editing such as dragging over an empty era or resizing an event is no longer possible.</li><li>Clicking on the empty space on a date will automatically open that day's note or create it if it does not exist.</li><li>Direct children of a day note will be displayed on the calendar despite not having a <code>dateNote</code> attribute. Children of the child notes will not be displayed.</li></ul><img src=\"{{helpAssets}}/User%20Guide/Collections/5_Calendar_image.png\" width=\"1217\" height=\"724\"><h3>Using a different attribute as event title</h3><p><img class=\"image-style-align-right\" src=\"{{helpAssets}}/User%20Guide/Collections/2_Calendar_image.png\" width=\"445\" height=\"124\">By default, events are displayed on the calendar by their note title. However, it is possible to configure a different attribute to be displayed instead.</p><p>To do so, assign <code>#calendar:title</code> to the child note (not the calendar/Collection note), with the value being <code>name</code> where <code>name</code> can be any label (make not to add the <code>#</code> prefix). The attribute can also come through inheritance such as a template attribute. If the note does not have the requested label, the title of the note will be used instead.</p><pre><code class=\"language-text-x-trilium-auto\">#startDate=2025-02-11 #endDate=2025-02-13 #name=\"My vacation\" #calendar:title=\"name\"</code></pre><h3>Using a relation attribute as event title</h3><p><img class=\"image-style-align-right image_resized\" style=\"aspect-ratio:294/151;width:21.22%;\" src=\"{{helpAssets}}/User%20Guide/Collections/3_Calendar_image.png\" width=\"294\" height=\"151\">Similarly to using an attribute, use <code>#calendar:title</code> and set it to <code>name</code> where <code>name</code> is the name of the relation to use.</p><p>Moreover, if there are more relations of the same name, they will be displayed as multiple events coming from the same note.</p><pre><code class=\"language-text-x-trilium-auto\">#startDate=2025-02-14 #endDate=2025-02-15 ~for=@John Smith ~for=@Jane Doe #calendar:title=\"for\"</code></pre><p><img class=\"image-style-align-left\" src=\"{{helpAssets}}/User%20Guide/Collections/Calendar_image.png\" width=\"296\" height=\"150\">Note that it's even possible to have a <code>#calendar:title</code> on the target note (e.g. “John Smith”) which will try to render an attribute of it. Note that it's not possible to use a relation here as well for safety reasons (an accidental recursion &nbsp;of attributes could cause the application to loop infinitely).</p><pre><code class=\"language-text-x-trilium-auto\">#calendar:title=\"shortName\" #shortName=\"John S.\"</code></pre><h3>Displaying an age on a recurring event</h3><p>A birthday or an anniversary repeats every year, and what is interesting about each occurrence is the number of years it marks. To display it:</p><ol><li>Set the event's start date to the original date (for example, the date of birth).</li><li>Click the event, then select the <em>Repeats</em> dropdown.</li><li>Select <em>Yearly</em> and check <em>Show the number of years in the title</em>.</li></ol><p>The event is then displayed as “John Smith (35)” in 2025, “John Smith (36)” in 2026, and so on. Only the calendar is affected; the note keeps its own title.</p><p>The checkbox sets the <code>#calendar:titleTemplate</code> label, which sets the title an event is displayed with and is filled in again for every occurrence the recurrence rule produces:</p><pre><code class=\"language-text-x-trilium-auto\">#startDate=1990-05-12 #recurrence=\"FREQ=YEARLY\" #calendar:titleTemplate=\"${title} (${years})\"</code></pre><p>To word the title differently, edit the label directly. The checkbox is then disabled, as it is when the template is inherited, so that it never overwrites a template of your own.</p><p>The following values can be used in the template:</p><figure class=\"table\"><table><thead><tr><th>Value</th><th>Description</th></tr></thead><tbody><tr><td><code>${title}</code></td><td>The title the event would otherwise be displayed with: the note title, or the attribute <code>#calendar:title</code> points to.</td></tr><tr><td><code>${years}</code></td><td>The whole years between <code>#startDate</code> and the occurrence being displayed. It is <code>0</code> on the first occurrence.</td></tr><tr><td><code>${date}</code></td><td>The date of the occurrence being displayed, as a <a href=\"https://day.js.org/docs/en/display/format\">day.js</a> object. For example, <code>${date.format('YYYY')}</code>.</td></tr><tr><td><code>${startDate}</code></td><td>The date the event starts on, in the same form. For example, <code>${startDate.format('YYYY')}</code>.</td></tr></tbody></table></figure><p>To use the same template for every event of a calendar, make the label inheritable on the Collection note:</p><pre><code class=\"language-text-x-trilium-auto\">#calendar:titleTemplate(inheritable)=\"${title} (${years})\"</code></pre><aside class=\"admonition note\"><p>A template that cannot be read — an unknown value, or an expression other than a value and the <code>format</code> call shown above — leaves the event with its plain title and reports the reason in the browser console.</p></aside>",
"_help_2FvYrpmOXm29": "<figure class=\"image\"><img style=\"aspect-ratio:1050/259;\" src=\"{{helpAssets}}/User%20Guide/Collections/Table_image.png\" width=\"1050\" height=\"259\"></figure><p>The table view displays information in a grid, where the rows are individual notes and the columns are&nbsp;<a class=\"reference-link\" href=\"#root/_help_OFXdgB2nNk1F\">Promoted Attributes</a>. In addition, values are editable.</p><h2>How it works</h2><p>The tabular structure is represented as such:</p><ul><li>Each child note is a row in the table.</li><li>If child rows also have children, they will be displayed under an expander (nested notes).</li><li>Each column is a <a href=\"#root/_help_OFXdgB2nNk1F\">promoted attribute</a> that is defined on the Collection note.<ul><li>Actually, both promoted and unpromoted attributes are supported, but it's a requirement to use a label/relation definition.</li><li>The promoted attributes are usually defined as inheritable in order to show up in the child notes, but it's not a requirement.</li></ul></li><li>If there are multiple attribute definitions with the same <code>name</code>, only one will be displayed.</li><li>If an attribute definition has multiple values, they will all be grouped under a single column, with chips indicating individual values.</li></ul><p>There are also a few predefined columns:</p><ul><li>The current item number, identified by the <code>#</code> symbol.<ul><li>This simply counts the note and is affected by sorting.</li></ul></li><li><a class=\"reference-link\" href=\"#root/_help_m1lbrzyKDaRB\">Note ID</a>, representing the unique ID used internally by Trilium</li><li>The title of the note.</li></ul><h2>Interaction</h2><h3>Creating a new table</h3><p>Right click on an existing note in the&nbsp;<a class=\"reference-link\" href=\"#root/_help_oPVyFC7WL2Lp\">Note Tree</a>&nbsp;and select <em>Insert child note</em> → <em>Collection</em> → <em>Table</em>.</p><h3>Adding columns</h3><p>Each column is a <a href=\"#root/_help_OFXdgB2nNk1F\">promoted or unpromoted attribute</a> that is defined on the Collection note.</p><p>To create a new column, either:</p><ul><li>Press <em>Add new column</em> at the bottom of the table.</li><li>Right click on an existing column and select Add column to the left/right.</li><li>Right click on the empty space of the column header and select <em>Label</em> or <em>Relation</em> in the <em>New column</em> section.</li></ul><h3>Adding new rows</h3><p>Each row is actually a note that is a child of the Collection note.</p><p>To create a new note, either:</p><ul><li>Press <em>Add new row</em> at the bottom of the table.</li><li>Right click on an existing row and select <em>Insert row above, Insert child note</em> or <em>Insert row below</em>.</li></ul><p>By default it will try to edit the title of the newly created note.</p><p>Alternatively, the note can be created from the&nbsp;<a class=\"reference-link\" href=\"#root/_help_oPVyFC7WL2Lp\">Note Tree</a>&nbsp;or <a href=\"#root/_help_CdNpE2pqjmI6\">scripting</a>.</p><h3>Context menu</h3><p>There are multiple menus:</p><ul><li>Right clicking on a column, allows:<ul><li>Sorting by the selected column and resetting the sort.</li><li>Hiding the selected column or adjusting the visibility of every column.</li><li>Adding new columns to the left or the right of the column.</li><li>Editing the current column.</li><li>Deleting the current column.</li></ul></li><li>Right clicking on the space to the right of the columns, allows:<ul><li>Adjusting the visibility of every column.</li><li>Adding new columns.</li></ul></li><li>Right clicking on a row, allows:<ul><li>Opening the corresponding note of the row in a new tab, split, window or quick editing it.</li><li>Inserting a new note above or below the selected row. These options are only enabled if the table is not sorted.</li><li>Inserting a new child note for the selected row.</li><li>Deleting the row.</li></ul></li></ul><h3>Editing data</h3><p>Simply click on a cell within a row to change its value. The change will not only reflect in the table, but also as an attribute of the corresponding note.</p><ul><li>The editing will respect the type of the promoted attribute, by presenting a normal text box, a number selector or a date selector for example.</li><li>It also possible to change the title of a note.</li><li>Editing relations is also possible<ul><li>Simply click on a relation and it will become editable. Enter the text to look for a note and click on it.</li><li>To remove a relation, remove the title of the note from the text box and click outside the cell.</li></ul></li></ul><h3>Editing columns</h3><p>It is possible to edit a column by right clicking it and selecting <em>Edit column…</em> This will basically change the label/relation definition at the collection level.</p><p>If the <em>Name</em> field of a column is changed, this will trigger a batch operation in which the corresponding label/relation will be renamed in all the children.</p><h3>Read-only tables</h3><p>On a <a href=\"#root/_help_CoFPLs3dRlXc\">read-only</a> table, the cells can't be edited and the rows can't be dragged. The <em>New row</em> and <em>New column</em> buttons are hidden, and the context menus offer only what leaves the notes as they are: sorting and hiding columns, and opening the notes. Columns can still be resized and reordered, but the layout isn't saved. The <em>Table properties</em> dialog isn't available.</p><h2>Working with the data</h2><h3>Sorting by column</h3><p>By default, the order of the notes matches the order in the&nbsp;<a class=\"reference-link\" href=\"#root/_help_oPVyFC7WL2Lp\">Note Tree</a>. However, it is possible to sort the data by the values of a column:</p><ul><li>To do so, simply click on a column.</li><li>To switch between ascending or descending sort, simply click again on the same column. The arrow next to the column will indicate the direction of the sort.</li><li>To disable sorting and fall back to the original order, right click any column on the header and select <em>Clear sorting.</em></li></ul><h3>Reordering and hiding columns</h3><ul><li>Columns can be reordered by dragging the header of the columns.</li><li>Columns can be hidden or shown by right clicking on a column and clicking the item corresponding to the column.</li></ul><h3>Reordering rows</h3><p>Notes can be dragged around to change their order. To do so, move the mouse over the three vertical dots near the number row and drag the mouse to the desired position.</p><p>This will also change the order of the note in the&nbsp;<a class=\"reference-link\" href=\"#root/_help_oPVyFC7WL2Lp\">Note Tree</a>.</p><p>Reordering does have some limitations:</p><ul><li>If the parent note has <code>#sorted</code>, reordering will be disabled.</li><li>If using nested tables, then reordering will also be disabled.</li><li>Currently, it's possible to reorder notes even if column sorting is used, but the result might be inconsistent.</li></ul><h3>Nested trees</h3><p>If the child notes of the collection also have their own child notes, then they will be displayed in a hierarchy.</p><p>Next to the title of each element there will be a button to expand or collapse. By default, all items are expanded.</p><p>Since nesting is not always desirable, it is possible to limit the nesting to a certain number of levels or even disable it completely. To do so, go to <a class=\"reference-link\" href=\"#root/_help_8YBEPzcpUgxw\">Note menu</a> → <em>Table properties</em> and set <em>Maximum nesting depth</em> (under the <em>Included notes</em> section), or set the <code>#maxNestingDepth</code> <a href=\"#root/_help_HI6GBBIduIgv\">label</a> of the collection:</p><ul><li><code>0</code> disables nesting, showing only the children of the collection.</li><li><code>1</code> also shows their children, <code>2</code> the level below that, and so on.</li><li>Removing the label shows every level again.</li></ul><p>Limitations:</p><ul><li>While in this mode, it's not possible to reorder notes.</li></ul><h2>Limitations</h2><ul><li>There is no support to filter the rows by a certain criteria. Consider using the table view in search for that use case.</li></ul><h2>Use in search</h2><p>The table view can be used in a&nbsp;<a class=\"reference-link\" href=\"#root/_help_m523cpzocqaD\">Saved Search</a>&nbsp;by adding the <code>#viewType=table</code> attribute.</p><p>Unlike when used in a Collection, saved searches are not limited to the sub-hierarchy of a note and allows for advanced queries thanks to the power of the&nbsp;<a class=\"reference-link\" href=\"#root/_help_eIg8jdvaoNNd\">Search</a>.</p><p>However, there are also some limitations:</p><ul><li>It's not possible to reorder notes.</li><li>It's not possible to add a new row.</li></ul><p>Columns are supported, by being defined as&nbsp;<a class=\"reference-link\" href=\"#root/_help_OFXdgB2nNk1F\">Promoted Attributes</a>&nbsp;to the&nbsp;<a class=\"reference-link\" href=\"#root/_help_m523cpzocqaD\">Saved Search</a>&nbsp;note.</p><p>Editing is also supported.</p>",
- "_help_CtBQqbwXDx1w": "<p>The Board view lets you arrange subnotes as cards on a <a href=\"https://en.wikipedia.org/wiki/Kanban_board\">Kanban board</a>.</p><h2>Creating a Kanban board</h2><p>Right-click an existing note in the&nbsp;<a class=\"reference-link\" href=\"#root/_help_oPVyFC7WL2Lp\">Note Tree</a>, select <em>Insert child note</em> → <em>Collection</em> → <em>Kanban Board</em>.</p><h2>How it works</h2><p>When you first create a collection of the <em>Board</em> type, a few subnotes are created, each with a <code>#status</code> label set. The board then groups each note by the value of its status attribute.</p><p>Notes are displayed recursively, so even grandchildren and more deeply nested notes will be displayed. However, unlike the&nbsp;<a class=\"reference-link\" href=\"#root/_help_2FvYrpmOXm29\">Table</a>, the notes are not displayed hierarchically.</p><p>To limit how deep the board looks, go to <a class=\"reference-link\" href=\"#root/_help_8YBEPzcpUgxw\">Note menu</a> → <em>Board properties</em> and set <em>Maximum nesting depth</em> (under the <em>Included notes</em> section), or apply the <code>#maxNestingDepth</code> label to the board note: <code>0</code> shows only the children, <code>1</code> adds their children, and so on. Without a value, every level is shown.</p><h2>Working with columns</h2><h3>Creating columns</h3><p>You can create a new column by pressing the <span class=\"tn-icon bx bx-plus\"></span> <em>Add column</em> button located after the last column.</p><p>Enter the new name (which must not match another column), optionally select an icon by pressing the circle at the start of the text box, and then press the (+) button or <kbd>Enter</kbd>. Click or tap outside the text box, or press <kbd>Esc</kbd>, to dismiss it.</p><p>Columns can also be added from a context menu:</p><ul><li>To add a column at the end of the board, right-click an empty area of the board and select <span class=\"tn-icon bx bx-columns\"></span> <em>Add new column</em>.</li><li>To add a column next to an existing one, open its column menu and select <span class=\"tn-icon bx bx-columns\"></span> <em>Add new column</em> → <em>Before</em> (<kbd>Ctrl</kbd>+<kbd>Shift</kbd>+<kbd>Enter</kbd>) or <em>After</em> (<kbd>Ctrl</kbd>+<kbd>Enter</kbd>).</li></ul><p>Once a board is set up, the <em>Add column</em> button can be hidden. To do so, go to&nbsp;<a class=\"reference-link\" href=\"#root/_help_8YBEPzcpUgxw\">Note menu</a> → <em>Board properties</em> and turn off <em>Show the \"Add column\" button</em> (under the <em>General</em> section), or apply the <code>#board:hideAddColumn</code> label to the board note. Columns can still be added from the context menus above.</p><h3>Reordering columns</h3><p>The order of the columns can be changed at any time. There are several ways to do this:</p><ul><li><strong>Using touch or a mouse:</strong> Touch and hold the column header, or click and hold it with the mouse. Drag the column left or right until it reaches the desired location, and then release it.</li><li><strong>Using the keyboard:</strong> While the keyboard focus is anywhere inside the column, you can use these key combinations. If the column header itself is focused, you can omit <kbd>Alt</kbd>:<ul><li><kbd>Ctrl</kbd> + <kbd>Alt</kbd> + <kbd>Right</kbd>: Move the column to the right.</li><li><kbd>Ctrl</kbd> + <kbd>Alt</kbd> + <kbd>Left</kbd>: Move the column to the left.</li><li><kbd>Ctrl</kbd> + <kbd>Alt</kbd> + <kbd>Home</kbd>: Make it the first column.</li><li><kbd>Ctrl</kbd> + <kbd>Alt</kbd> + <kbd>End</kbd>: Make it the last column.</li></ul></li><li><em>Using the column menu:</em> Open the column menu and use the&nbsp;<span class=\"tn-icon bx bx-horizontal-left\"></span> <em>Move column</em> submenu.</li></ul><h3>Renaming and recoloring columns</h3><p>To change the name of a column, open the column menu and select&nbsp;<span class=\"tn-icon bx bx-edit-alt\"></span> <em>Rename column</em>, or press <kbd>F2</kbd> while the column header is selected.</p><p>From the same menu, you can tint the column with a different color by using the color palette at the bottom of the menu.</p><h3>Collapsing and expanding columns</h3><h4>Collapsing</h4><p>A column can be collapsed (minimized) to occupy less space on the screen and make the board look less cluttered. This is particularly useful for columns that are not frequently used, or when you want to focus on only a few columns and keep the rest out of sight.</p><p>To collapse a column:</p><ul><li><strong>Using a mouse:</strong> Double-click the column header.</li><li><strong>Using touch:</strong> Tap the column header, and then press the&nbsp;<span class=\"tn-icon bx bx-collapse-horizontal\"></span> button on the side toolbar.</li><li><strong>Using the keyboard:</strong> Focus the column header, and then press <kbd>Space</kbd>.</li></ul><p>Alternatively, you can use the&nbsp;<span class=\"tn-icon bx bx-collapse-horizontal\"></span> <em>Collapse column</em> command from the column menu.</p><p>Once a column is collapsed, its cards are no longer visible, but the column can still receive cards from other columns:</p><ul><li><strong>Drop cards onto a collapsed column:</strong> The cards will be moved to the column (at the bottom if manual sorting is enabled).</li><li><strong>Hold cards over a collapsed column for a few seconds:</strong> The column will expand, allowing you to drop the cards at the desired position (if manual sorting is enabled) or peek at the other cards before deciding whether to drop them.</li><li><strong>Move a card to a collapsed column using the keyboard:</strong> The column will temporarily expand to reveal the moved card. You can then continue moving the selected cards up or down, or to another column.</li></ul><p>Collapsed columns can still be reordered, and their menus remain available.</p><p>A collapsed column shows its title vertically, read from the bottom up. If any column title on the board contains Chinese, Japanese or Korean characters, the titles of all collapsed columns read from the top down instead, so that those characters stay upright.</p><h4>Expanding</h4><p>You can restore a collapsed column so that its content is visible again in the following ways:</p><ul><li><strong>Using a mouse:</strong> Click the collapsed column.</li><li><strong>Using touch:</strong> Tap the collapsed column, and then press the&nbsp;<span class=\"tn-icon bx bx-expand-horizontal\"></span> button on the side toolbar.</li><li><strong>Using the keyboard:</strong> Move the focus to the collapsed column, and then press <kbd>Space</kbd>.</li></ul><h4>Keeping a column collapsed</h4><p>By default, once a column is expanded, it remains expanded. However, you can configure a column to collapse again after you finish working with it. To activate this behavior, open the column menu and check&nbsp;<span class=\"tn-icon bx bx-lock-alt\"></span> <em>Keep the column collapsed</em>.</p><p>A column configured to remain collapsed will expand like any other collapsed column, but only temporarily, until another column is focused.</p><h4>Collapsing and expanding all columns</h4><p>You can expand or collapse all columns at once by using the&nbsp;<span class=\"tn-icon bx bx-collapse-alt\"></span> (collapse) and&nbsp;<span class=\"tn-icon bx bx-expand-alt\"></span> (expand) buttons. On the desktop, these buttons are located at the bottom of the screen; on the mobile interface, they are in the header.</p><h3>Sorting cards within a column</h3><p>By default, the cards in a column are sorted manually by moving them up and down. You can also keep them sorted automatically, using customizable criteria for each column. To customize the sorting options, open the column menu → <em>Sort</em>. The following options are available:</p><ul><li><span class=\"tn-icon bx bx-collection\"></span>&nbsp;<em>Board's default</em>: Use the default sorting order (initially manual for new boards).</li><li><span class=\"tn-icon bx bx-move-vertical\"></span>&nbsp;<em>Manually</em>: Sort cards by manually moving them up and down.</li><li><span class=\"tn-icon bx bx-text\"></span>&nbsp;<em>Title</em>: Sort cards by title.</li><li><span class=\"tn-icon bx bx-calendar-plus\"></span>&nbsp;<em>Creation date &amp; time</em>: Sort cards by the creation date and time of the note represented by each card. If a card was created from an existing note, the date and time will match the original creation date and time of that note, not when the card was added to the board.</li><li>Any custom attribute: Any card attribute (see&nbsp;<a class=\"reference-link\" href=\"#root/_help_zEY4DaJG4YT5\">Attributes</a>) can be used as a sorting criterion.</li><li><span class=\"tn-icon bx bx-sort-up\"></span>&nbsp;<em>Ascending</em>: Sort from smallest to largest (A to Z, 0 to 9, or oldest to newest).</li><li><span class=\"tn-icon bx bx-sort-down\"></span>&nbsp;<em>Descending</em>: Sort in reverse order, from largest to smallest.</li></ul><aside class=\"admonition important\"><p>The card order you set is preserved after you switch away from manual sorting. When you switch back to manual sorting, the cards will be in the same order in which you arranged them.</p></aside><h4>How card attributes are sorted</h4><p>When cards are sorted by an attribute, they are ordered according to the following rules:</p><figure class=\"table\"><table><thead><tr><th>Attribute type</th><th>Sort order (ascending)</th></tr></thead><tbody><tr><td>Text, Multi-line text, URL, Email, Phone</td><td>A to Z, 0 to 9</td></tr><tr><td>Number</td><td>lowest → greatest</td></tr><tr><td>Date, Date &amp; time</td><td>oldest → newest</td></tr><tr><td>Time</td><td>earliest hour (closest to 0) → latest hour (closest to 24)</td></tr><tr><td>Checkbox</td><td>unchecked → checked</td></tr><tr><td>Select</td><td>The order in which the options are declared.&nbsp;&nbsp;&nbsp;&nbsp; <br>For example, a select attribute declared with “Low”, “Medium”, and “High” options will be sorted as follows: Low → Medium → High.</td></tr><tr><td>Color</td><td>Grays → colors. Colors are ordered by their color-wheel <a href=\"https://en.wikipedia.org/wiki/Hue\">hue</a> angle (from 0° to 360°).</td></tr></tbody></table></figure><p>Relation attributes are ordered according to the title of the target note.</p><p>Cards with attributes that have no value set are always sorted at the end of the column, regardless of whether the sort order is ascending or descending. If an attribute holds more than one value, only the first value is used for sorting.</p><h4>Configuring the default sorting options</h4><p>Every new column uses the <em>Board's default</em> sorting option, which is initially set to manual sorting on new boards. However, the default can be changed to any other sorting criterion and direction. To configure it, go to&nbsp;<a class=\"reference-link\" href=\"#root/_help_8YBEPzcpUgxw\">Note menu</a> → <em>Board properties</em> → <em>Default card order</em> (under the <em>General</em> section).</p><p>Once the default is changed, all columns set to the <em>Board's default</em> sorting option will follow the new sorting options.</p><p>Columns using a sorting option other than <em>Board's default</em> will not be affected by the new default. To override all columns so that they use the default sorting options, use the <em>Reset sorting options to default for all columns</em> command in <em>Board properties</em>.</p><aside class=\"admonition warning\"><p>Using the <code>#sorted</code> attribute on Kanban boards <strong>is no longer recommended</strong>, because it applies to every column and prevents manual sorting. Instead, use <code>#board:sortColumns</code>, which is designed exclusively for board collections and can take one of the following values: <code>title</code>, <code>creationDate</code>, or <code>attr:_&lt;attribute name&gt;_</code>, for example, <code>#board:sortColumns=attr:dueDate</code>. Using the <code>#board:sortColumnsDescending</code> label will switch to descending order.</p></aside><h3>Setting a limit</h3><p>For each column, you can limit the number of cards it contains (also known as a WIP limit). Once the limit is exceeded, the column displays a visual warning to indicate that it is over its limit.</p><p>To enable the limit, go to the column menu →&nbsp;<span class=\"tn-icon bx bx-tachometer\"></span> <em>Set limit</em>, and then:</p><ul><li>Turn on the <em>Warn for exceeding the column capacity</em> toggle.</li><li>Enter the desired limit in the <em>Maximum number of cards in the column</em> text box.</li><li>Press the <em>Set limit</em> button.</li></ul><p>A column that has reached its limit can still accept new cards. Blocking new cards is not supported and most likely never will be, due to the way Trilium works: cards are regular notes, and the attributes used to group them into columns can be set from anywhere in the app, outside the board control. As a result, enforcing the limit would not be consistent.</p><h3>Archiving a column</h3><p>If you want to hide a column from the board without deleting it, you can archive it by opening the column menu →&nbsp;<span class=\"tn-icon bx bx-archive-in\"></span> <em>Archive column</em>. Archiving a column does not set the archived flag (see&nbsp;<a class=\"reference-link\" href=\"#root/_help_MKmLg5x6xkor\">Archived Notes</a>) on the notes corresponding to its cards.</p><p>To show archived columns again, go to&nbsp;<span class=\"tn-icon bx bx-cog\"></span> <em>Collection options</em> and toggle&nbsp;<span class=\"tn-icon bx bx-archive-in\"></span> <em>Show archived notes</em>, or turn on <em>Show archived cards and columns</em> in <a class=\"reference-link\" href=\"#root/_help_8YBEPzcpUgxw\">Note menu</a> → <em>Board properties</em> (under the <em>Included notes</em> section). Archived columns will appear faded. To restore one, open its column menu and select&nbsp;<span class=\"tn-icon bx bx-archive-out\"></span> <em>Unarchive column</em>.</p><h3>Deleting a column</h3><p>You can delete a column by opening the column menu →&nbsp;<span class=\"tn-icon bx bx-trash\"></span> <em>Delete column</em>, or by pressing <kbd>Delete</kbd> when a column header is focused, and then confirming. This removes the column from the board and unsets the grouping attribute for each note represented by a card in that column. If the column contains cards, the confirmation also offers to delete their notes instead of keeping them.</p><p>The inbox column is not deleted this way. Its menu entry is&nbsp;<span class=\"tn-icon bx bx-trash\"></span> <em>Remove inbox column</em>, and <kbd>Delete</kbd> on its header hides the inbox without changing any card.</p><h3>The inbox column</h3><p>The inbox column is a special column containing cards that are not assigned to another column. It is particularly useful when you switch an existing collection containing child notes to a board collection. The inbox column turns all child notes into cards that you can quickly distribute among the other columns. It can also act as a backlog where you can keep new cards that might eventually become part of the board.</p><p>The inbox column is hidden by default. To show it, go to&nbsp;<span class=\"tn-icon bx bx-cog\"></span> <em>Collection options</em> and toggle <em>Show inbox column</em>. The inbox column is distinguishable by its transparent background. It is always the first column and cannot be moved. It does not support a card limit. Otherwise, it operates like a regular column: its title, icon, and color can be changed; it can be sorted manually or automatically; and it can be collapsed.</p><p>You can also show the inbox column by applying the <code>#board:showInbox</code> label (read more about&nbsp;<a class=\"reference-link\" href=\"#root/_help_zEY4DaJG4YT5\">Attributes</a>) to the board note.</p><p>Optionally, the inbox column can also list nested notes from the board collection's subtree. To enable this, open the column menu and check&nbsp;<span class=\"tn-icon bx bx-subdirectory-right\"></span> <em>Include nested notes</em>.</p><h3>Changing the width of columns</h3><p>There are three predefined widths for board columns: narrow (default), medium, and wide. To change the width, open the&nbsp;<a class=\"reference-link\" href=\"#root/_help_8YBEPzcpUgxw\">Note menu</a> → <em>Board properties</em> → <em>Column width</em> (under the <em>General</em> section). This option applies to every column on the board, except in the mobile version.</p><p>The same option is also available through the <code>#board:columnWidth</code> label (read more about&nbsp;<a class=\"reference-link\" href=\"#root/_help_zEY4DaJG4YT5\">Attributes</a>) on the board note, which accepts “<code>narrow</code>”, “<code>medium</code>”, or “<code>wide</code>” as its value.</p><p>You can also redefine these three widths by using custom app CSS (read more about&nbsp;<a class=\"reference-link\" href=\"#root/_help_AlhDUqhENtH7\">Custom app-wide CSS</a>) and assigning the desired pixel values as follows:</p><pre><code class=\"language-text-x-trilium-auto\">#trilium-app {\n --board-column-width-narrow: 275px;\n --board-column-width-medium: 325px;\n --board-column-width-wide: 400px;\n}</code></pre><h2>Working with cards</h2><h3>Creating a new card</h3><p>To create a new card, press the <span class=\"tn-icon bx bx-plus\"></span> <em>New card</em> button located at the bottom of each column. To create a new card above or below a specific card, right-click or hold that card, and then select&nbsp;<span class=\"tn-icon bx bx-list-plus bx-flip-vertical\"></span> <em>Insert new above</em> or&nbsp;<span class=\"tn-icon bx bx-list-plus\"></span> <em>Insert new below</em> from the context menu. Alternatively, press <kbd>Shift</kbd> + <kbd>Enter</kbd> to create a new card above the focused card, or <kbd>Enter</kbd> to create one below it.</p><p>Next, type the title of the new card, and then press the&nbsp;<span class=\"tn-icon bx bx-plus-circle\"></span> button or <kbd>Enter</kbd> to complete it. Tap or click anywhere outside the text box to dismiss it. You can also select a different icon and card template. To learn more about card templates, see Card templates (learn more about&nbsp;<a class=\"reference-link\" href=\"#root/_help_KC1HB96bqqHX\">Templates</a>).</p><p>After the card is created, you can tap or click it, or press <kbd>Space</kbd>, to edit the note content.</p><p>When using the&nbsp;<span class=\"tn-icon bx bx-plus\"></span> <em>New card</em> button, cards are always created at the end of the column. To create the card at the top of the column, right-click or hold the&nbsp;<span class=\"tn-icon bx bx-plus-circle\"></span> button and select&nbsp;<span class=\"tn-icon bx bx-vertical-top\"></span> <em>Create at top</em>. When using keyboard shortcuts, focus the column header and press <kbd>Enter</kbd> to create a new card at the start of the column, or <kbd>Shift</kbd> + <kbd>Enter</kbd> to create one at the end.</p><h3>Adding an existing note as a card</h3><p>Any note in your knowledge base can be represented as a card on a board. To add an existing note to your board, create a new card but do not enter a title. Instead, press the&nbsp;<span class=\"tn-icon bx bx-folder-open\"></span> button. Alternatively, use the&nbsp;<span class=\"tn-icon bx bx-folder-open\"></span> <em>Add an existing note as a card</em> command from the column menu.</p><p>In the dialog that opens, search for the note by name, and then press the <em>Add to column</em> button to insert it. Alternatively, you can drag any note from the tree and drop it at the desired position on the board.</p><p>If the target note is already in the board collection's subtree, it will already be listed in the <strong>inbox column</strong>.</p><aside class=\"admonition important\"><p>Notes added to the board are cloned, not duplicated. This means that changes to their titles, content, and attributes on the board are reflected in their original locations as well. Learn more about cloned notes.</p></aside><h3>Selecting multiple cards</h3><p>When working with a board, you may need to perform operations on multiple cards at once, such as moving them to another column, setting attributes or colors, deleting them, or archiving them.</p><p>You can select multiple cards in the following ways:</p><ul><li><strong>Using a mouse and keyboard:</strong><ul><li>To add a card to the selection, hold <kbd>Ctrl</kbd> and click the card. Repeat this for other cards until all the desired cards are selected. Clicking a selected card again while holding <kbd>Ctrl</kbd> will deselect it.</li><li>If the cards you want to select form a continuous sequence within a column, hold <kbd>Shift</kbd>, click the first card in the sequence, and then click the last card.</li><li>Press <kbd>Esc</kbd> to clear the selection.</li></ul></li><li><strong>On mobile:</strong><ol><li>To enter selection mode, tap the&nbsp;<span class=\"tn-icon bx bx-select-multiple\"></span> button at the top of the screen. A selection toolbar will appear in the header, displaying “0 cards selected”.</li><li>Tap the cards you want to select. If you tap a selected card again, it will be deselected. To select all cards in a column, press the&nbsp;<span class=\"tn-icon bx bx-list-check\"></span> button on the selection toolbar. To clear the selection, press the&nbsp;<span class=\"tn-icon bx bx-x\"></span> button.</li><li>Use the side toolbar to apply actions to the selected cards.</li></ol></li><li><strong>Using only the keyboard:</strong><ul><li>To add the currently focused card to the selection, press <kbd>Ctrl</kbd> + <kbd>Space</kbd>. Repeat this for the other cards you want to select. Pressing <kbd>Ctrl</kbd> + <kbd>Space</kbd> again on a selected card will deselect it.</li><li>To select a continuous sequence of cards within a column, hold <kbd>Shift</kbd> and use the <kbd>Up</kbd> and <kbd>Down</kbd> arrow keys to expand or shrink the selection.</li><li>To select every card in the column the focus is in, press <kbd>Ctrl</kbd> + <kbd>A</kbd>. The same action is available from the column menu, as <span class=\"tn-icon bx bx-selection\"></span> <em>Select all cards</em>.</li><li>Press <kbd>Esc</kbd> to clear the selection.</li></ul></li></ul><h3>Moving cards between columns</h3><p>To move one or more cards to another column, use one of the following methods:</p><h4>Using touch or a mouse</h4><p>Touch and hold the card, or click and hold it with the mouse, and then drag it to the desired column. If the column uses manual sorting, you can also position the card relative to the other cards.</p><aside class=\"admonition tip\"><p>To drag a card outside the board, for example to the note tree, another split, or another window, hold <kbd>Ctrl</kbd> and then start dragging.</p></aside><p>If the target column is collapsed, you can drop the card onto its header to move it into that column (at the end if manually sorted), without expanding it. However, if you want to reveal its cards before dropping, hold the card over the column for a few seconds; the column will then expand.</p><aside class=\"admonition tip\"><p><strong>You can quickly drop a card at the start or end of a column.</strong></p><p>Drop the card above the column while the “Drop as the first card” hint is displayed to make it the first card in that column. Alternatively, drop it below the column while the “Drop as the last card” hint is displayed to make it the last card.</p></aside><h4>Using the keyboard</h4><p>You can also use keyboard shortcuts to move the selected card or cards between columns:</p><ul><li><kbd>Ctrl</kbd> + <kbd>Right</kbd>: Move to the next column.</li><li><kbd>Ctrl</kbd> + <kbd>Left</kbd>: Move to the previous column.</li><li><kbd>Ctrl</kbd> + <kbd>Shift</kbd> + <kbd>Right</kbd>: Move to the last column.</li><li><kbd>Ctrl</kbd> + <kbd>Shift</kbd> + <kbd>Left</kbd>: Move to the first column.</li></ul><h4>Using the context menu</h4><p>To quickly move a card to another column, open the card's context menu and select the destination column. The menu lists the first seven columns; on a wider board, the remaining ones are grouped under <em>More…</em>.</p><h3>Reordering cards within a column</h3><p>Cards within a column can be freely reordered unless the column uses a sorting option other than manual. To reposition a card, drag it as described in the <strong>Moving cards between columns</strong> section and drop it at the desired position.</p><p>Alternatively, you can use keyboard shortcuts to move the selected card or cards:</p><ul><li><kbd>Ctrl</kbd> + <kbd>Up</kbd>: Move up.</li><li><kbd>Ctrl</kbd> + <kbd>Down</kbd>: Move down.</li><li><kbd>Ctrl</kbd> + <kbd>Home</kbd>: Move to the top of the column.</li><li><kbd>Ctrl</kbd> + <kbd>End</kbd>: Move to the end of the column.</li></ul><p>If multiple cards are selected, the keyboard shortcuts work only if the selection consists of a continuous sequence of cards.</p><h3>Editing a card</h3><p>Every card on a board is a regular note. To edit the note associated with a card, click or tap the card, or press <kbd>Space</kbd> when the card is selected. The note will open in a Quick Edit dialog, where you can modify it. You can also open the note in a new tab, split, or window by using the&nbsp;<span class=\"tn-icon bx bx-link-external\"></span> <em>Open note</em> submenu in the card's context menu. To open the note in a new tab on the desktop version, you can also click or tap the&nbsp;<span class=\"tn-icon bx bx-link-external\"></span> <em>Open note</em> menu item directly, without opening its submenu.</p><p>To change the title or icon of a card, use one of the following methods:</p><ul><li><strong>Using a mouse:</strong> Place the mouse pointer over the card, and then click the&nbsp;<span class=\"tn-icon bx bx-rename\"></span> button.</li><li><strong>On mobile:</strong> Hold the card until the side toolbar appears, and then tap the&nbsp;<span class=\"tn-icon bx bx-rename\"></span> button.</li><li><strong>Using the keyboard:</strong> Select a card, and then press <kbd>F2</kbd>.</li><li><em>Using the context menu:</em> Open the card's context menu and select&nbsp;<span class=\"tn-icon bx bx-rename\"></span> <em>Edit title &amp; icon</em>.</li></ul><p>You can then enter a new name and select another icon. To move the keyboard focus from the title field to the icon selector, press <kbd>Shift</kbd> + <kbd>Tab</kbd>. Click or tap anywhere outside the card, or press <kbd>Enter</kbd>, to apply the change. Press <kbd>Esc</kbd> to discard the changes.</p><p>Each card can be tinted with a different color. Open the card's context menu and select the desired color. If no color is assigned, the card inherits the column color.</p><aside class=\"admonition important\"><p>The title, icon, and color of a card are the same as those of the corresponding note. If that note exists in multiple locations in the tree, any change to its title, icon, or color on the board will apply in those locations as well, not only on the board.</p></aside><h3>Archiving a card</h3><p>A card can be hidden from the board without deleting it by using the&nbsp;<span class=\"tn-icon bx bx-archive-in\"></span> <em>Archive note</em> command from the card's context menu.</p><p>To show archived cards again, go to&nbsp;<span class=\"tn-icon bx bx-cog\"></span> <em>Collection options</em> and toggle&nbsp;<span class=\"tn-icon bx bx-archive-in\"></span> <em>Show archived notes</em>, or turn on <em>Show archived cards and columns</em> in <a class=\"reference-link\" href=\"#root/_help_8YBEPzcpUgxw\">Note menu</a> → <em>Board properties</em> (under the <em>Included notes</em> section). Archived cards will appear faded. To restore one, open its context menu and select&nbsp;<span class=\"tn-icon bx bx-archive-out\"></span> <em>Unarchive note</em>.</p><aside class=\"admonition warning\"><p>Archiving a card sets the <code>#archived</code> flag on its note. If the note exists in multiple locations in the tree, it will appear archived in those locations as well. Read more about&nbsp;<a class=\"reference-link\" href=\"#root/_help_MKmLg5x6xkor\">Archived Notes</a>.</p></aside><h3>Deleting a card</h3><p>You can remove one or more cards from the board and delete their associated notes by using the&nbsp;<span class=\"tn-icon bx bx-trash\"></span> <em>Delete note…</em> command from the card's context menu, or by pressing <kbd>Shift</kbd> + <kbd>Delete</kbd>. On mobile, hold the card until the side toolbar appears, and then tap the&nbsp;<span class=\"tn-icon bx bx-trash\"></span> button.</p><h4>Removing a card from the board without deleting the note</h4><p>To remove a card from the board's columns while keeping its note, open the card's context menu and select&nbsp;<span class=\"tn-icon bx bx-task-x\"></span> <em>Remove from column</em>, or press <kbd>Delete</kbd>. On mobile, hold the card until the side toolbar appears, and then tap the&nbsp;<span class=\"tn-icon bx bx-task-x\"></span> button.</p><p>This command is not available when the inbox column is enabled. Instead, drag the card to the inbox column to achieve the same result.</p><p>The note remains in the board collection but is not assigned to any column. To see it on the board again, enable the inbox column.</p><aside class=\"admonition note\"><p>Under the hood, removing a card simply unsets the note's grouping attribute.</p></aside><h3>Working with custom card attributes</h3><p>By default, the face of a card displays a minimal set of information: the title, icon, and color. In some cases, this may not provide enough useful information at a glance. You can extend the card to display extra information, called card attributes, such as a due date, priority, completion status, or any other information you need. Card attributes use the same principles as&nbsp;<a class=\"reference-link\" href=\"#root/_help_OFXdgB2nNk1F\">Promoted Attributes</a>.</p><h4>Creating a new attribute</h4><p>To create a new attribute, follow these steps:</p><ol><li>Go to&nbsp;<a class=\"reference-link\" href=\"#root/_help_8YBEPzcpUgxw\">Note menu</a> → <em>Board properties</em>, find the <em>Card attributes</em> section, and then press the&nbsp;<span class=\"tn-icon bx bx-plus\"></span> <em>Create a new attribute</em> button.</li><li>Enter a name for the attribute. This is the internal name used by Trilium, so do not use spaces or special characters.</li><li>Select a type (text, number, checkbox, and so on).</li><li>Set the display name. This is the name shown on the card.</li><li>Press <em>Save &amp; close</em>.</li></ol><aside class=\"admonition note\"><p>For each newly created attribute, Trilium creates an attribute definition on the board collection note. A card displays the attributes declared as inheritable on the board note, as well as any attribute the card gets a definition for from elsewhere, for example through&nbsp;<a class=\"reference-link\" href=\"#root/_help_KC1HB96bqqHX\">Templates</a>&nbsp;or another parent note it is cloned under. Attributes that only the cards define are listed after the board's own.</p></aside><p>Here is an example of the attributes you can define for a typical Kanban board used to track tasks:</p><figure class=\"table\"><table><thead><tr><th>Attribute name</th><th>Attribute type</th><th>Attribute display name</th></tr></thead><tbody><tr><td>dueDate</td><td>Date &amp; Time</td><td>Due date</td></tr><tr><td>priority</td><td>Select (options: Low, Medium, High, Urgent)</td><td>Priority</td></tr><tr><td>done</td><td>Checkbox</td><td>Done</td></tr></tbody></table></figure><h4>Modifying the values of custom attributes</h4><p>To set the value of a custom attribute, click or tap the card, and then enter or select the desired value in the dialog header.</p><p>For attributes of the “select” or “checkbox” type, you can quickly change the value by using the card's context menu under the <em>Attributes</em> section.</p><h4>Reordering, hiding, redefining, and deleting custom attributes</h4><p>Go to&nbsp;<a class=\"reference-link\" href=\"#root/_help_8YBEPzcpUgxw\">Note menu</a> → <em>Board properties</em>. Under the <em>Card attributes</em> section, you can:</p><ul><li>Hold the <strong>=</strong> handle shown beside an attribute, and then drag the item up or down to reorder the attributes. This determines the order in which the attributes are displayed on the card.</li><li>Turn off the toggle to hide an attribute from the card's face. The attribute remains available when you edit the card. For the current grouping attribute, the toggle is disabled.</li><li>Press the&nbsp;<span class=\"tn-icon bx bxs-edit\"></span> button to modify the definition of an attribute.</li><li>Press the&nbsp;<span class=\"tn-icon bx bx-trash\"></span> button to delete the attribute and all its values from every note in the board collection.</li></ul><p>Attributes that the cards get from a template or another parent note can be reordered and hidden here, but not modified or deleted. Edit them on the note that defines them.</p><p>If cards define an attribute with the same name but a different type or different select options, for example through two different templates, or if a card overrides the board's definition with its own, the attribute is marked <em>Multiple definitions</em>. Such an attribute is sorted as text and does not appear in the card's context menu.</p><h3>Managing card templates</h3><p>When you create a new card, Trilium offers four templates by default: <em>Text</em>, <em>Markdown</em>, <em>Canvas</em>, and <em>Spreadsheet</em>. You can customize this list to include other note types or custom templates with predefined placeholder content and prefilled card attributes.</p><p>To customize the card templates, go to&nbsp;<a class=\"reference-link\" href=\"#root/_help_8YBEPzcpUgxw\">Note menu</a> → <em>Board properties</em> and find <em>Card templates</em>. Here you can:</p><ul><li>Include a note type or note template already created in your knowledge base by pressing the&nbsp;<span class=\"tn-icon bx bx-list-plus\"></span> <em>Add existing template</em> button and then selecting the desired note type or template.</li><li>Create a new template by pressing the&nbsp;<span class=\"tn-icon bx bx-plus\"></span> <em>Create a new template</em> button. The template editor will open, where you can define the icon, title, default attribute values, and default content. The note template will be created as a child of the board collection.</li><li>Press the&nbsp;<span class=\"tn-icon bx bx-x\"></span> button to remove a template from the list. The template is removed only from the list, not deleted from your knowledge base. You can add it again using&nbsp;<span class=\"tn-icon bx bx-list-plus\"></span> <em>Add existing template</em>.</li><li>Press the&nbsp;<span class=\"tn-icon bx bx-dots-vertical-rounded\"></span> button to open a dropdown that lets you edit, open in a new window, duplicate, or delete a template. This button is visible only for custom note templates.</li><li>Hold the <strong>=</strong> handle shown beside a template, and then drag the item up or down to reorder the templates. This determines the order in which templates are listed in the template dropdown when you create a new card. You can move the most frequently used templates to the top for faster access.</li></ul><h3>Grouping cards</h3><p>On a board, cards are grouped into columns. The column to which a card belongs is determined by the value of the <strong>grouping attribute</strong>, which is a regular attribute of the card's note.</p><p>By default, boards use the <strong>Status</strong> attribute as the grouping attribute. When you move a card to a column called “Waiting on Customer”, the card's Status attribute is set to “Waiting on Customer”.</p><aside class=\"admonition note\"><p>Under the hood, the Status attribute is declared on the board collection note with the name <code>status</code>. It is a select-type attribute that is inheritable and promoted. Each select option becomes a column, and each new column created on the board extends the list of options.</p></aside><h4>Creating a new grouping attribute</h4><p>To quickly create a new grouping attribute:</p><ol><li>Open the&nbsp;<span class=\"tn-icon bx bx-category-alt\"></span> <em>Group by</em> dropdown in the board header and select&nbsp;<span class=\"tn-icon bx bx-plus\"></span> <em>Create a new attribute</em>.</li><li>Fill in the <em>Name</em> field. This is used internally by Trilium, so do not use spaces or special characters.</li><li>Enter the <em>Display name</em>. This is the attribute name shown in the dropdown list.</li><li>Press <em>Save &amp; close</em>.</li></ol><aside class=\"admonition tip\"><p>Because the grouping attribute is a regular card attribute, you can also create it in <em>Board properties</em>. Make sure you set the attribute type to “select”.</p></aside><h4>Switching the grouping attribute</h4><p>Switching the grouping attribute lets you view your cards by priority, category, or any other custom grouping attribute. You can switch the grouping attribute at any time by using the&nbsp;<span class=\"tn-icon bx bx-category-alt\"></span> <em>Group by</em> dropdown in the board header. You can also change it using the <code>#board:groupBy=&lt;_attribute name_&gt;</code> label.</p><aside class=\"admonition warning\"><p>The order of cards in manually sorted columns corresponds to their positions within the board collection subtree. This means that the card order is shared across all views, regardless of the grouping attribute. Reordering notes in one view will also reorder them in other views that use a different grouping attribute.</p></aside><h4>Deleting a grouping attribute</h4><p>To delete a grouping attribute, go to&nbsp;<a class=\"reference-link\" href=\"#root/_help_8YBEPzcpUgxw\">Note menu</a> → <em>Board properties</em>, find the attribute under the <em>Card attributes</em> section, and press the corresponding&nbsp;<span class=\"tn-icon bx bx-trash\"></span> button.</p><h4>Grouping by relations</h4><p>A more advanced use case is grouping by <a href=\"#root/_help_Cq5X6iKQop6R\">Relations</a>.</p><p>In this mode:</p><ul><li>The columns represent the <em>target notes</em> of a relation.</li><li>When creating a new column, you select a note instead of entering a column name.</li><li>The column icon matches the target note.</li><li>Moving notes between columns changes their relations.</li><li>Renaming an existing column changes the target note for all notes in that column.</li></ul><p>Using relations instead of labels has several benefits:</p><ul><li>The status or grouping of notes is visible outside the Kanban board, for example, on the&nbsp;<a class=\"reference-link\" href=\"#root/_help_bdUJEHsAPYQR\">Note Map</a>.</li><li>A column takes its title and icon from the target note, so renaming that note anywhere in the tree renames the column.</li></ul><p>To use relations for grouping:</p><ol><li><p>Create a Kanban board from scratch rather than from a template.</p></li><li><p>Assign <code>#viewType=board #hidePromotedAttributes</code> to emulate the default template.</p></li><li><p>Set <code>#board:groupBy</code> to the name of a relation, <strong>including the</strong> <code>~</code> <strong>prefix</strong> (for example, <code>~status</code>).</p></li><li><p>Optionally, use&nbsp;<a class=\"reference-link\" href=\"#root/_help_OFXdgB2nNk1F\">Promoted Attributes</a>&nbsp;to make changing the status within the note easier:</p><pre><code class=\"language-text-x-trilium-auto\">#relation:status(inheritable)=\"promoted,alias=Status,single\"</code></pre></li></ol><h2>Searching and filtering the board</h2><p>You can search for cards using the search box at the top of the board. Enter your keywords, and then press the&nbsp;<span class=\"tn-icon bx bx-search\"></span> button in the search field or press <kbd>Enter</kbd>. Only cards whose titles, content, or attribute values match the query will be displayed. Columns without results will be temporarily collapsed to make room for the matching cards. Press the&nbsp;<span class=\"tn-icon bx bx-x\"></span> button in the search field to clear the search and display all cards again.</p><h3>Advanced filtering</h3><p>If you need to refine the view to display only cards matching specific criteria beyond a regular text search, you can use Trilium's search query syntax. Here are some example queries:</p><p>Display only cards whose <strong>Priority</strong> attribute is set to “Low”:</p><pre><code class=\"language-text-x-trilium-auto\">#priority=Low</code></pre><p>Display only cards whose <strong>Issue Category</strong> is set to “Software” and whose <strong>Site</strong> is set to either “Office” or “Factory”:</p><pre><code class=\"language-text-x-trilium-auto\">#issueCategory=\"Software\" AND (#site=\"Office\" OR #site=\"Factory\")</code></pre><p>Display only cards with a <strong>Due Date</strong> in the next seven days that are not yet marked as <strong>Done</strong>:</p><pre><code class=\"language-text-x-trilium-auto\">#dueDate &gt;= TODAY AND #dueDate &lt;= TODAY+7 AND #!done</code></pre><p>The filter persists even after you close the tab. When you reopen the collection, the filter remains active until you clear the search query by using the&nbsp;<span class=\"tn-icon bx bx-x\"></span> button.</p><h2>Linking to a column or a card</h2><p>You can create a link that opens the board and points out a specific column or card. Open the column menu or the card’s context menu, select&nbsp;<span class=\"tn-icon bx bx-copy\"></span> <em>Copy reference</em>, and then paste the link where you need it.</p><p>In a text note, the pasted link displays the title, icon, and color of the column or card it points to. In a Markdown or code note, the plain link address is pasted instead. Opening the link scrolls the board to the column or card and focuses it. If the column belongs to a different grouping attribute, the board switches to that attribute first.</p><h2>Read-only boards</h2><p>A board marked as <a href=\"#root/_help_CoFPLs3dRlXc\">read-only</a> only shows its cards. It has no buttons to add a card or a column, column and card titles can't be renamed, and column icons can't be changed. Cards and columns can't be dragged, moved or deleted with the keyboard, and notes dragged in from the note tree aren't added. The context menus of a card or a column keep only the entries that change nothing, such as opening the note or <span class=\"tn-icon bx bx-copy\"></span> <em>Copy reference</em>, and the board's own menu doesn't open. The cards can still be grouped by another attribute, but the choice isn't saved, and no new grouping attribute can be created.</p>",
+ "_help_CtBQqbwXDx1w": "<p>The Board view lets you arrange subnotes as cards on a <a href=\"https://en.wikipedia.org/wiki/Kanban_board\">Kanban board</a>.</p><h2>Creating a Kanban board</h2><p>Right-click an existing note in the&nbsp;<a class=\"reference-link\" href=\"#root/_help_oPVyFC7WL2Lp\">Note Tree</a>, select <em>Insert child note</em> → <em>Collection</em> → <em>Kanban Board</em>.</p><h2>How it works</h2><p>When you first create a collection of the <em>Board</em> type, a few subnotes are created, each with a <code>#status</code> label set. The board then groups each note by the value of its status attribute.</p><p>Notes are displayed recursively, so even grandchildren and more deeply nested notes will be displayed. However, unlike the&nbsp;<a class=\"reference-link\" href=\"#root/_help_2FvYrpmOXm29\">Table</a>, the notes are not displayed hierarchically.</p><p>To limit how deep the board looks, go to <a class=\"reference-link\" href=\"#root/_help_8YBEPzcpUgxw\">Note menu</a> → <em>Board properties</em> and set <em>Maximum nesting depth</em> (under the <em>Included notes</em> section), or apply the <code>#maxNestingDepth</code> label to the board note: <code>0</code> shows only the children, <code>1</code> adds their children, and so on. Without a value, every level is shown.</p><h2>Working with columns</h2><h3>Creating columns</h3><p>You can create a new column by pressing the <span class=\"tn-icon bx bx-plus\"></span> <em>Add column</em> button located after the last column.</p><p>Enter the new name (which must not match another column), optionally select an icon by pressing the circle at the start of the text box, and then press the (+) button or <kbd>Enter</kbd>. Click or tap outside the text box, or press <kbd>Esc</kbd>, to dismiss it.</p><p>Columns can also be added from a context menu:</p><ul><li>To add a column at the end of the board, right-click an empty area of the board and select <span class=\"tn-icon bx bx-columns\"></span> <em>Add new column</em>.</li><li>To add a column next to an existing one, open its column menu and select <span class=\"tn-icon bx bx-columns\"></span> <em>Add new column</em> → <em>Before</em> (<kbd>Ctrl</kbd>+<kbd>Shift</kbd>+<kbd>Enter</kbd>) or <em>After</em> (<kbd>Ctrl</kbd>+<kbd>Enter</kbd>).</li></ul><p>Once a board is set up, the <em>Add column</em> button can be hidden. To do so, go to&nbsp;<a class=\"reference-link\" href=\"#root/_help_8YBEPzcpUgxw\">Note menu</a> → <em>Board properties</em> and turn off <em>Show the \"Add column\" button</em> (under the <em>General</em> section), or apply the <code>#board:hideAddColumn</code> label to the board note. Columns can still be added from the context menus above.</p><h3>Reordering columns</h3><p>The order of the columns can be changed at any time. There are several ways to do this:</p><ul><li><strong>Using touch or a mouse:</strong> Touch and hold the column header, or click and hold it with the mouse. Drag the column left or right until it reaches the desired location, and then release it.</li><li><strong>Using the keyboard:</strong> While the keyboard focus is anywhere inside the column, you can use these key combinations. If the column header itself is focused, you can omit <kbd>Alt</kbd>:<ul><li><kbd>Ctrl</kbd> + <kbd>Alt</kbd> + <kbd>Right</kbd>: Move the column to the right.</li><li><kbd>Ctrl</kbd> + <kbd>Alt</kbd> + <kbd>Left</kbd>: Move the column to the left.</li><li><kbd>Ctrl</kbd> + <kbd>Alt</kbd> + <kbd>Home</kbd>: Make it the first column.</li><li><kbd>Ctrl</kbd> + <kbd>Alt</kbd> + <kbd>End</kbd>: Make it the last column.</li></ul></li><li><em>Using the column menu:</em> Open the column menu and use the&nbsp;<span class=\"tn-icon bx bx-horizontal-left\"></span> <em>Move column</em> submenu.</li></ul><h3>Renaming and recoloring columns</h3><p>To change the name of a column, open the column menu and select&nbsp;<span class=\"tn-icon bx bx-edit-alt\"></span> <em>Rename column</em>, or press <kbd>F2</kbd> while the column header is selected.</p><p>From the same menu, you can tint the column with a different color by using the color palette at the bottom of the menu.</p><h3>Collapsing and expanding columns</h3><h4>Collapsing</h4><p>A column can be collapsed (minimized) to occupy less space on the screen and make the board look less cluttered. This is particularly useful for columns that are not frequently used, or when you want to focus on only a few columns and keep the rest out of sight.</p><p>To collapse a column:</p><ul><li><strong>Using a mouse:</strong> Double-click the column header.</li><li><strong>Using touch:</strong> Tap the column header, and then press the&nbsp;<span class=\"tn-icon bx bx-collapse-horizontal\"></span> button on the side toolbar.</li><li><strong>Using the keyboard:</strong> Focus the column header, and then press <kbd>Space</kbd>.</li></ul><p>Alternatively, you can use the&nbsp;<span class=\"tn-icon bx bx-collapse-horizontal\"></span> <em>Collapse column</em> command from the column menu.</p><p>Once a column is collapsed, its cards are no longer visible, but the column can still receive cards from other columns:</p><ul><li><strong>Drop cards onto a collapsed column:</strong> The cards will be moved to the column (at the bottom if manual sorting is enabled).</li><li><strong>Hold cards over a collapsed column for a few seconds:</strong> The column will expand, allowing you to drop the cards at the desired position (if manual sorting is enabled) or peek at the other cards before deciding whether to drop them.</li><li><strong>Move a card to a collapsed column using the keyboard:</strong> The column will temporarily expand to reveal the moved card. You can then continue moving the selected cards up or down, or to another column.</li></ul><p>Collapsed columns can still be reordered, and their menus remain available.</p><p>A collapsed column shows its title vertically, read from the bottom up. If any column title on the board contains Chinese, Japanese or Korean characters, the titles of all collapsed columns read from the top down instead, so that those characters stay upright.</p><h4>Expanding</h4><p>You can restore a collapsed column so that its content is visible again in the following ways:</p><ul><li><strong>Using a mouse:</strong> Click the collapsed column.</li><li><strong>Using touch:</strong> Tap the collapsed column, and then press the&nbsp;<span class=\"tn-icon bx bx-expand-horizontal\"></span> button on the side toolbar.</li><li><strong>Using the keyboard:</strong> Move the focus to the collapsed column, and then press <kbd>Space</kbd>.</li></ul><h4>Keeping a column collapsed</h4><p>By default, once a column is expanded, it remains expanded. However, you can configure a column to collapse again after you finish working with it. To activate this behavior, open the column menu and check&nbsp;<span class=\"tn-icon bx bx-lock-alt\"></span> <em>Keep the column collapsed</em>.</p><p>A column configured to remain collapsed will expand like any other collapsed column, but only temporarily, until another column is focused.</p><h4>Collapsing and expanding all columns</h4><p>You can expand or collapse all columns at once by using the&nbsp;<span class=\"tn-icon bx bx-collapse-alt\"></span> (collapse) and&nbsp;<span class=\"tn-icon bx bx-expand-alt\"></span> (expand) buttons. On the desktop, these buttons are located at the bottom of the screen; on the mobile interface, they are in the header.</p><h3>Sorting cards within a column</h3><p>By default, the cards in a column are sorted manually by moving them up and down. You can also keep them sorted automatically, using customizable criteria for each column. To customize the sorting options, open the column menu → <em>Sort</em>. The following options are available:</p><ul><li><span class=\"tn-icon bx bx-collection\"></span>&nbsp;<em>Board's default</em>: Use the default sorting order (initially manual for new boards).</li><li><span class=\"tn-icon bx bx-move-vertical\"></span>&nbsp;<em>Manually</em>: Sort cards by manually moving them up and down.</li><li><span class=\"tn-icon bx bx-text\"></span>&nbsp;<em>Title</em>: Sort cards by title.</li><li><span class=\"tn-icon bx bx-calendar-plus\"></span>&nbsp;<em>Creation date &amp; time</em>: Sort cards by the creation date and time of the note represented by each card. If a card was created from an existing note, the date and time will match the original creation date and time of that note, not when the card was added to the board.</li><li>Any custom attribute: Any card attribute (see&nbsp;<a class=\"reference-link\" href=\"#root/_help_zEY4DaJG4YT5\">Attributes</a>) can be used as a sorting criterion.</li><li><span class=\"tn-icon bx bx-sort-up\"></span>&nbsp;<em>Ascending</em>: Sort from smallest to largest (A to Z, 0 to 9, or oldest to newest).</li><li><span class=\"tn-icon bx bx-sort-down\"></span>&nbsp;<em>Descending</em>: Sort in reverse order, from largest to smallest.</li></ul><aside class=\"admonition important\"><p>The card order you set is preserved after you switch away from manual sorting. When you switch back to manual sorting, the cards will be in the same order in which you arranged them.</p></aside><h4>How card attributes are sorted</h4><p>When cards are sorted by an attribute, they are ordered according to the following rules:</p><figure class=\"table\"><table><thead><tr><th>Attribute type</th><th>Sort order (ascending)</th></tr></thead><tbody><tr><td>Text, Multi-line text, URL, Email, Phone</td><td>A to Z, 0 to 9</td></tr><tr><td>Number</td><td>lowest → greatest</td></tr><tr><td>Date, Date &amp; time</td><td>oldest → newest</td></tr><tr><td>Time</td><td>earliest hour (closest to 0) → latest hour (closest to 24)</td></tr><tr><td>Checkbox</td><td>unchecked → checked</td></tr><tr><td>Select</td><td>The order in which the options are declared.&nbsp;&nbsp;&nbsp;&nbsp; <br>For example, a select attribute declared with “Low”, “Medium”, and “High” options will be sorted as follows: Low → Medium → High.</td></tr><tr><td>Color</td><td>Grays → colors. Colors are ordered by their color-wheel <a href=\"https://en.wikipedia.org/wiki/Hue\">hue</a> angle (from 0° to 360°).</td></tr></tbody></table></figure><p>Relation attributes are ordered according to the title of the target note.</p><p>Cards with attributes that have no value set are always sorted at the end of the column, regardless of whether the sort order is ascending or descending. If an attribute holds more than one value, only the first value is used for sorting.</p><h4>Configuring the default sorting options</h4><p>Every new column uses the <em>Board's default</em> sorting option, which is initially set to manual sorting on new boards. However, the default can be changed to any other sorting criterion and direction. To configure it, go to&nbsp;<a class=\"reference-link\" href=\"#root/_help_8YBEPzcpUgxw\">Note menu</a> → <em>Board properties</em> → <em>Default card order</em> (under the <em>General</em> section).</p><p>Once the default is changed, all columns set to the <em>Board's default</em> sorting option will follow the new sorting options.</p><p>Columns using a sorting option other than <em>Board's default</em> will not be affected by the new default. To override all columns so that they use the default sorting options, use the <em>Reset sorting options to default for all columns</em> command in <em>Board properties</em>.</p><aside class=\"admonition warning\"><p>Using the <code>#sorted</code> attribute on Kanban boards <strong>is no longer recommended</strong>, because it applies to every column and prevents manual sorting. Instead, use <code>#board:sortColumns</code>, which is designed exclusively for board collections and can take one of the following values: <code>title</code>, <code>creationDate</code>, or <code>attr:_&lt;attribute name&gt;_</code>, for example, <code>#board:sortColumns=attr:dueDate</code>. Using the <code>#board:sortColumnsDescending</code> label will switch to descending order.</p></aside><h3>Setting a limit</h3><p>For each column, you can limit the number of cards it contains (also known as a WIP limit). Once the limit is exceeded, the column displays a visual warning to indicate that it is over its limit.</p><p>To enable the limit, go to the column menu →&nbsp;<span class=\"tn-icon bx bx-tachometer\"></span> <em>Set limit</em>, and then:</p><ul><li>Turn on the <em>Warn for exceeding the column capacity</em> toggle.</li><li>Enter the desired limit in the <em>Maximum number of cards in the column</em> text box.</li><li>Press the <em>Set limit</em> button.</li></ul><p>A column that has reached its limit can still accept new cards. Blocking new cards is not supported and most likely never will be, due to the way Trilium works: cards are regular notes, and the attributes used to group them into columns can be set from anywhere in the app, outside the board control. As a result, enforcing the limit would not be consistent.</p><h3>Archiving a column</h3><p>If you want to hide a column from the board without deleting it, you can archive it by opening the column menu →&nbsp;<span class=\"tn-icon bx bx-archive-in\"></span> <em>Archive column</em>. Archiving a column does not set the archived flag (see&nbsp;<a class=\"reference-link\" href=\"#root/_help_MKmLg5x6xkor\">Archived Notes</a>) on the notes corresponding to its cards.</p><p>To show archived columns again, go to&nbsp;<span class=\"tn-icon bx bx-cog\"></span> <em>Collection options</em> and toggle&nbsp;<span class=\"tn-icon bx bx-archive-in\"></span> <em>Show archived notes</em>, or turn on <em>Show archived cards and columns</em> in <a class=\"reference-link\" href=\"#root/_help_8YBEPzcpUgxw\">Note menu</a> → <em>Board properties</em> (under the <em>Included notes</em> section). Archived columns will appear faded. To restore one, open its column menu and select&nbsp;<span class=\"tn-icon bx bx-archive-out\"></span> <em>Unarchive column</em>.</p><h3>Deleting a column</h3><p>You can delete a column by opening the column menu →&nbsp;<span class=\"tn-icon bx bx-trash\"></span> <em>Delete column</em>, or by pressing <kbd>Delete</kbd> when a column header is focused, and then confirming. This removes the column from the board and unsets the grouping attribute for each note represented by a card in that column. If the column contains cards, the confirmation also offers to delete their notes instead of keeping them.</p><p>The inbox column is not deleted this way. Its menu entry is&nbsp;<span class=\"tn-icon bx bx-trash\"></span> <em>Remove inbox column</em>, and <kbd>Delete</kbd> on its header hides the inbox without changing any card.</p><h3>The inbox column</h3><p>The inbox column is a special column containing cards that are not assigned to another column. It is particularly useful when you switch an existing collection containing child notes to a board collection. The inbox column turns all child notes into cards that you can quickly distribute among the other columns. It can also act as a backlog where you can keep new cards that might eventually become part of the board.</p><p>The inbox column is hidden by default. To show it, go to&nbsp;<span class=\"tn-icon bx bx-cog\"></span> <em>Collection options</em> and toggle <em>Show inbox column</em>. The inbox column is distinguishable by its transparent background. It is always the first column and cannot be moved. It does not support a card limit. Otherwise, it operates like a regular column: its title, icon, and color can be changed; it can be sorted manually or automatically; and it can be collapsed.</p><p>You can also show the inbox column by applying the <code>#board:showInbox</code> label (read more about&nbsp;<a class=\"reference-link\" href=\"#root/_help_zEY4DaJG4YT5\">Attributes</a>) to the board note.</p><p>Optionally, the inbox column can also list nested notes from the board collection's subtree. To enable this, open the column menu and check&nbsp;<span class=\"tn-icon bx bx-subdirectory-right\"></span> <em>Include nested notes</em>.</p><h3>Changing the width of columns</h3><p>There are three predefined widths for board columns: narrow (default), medium, and wide. To change the width, open the&nbsp;<a class=\"reference-link\" href=\"#root/_help_8YBEPzcpUgxw\">Note menu</a> → <em>Board properties</em> → <em>Column width</em> (under the <em>General</em> section). This option applies to every column on the board, except in the mobile version.</p><p>The same option is also available through the <code>#board:columnWidth</code> label (read more about&nbsp;<a class=\"reference-link\" href=\"#root/_help_zEY4DaJG4YT5\">Attributes</a>) on the board note, which accepts “<code>narrow</code>”, “<code>medium</code>”, or “<code>wide</code>” as its value.</p><p>You can also redefine these three widths by using custom app CSS (read more about&nbsp;<a class=\"reference-link\" href=\"#root/_help_AlhDUqhENtH7\">Custom app-wide CSS</a>) and assigning the desired pixel values as follows:</p><pre><code class=\"language-text-x-trilium-auto\">#trilium-app {\n --board-column-width-narrow: 275px;\n --board-column-width-medium: 325px;\n --board-column-width-wide: 400px;\n}</code></pre><h2>Working with cards</h2><h3>Creating a new card</h3><p>To create a new card, press the <span class=\"tn-icon bx bx-plus\"></span> <em>New card</em> button located at the bottom of each column. To create a new card above or below a specific card, right-click or hold that card, and then select&nbsp;<span class=\"tn-icon bx bx-list-plus bx-flip-vertical\"></span> <em>Insert new above</em> or&nbsp;<span class=\"tn-icon bx bx-list-plus\"></span> <em>Insert new below</em> from the context menu. Alternatively, press <kbd>Shift</kbd> + <kbd>Enter</kbd> to create a new card above the focused card, or <kbd>Enter</kbd> to create one below it.</p><p>Next, type the title of the new card, and then press the&nbsp;<span class=\"tn-icon bx bx-plus-circle\"></span> button or <kbd>Enter</kbd> to complete it. Tap or click anywhere outside the text box to dismiss it. You can also select a different icon and card template. To learn more about card templates, see Card templates (learn more about&nbsp;<a class=\"reference-link\" href=\"#root/_help_KC1HB96bqqHX\">Templates</a>).</p><p>After the card is created, you can tap or click it, or press <kbd>Space</kbd>, to edit the note content.</p><p>When using the&nbsp;<span class=\"tn-icon bx bx-plus\"></span> <em>New card</em> button, cards are always created at the end of the column. To create the card at the top of the column, right-click or hold the&nbsp;<span class=\"tn-icon bx bx-plus-circle\"></span> button and select&nbsp;<span class=\"tn-icon bx bx-vertical-top\"></span> <em>Create at top</em>. When using keyboard shortcuts, focus the column header and press <kbd>Enter</kbd> to create a new card at the start of the column, or <kbd>Shift</kbd> + <kbd>Enter</kbd> to create one at the end.</p><h3>Adding an existing note as a card</h3><p>Any note in your knowledge base can be represented as a card on a board. To add an existing note to your board, create a new card but do not enter a title. Instead, press the&nbsp;<span class=\"tn-icon bx bx-folder-open\"></span> button. Alternatively, use the&nbsp;<span class=\"tn-icon bx bx-folder-open\"></span> <em>Add an existing note as a card</em> command from the column menu.</p><p>In the dialog that opens, search for the note by name, and then press the <em>Add to column</em> button to insert it. Alternatively, you can drag any note from the tree and drop it at the desired position on the board.</p><p>If the target note is already in the board collection's subtree, it will already be listed in the <strong>inbox column</strong>.</p><aside class=\"admonition important\"><p>Notes added to the board are cloned, not duplicated. This means that changes to their titles, content, and attributes on the board are reflected in their original locations as well. Learn more about cloned notes.</p></aside><h3>Selecting multiple cards</h3><p>When working with a board, you may need to perform operations on multiple cards at once, such as moving them to another column, setting attributes or colors, deleting them, or archiving them.</p><p>You can select multiple cards in the following ways:</p><ul><li><strong>Using a mouse and keyboard:</strong><ul><li>To add a card to the selection, hold <kbd>Ctrl</kbd> and click the card. Repeat this for other cards until all the desired cards are selected. Clicking a selected card again while holding <kbd>Ctrl</kbd> will deselect it.</li><li>If the cards you want to select form a continuous sequence within a column, hold <kbd>Shift</kbd>, click the first card in the sequence, and then click the last card.</li><li>Press <kbd>Esc</kbd> to clear the selection.</li></ul></li><li><strong>On mobile:</strong><ol><li>To enter selection mode, tap the&nbsp;<span class=\"tn-icon bx bx-select-multiple\"></span> button at the top of the screen. A selection toolbar will appear in the header, displaying “0 cards selected”.</li><li>Tap the cards you want to select. If you tap a selected card again, it will be deselected. To select all cards in a column, press the&nbsp;<span class=\"tn-icon bx bx-list-check\"></span> button on the selection toolbar. To clear the selection, press the&nbsp;<span class=\"tn-icon bx bx-x\"></span> button.</li><li>Use the side toolbar to apply actions to the selected cards.</li></ol></li><li><strong>Using only the keyboard:</strong><ul><li>To add the currently focused card to the selection, press <kbd>Ctrl</kbd> + <kbd>Space</kbd>. Repeat this for the other cards you want to select. Pressing <kbd>Ctrl</kbd> + <kbd>Space</kbd> again on a selected card will deselect it.</li><li>To select a continuous sequence of cards within a column, hold <kbd>Shift</kbd> and use the <kbd>Up</kbd> and <kbd>Down</kbd> arrow keys to expand or shrink the selection.</li><li>To select every card in the column the focus is in, press <kbd>Ctrl</kbd> + <kbd>A</kbd>. The same action is available from the column menu, as <span class=\"tn-icon bx bx-selection\"></span> <em>Select all cards</em>.</li><li>Press <kbd>Esc</kbd> to clear the selection.</li></ul></li></ul><h3>Moving cards between columns</h3><p>To move one or more cards to another column, use one of the following methods:</p><h4>Using touch or a mouse</h4><p>Touch and hold the card, or click and hold it with the mouse, and then drag it to the desired column. If the column uses manual sorting, you can also position the card relative to the other cards.</p><aside class=\"admonition tip\"><p>To drag a card outside the board, for example to the note tree, another split, or another window, hold <kbd>Ctrl</kbd> and then start dragging.</p></aside><p>If the target column is collapsed, you can drop the card onto its header to move it into that column (at the end if manually sorted), without expanding it. However, if you want to reveal its cards before dropping, hold the card over the column for a few seconds; the column will then expand.</p><aside class=\"admonition tip\"><p><strong>You can quickly drop a card at the start or end of a column.</strong></p><p>Drop the card above the column while the “Drop as the first card” hint is displayed to make it the first card in that column. Alternatively, drop it below the column while the “Drop as the last card” hint is displayed to make it the last card.</p></aside><h4>Using the keyboard</h4><p>You can also use keyboard shortcuts to move the selected card or cards between columns:</p><ul><li><kbd>Ctrl</kbd> + <kbd>Right</kbd>: Move to the next column.</li><li><kbd>Ctrl</kbd> + <kbd>Left</kbd>: Move to the previous column.</li><li><kbd>Ctrl</kbd> + <kbd>Shift</kbd> + <kbd>Right</kbd>: Move to the last column.</li><li><kbd>Ctrl</kbd> + <kbd>Shift</kbd> + <kbd>Left</kbd>: Move to the first column.</li></ul><h4>Using the context menu</h4><p>To quickly move a card to another column, open the card's context menu and select the destination column. The menu lists the first seven columns; on a wider board, the remaining ones are grouped under <em>More…</em>.</p><h3>Reordering cards within a column</h3><p>Cards within a column can be freely reordered unless the column uses a sorting option other than manual. To reposition a card, drag it as described in the <strong>Moving cards between columns</strong> section and drop it at the desired position.</p><p>Alternatively, you can use keyboard shortcuts to move the selected card or cards:</p><ul><li><kbd>Ctrl</kbd> + <kbd>Up</kbd>: Move up.</li><li><kbd>Ctrl</kbd> + <kbd>Down</kbd>: Move down.</li><li><kbd>Ctrl</kbd> + <kbd>Home</kbd>: Move to the top of the column.</li><li><kbd>Ctrl</kbd> + <kbd>End</kbd>: Move to the end of the column.</li></ul><p>If multiple cards are selected, the keyboard shortcuts work only if the selection consists of a continuous sequence of cards.</p><h3>Editing a card</h3><p>Every card on a board is a regular note. To edit the note associated with a card, click or tap the card, or press <kbd>Space</kbd> when the card is selected. The note will open in a Quick Edit dialog, where you can modify it. You can also open the note in a new tab, split, or window by using the&nbsp;<span class=\"tn-icon bx bx-link-external\"></span> <em>Open note</em> submenu in the card's context menu. To open the note in a new tab on the desktop version, you can also click or tap the&nbsp;<span class=\"tn-icon bx bx-link-external\"></span> <em>Open note</em> menu item directly, without opening its submenu.</p><p>To change the title or icon of a card, use one of the following methods:</p><ul><li><strong>Using a mouse:</strong> Place the mouse pointer over the card, and then click the&nbsp;<span class=\"tn-icon bx bx-rename\"></span> button.</li><li><strong>On mobile:</strong> Hold the card until the side toolbar appears, and then tap the&nbsp;<span class=\"tn-icon bx bx-rename\"></span> button.</li><li><strong>Using the keyboard:</strong> Select a card, and then press <kbd>F2</kbd>.</li><li><em>Using the context menu:</em> Open the card's context menu and select&nbsp;<span class=\"tn-icon bx bx-rename\"></span> <em>Edit title &amp; icon</em>.</li></ul><p>You can then enter a new name and select another icon. To move the keyboard focus from the title field to the icon selector, press <kbd>Shift</kbd> + <kbd>Tab</kbd>. Click or tap anywhere outside the card, or press <kbd>Enter</kbd>, to apply the change. Press <kbd>Esc</kbd> to discard the changes.</p><p>Each card can be tinted with a different color. Open the card's context menu and select the desired color. If no color is assigned, the card inherits the column color.</p><aside class=\"admonition important\"><p>The title, icon, and color of a card are the same as those of the corresponding note. If that note exists in multiple locations in the tree, any change to its title, icon, or color on the board will apply in those locations as well, not only on the board.</p></aside><h3>Archiving a card</h3><p>A card can be hidden from the board without deleting it by using the&nbsp;<span class=\"tn-icon bx bx-archive-in\"></span> <em>Archive note</em> command from the card's context menu.</p><p>To show archived cards again, go to&nbsp;<span class=\"tn-icon bx bx-cog\"></span> <em>Collection options</em> and toggle&nbsp;<span class=\"tn-icon bx bx-archive-in\"></span> <em>Show archived notes</em>, or turn on <em>Show archived cards and columns</em> in <a class=\"reference-link\" href=\"#root/_help_8YBEPzcpUgxw\">Note menu</a> → <em>Board properties</em> (under the <em>Included notes</em> section). Archived cards will appear faded. To restore one, open its context menu and select&nbsp;<span class=\"tn-icon bx bx-archive-out\"></span> <em>Unarchive note</em>.</p><aside class=\"admonition warning\"><p>Archiving a card sets the <code>#archived</code> flag on its note. If the note exists in multiple locations in the tree, it will appear archived in those locations as well. Read more about&nbsp;<a class=\"reference-link\" href=\"#root/_help_MKmLg5x6xkor\">Archived Notes</a>.</p></aside><h3>Deleting a card</h3><p>You can remove one or more cards from the board and delete their associated notes by using the&nbsp;<span class=\"tn-icon bx bx-trash\"></span> <em>Delete note…</em> command from the card's context menu, or by pressing <kbd>Shift</kbd> + <kbd>Delete</kbd>. On mobile, hold the card until the side toolbar appears, and then tap the&nbsp;<span class=\"tn-icon bx bx-trash\"></span> button.</p><h4>Removing a card from the board without deleting the note</h4><p>To remove a card from the board's columns while keeping its note, open the card's context menu and select&nbsp;<span class=\"tn-icon bx bx-task-x\"></span> <em>Remove from column</em>, or press <kbd>Delete</kbd>. On mobile, hold the card until the side toolbar appears, and then tap the&nbsp;<span class=\"tn-icon bx bx-task-x\"></span> button.</p><p>This command is not available when the inbox column is enabled. Instead, drag the card to the inbox column to achieve the same result.</p><p>The note remains in the board collection but is not assigned to any column. To see it on the board again, enable the inbox column.</p><aside class=\"admonition note\"><p>Under the hood, removing a card simply unsets the note's grouping attribute.</p></aside><h3>Working with custom card attributes</h3><p>By default, the face of a card displays a minimal set of information: the title, icon, and color. In some cases, this may not provide enough useful information at a glance. You can extend the card to display extra information, called card attributes, such as a due date, priority, completion status, or any other information you need. Card attributes use the same principles as&nbsp;<a class=\"reference-link\" href=\"#root/_help_OFXdgB2nNk1F\">Promoted Attributes</a>.</p><h4>Creating a new attribute</h4><p>To create a new attribute, follow these steps:</p><ol><li>Go to&nbsp;<a class=\"reference-link\" href=\"#root/_help_8YBEPzcpUgxw\">Note menu</a> → <em>Board properties</em>, find the <em>Card attributes</em> section, and then press the&nbsp;<span class=\"tn-icon bx bx-plus\"></span> <em>Create a new attribute</em> button.</li><li>Enter a name for the attribute. This is the internal name used by Trilium, so do not use spaces or special characters.</li><li>Select a type (text, number, checkbox, and so on).</li><li>Set the display name. This is the name shown on the card.</li><li>Press <em>Save &amp; close</em>.</li></ol><aside class=\"admonition note\"><p>For each newly created attribute, Trilium creates an attribute definition on the board collection note. A card displays the attributes declared as inheritable on the board note, as well as any attribute the card gets a definition for from elsewhere, for example through&nbsp;<a class=\"reference-link\" href=\"#root/_help_KC1HB96bqqHX\">Templates</a>&nbsp;or another parent note it is cloned under. Attributes that only the cards define are listed after the board's own.</p></aside><p>Here is an example of the attributes you can define for a typical Kanban board used to track tasks:</p><figure class=\"table\"><table><thead><tr><th>Attribute name</th><th>Attribute type</th><th>Attribute display name</th></tr></thead><tbody><tr><td>dueDate</td><td>Date &amp; Time</td><td>Due date</td></tr><tr><td>priority</td><td>Select (options: Low, Medium, High, Urgent)</td><td>Priority</td></tr><tr><td>done</td><td>Checkbox</td><td>Done</td></tr></tbody></table></figure><h4>Modifying the values of custom attributes</h4><p>To set the value of a custom attribute, click or tap the card, and then enter or select the desired value in the dialog header.</p><p>For attributes of the “select”, “checkbox” or “date” type, you can quickly change the value by using the card's context menu under the <em>Attributes</em> section. A date attribute's submenu offers <em>Today</em>, <em>Tomorrow</em> and <em>Next week</em> (the first day of next week, as set in the first day of the week option), and <em>Not set</em> to clear the value; any other date is entered in the dialog header.</p><h4>Reordering, hiding, redefining, and deleting custom attributes</h4><p>Go to&nbsp;<a class=\"reference-link\" href=\"#root/_help_8YBEPzcpUgxw\">Note menu</a> → <em>Board properties</em>. Under the <em>Card attributes</em> section, you can:</p><ul><li>Hold the <strong>=</strong> handle shown beside an attribute, and then drag the item up or down to reorder the attributes. This determines the order in which the attributes are displayed on the card.</li><li>Turn off the toggle to hide an attribute from the card's face. The attribute remains available when you edit the card. For the current grouping attribute, the toggle is disabled.</li><li>Press the&nbsp;<span class=\"tn-icon bx bxs-edit\"></span> button to modify the definition of an attribute.</li><li>Press the&nbsp;<span class=\"tn-icon bx bx-trash\"></span> button to delete the attribute and all its values from every note in the board collection.</li></ul><p>Attributes that the cards get from a template or another parent note can be reordered and hidden here, but not modified or deleted. Edit them on the note that defines them.</p><p>If cards define an attribute with the same name but a different type or different select options, for example through two different templates, or if a card overrides the board's definition with its own, the attribute is marked <em>Multiple definitions</em>. Such an attribute is sorted as text and does not appear in the card's context menu.</p><h3>Managing card templates</h3><p>When you create a new card, Trilium offers four templates by default: <em>Text</em>, <em>Markdown</em>, <em>Canvas</em>, and <em>Spreadsheet</em>. You can customize this list to include other note types or custom templates with predefined placeholder content and prefilled card attributes.</p><p>To customize the card templates, go to&nbsp;<a class=\"reference-link\" href=\"#root/_help_8YBEPzcpUgxw\">Note menu</a> → <em>Board properties</em> and find <em>Card templates</em>. Here you can:</p><ul><li>Include a note type or note template already created in your knowledge base by pressing the&nbsp;<span class=\"tn-icon bx bx-list-plus\"></span> <em>Add existing template</em> button and then selecting the desired note type or template.</li><li>Create a new template by pressing the&nbsp;<span class=\"tn-icon bx bx-plus\"></span> <em>Create a new template</em> button. The template editor will open, where you can define the icon, title, default attribute values, and default content. The note template will be created as a child of the board collection.</li><li>Press the&nbsp;<span class=\"tn-icon bx bx-x\"></span> button to remove a template from the list. The template is removed only from the list, not deleted from your knowledge base. You can add it again using&nbsp;<span class=\"tn-icon bx bx-list-plus\"></span> <em>Add existing template</em>.</li><li>Press the&nbsp;<span class=\"tn-icon bx bx-dots-vertical-rounded\"></span> button to open a dropdown that lets you edit, open in a new window, duplicate, or delete a template. This button is visible only for custom note templates.</li><li>Hold the <strong>=</strong> handle shown beside a template, and then drag the item up or down to reorder the templates. This determines the order in which templates are listed in the template dropdown when you create a new card. You can move the most frequently used templates to the top for faster access.</li></ul><h3>Grouping cards</h3><p>On a board, cards are grouped into columns. The column to which a card belongs is determined by the value of the <strong>grouping attribute</strong>, which is a regular attribute of the card's note.</p><p>By default, boards use the <strong>Status</strong> attribute as the grouping attribute. When you move a card to a column called “Waiting on Customer”, the card's Status attribute is set to “Waiting on Customer”.</p><aside class=\"admonition note\"><p>Under the hood, the Status attribute is declared on the board collection note with the name <code>status</code>. It is a select-type attribute that is inheritable and promoted. Each select option becomes a column, and each new column created on the board extends the list of options.</p></aside><h4>Creating a new grouping attribute</h4><p>To quickly create a new grouping attribute:</p><ol><li>Open the&nbsp;<span class=\"tn-icon bx bx-category-alt\"></span> <em>Group by</em> dropdown in the board header and select&nbsp;<span class=\"tn-icon bx bx-plus\"></span> <em>Create a new attribute</em>.</li><li>Fill in the <em>Name</em> field. This is used internally by Trilium, so do not use spaces or special characters.</li><li>Enter the <em>Display name</em>. This is the attribute name shown in the dropdown list.</li><li>Press <em>Save &amp; close</em>.</li></ol><aside class=\"admonition tip\"><p>Because the grouping attribute is a regular card attribute, you can also create it in <em>Board properties</em>. Make sure you set the attribute type to “select”.</p></aside><h4>Switching the grouping attribute</h4><p>Switching the grouping attribute lets you view your cards by priority, category, or any other custom grouping attribute. You can switch the grouping attribute at any time by using the&nbsp;<span class=\"tn-icon bx bx-category-alt\"></span> <em>Group by</em> dropdown in the board header. You can also change it using the <code>#board:groupBy=&lt;_attribute name_&gt;</code> label.</p><aside class=\"admonition warning\"><p>The order of cards in manually sorted columns corresponds to their positions within the board collection subtree. This means that the card order is shared across all views, regardless of the grouping attribute. Reordering notes in one view will also reorder them in other views that use a different grouping attribute.</p></aside><h4>Deleting a grouping attribute</h4><p>To delete a grouping attribute, go to&nbsp;<a class=\"reference-link\" href=\"#root/_help_8YBEPzcpUgxw\">Note menu</a> → <em>Board properties</em>, find the attribute under the <em>Card attributes</em> section, and press the corresponding&nbsp;<span class=\"tn-icon bx bx-trash\"></span> button.</p><h4>Grouping by relations</h4><p>A more advanced use case is grouping by <a href=\"#root/_help_Cq5X6iKQop6R\">Relations</a>.</p><p>In this mode:</p><ul><li>The columns represent the <em>target notes</em> of a relation.</li><li>When creating a new column, you select a note instead of entering a column name.</li><li>The column icon matches the target note.</li><li>Moving notes between columns changes their relations.</li><li>Renaming an existing column changes the target note for all notes in that column.</li></ul><p>Using relations instead of labels has several benefits:</p><ul><li>The status or grouping of notes is visible outside the Kanban board, for example, on the&nbsp;<a class=\"reference-link\" href=\"#root/_help_bdUJEHsAPYQR\">Note Map</a>.</li><li>A column takes its title and icon from the target note, so renaming that note anywhere in the tree renames the column.</li></ul><p>To use relations for grouping:</p><ol><li><p>Create a Kanban board from scratch rather than from a template.</p></li><li><p>Assign <code>#viewType=board #hidePromotedAttributes</code> to emulate the default template.</p></li><li><p>Set <code>#board:groupBy</code> to the name of a relation, <strong>including the</strong> <code>~</code> <strong>prefix</strong> (for example, <code>~status</code>).</p></li><li><p>Optionally, use&nbsp;<a class=\"reference-link\" href=\"#root/_help_OFXdgB2nNk1F\">Promoted Attributes</a>&nbsp;to make changing the status within the note easier:</p><pre><code class=\"language-text-x-trilium-auto\">#relation:status(inheritable)=\"promoted,alias=Status,single\"</code></pre></li></ol><h2>Searching and filtering the board</h2><p>You can search for cards using the search box at the top of the board. Enter your keywords, and then press the&nbsp;<span class=\"tn-icon bx bx-search\"></span> button in the search field or press <kbd>Enter</kbd>. Only cards whose titles, content, or attribute values match the query will be displayed. Columns without results will be temporarily collapsed to make room for the matching cards. Press the&nbsp;<span class=\"tn-icon bx bx-x\"></span> button in the search field to clear the search and display all cards again.</p><h3>Advanced filtering</h3><p>If you need to refine the view to display only cards matching specific criteria beyond a regular text search, you can use Trilium's search query syntax. Here are some example queries:</p><p>Display only cards whose <strong>Priority</strong> attribute is set to “Low”:</p><pre><code class=\"language-text-x-trilium-auto\">#priority=Low</code></pre><p>Display only cards whose <strong>Issue Category</strong> is set to “Software” and whose <strong>Site</strong> is set to either “Office” or “Factory”:</p><pre><code class=\"language-text-x-trilium-auto\">#issueCategory=\"Software\" AND (#site=\"Office\" OR #site=\"Factory\")</code></pre><p>Display only cards with a <strong>Due Date</strong> in the next seven days that are not yet marked as <strong>Done</strong>:</p><pre><code class=\"language-text-x-trilium-auto\">#dueDate &gt;= TODAY AND #dueDate &lt;= TODAY+7 AND #!done</code></pre><p>The filter persists even after you close the tab. When you reopen the collection, the filter remains active until you clear the search query by using the&nbsp;<span class=\"tn-icon bx bx-x\"></span> button.</p><h2>Linking to a column or a card</h2><p>You can create a link that opens the board and points out a specific column or card. Open the column menu or the card’s context menu, select&nbsp;<span class=\"tn-icon bx bx-copy\"></span> <em>Copy reference</em>, and then paste the link where you need it.</p><p>In a text note, the pasted link displays the title, icon, and color of the column or card it points to. In a Markdown or code note, the plain link address is pasted instead. Opening the link scrolls the board to the column or card and focuses it. If the column belongs to a different grouping attribute, the board switches to that attribute first.</p><h2>Read-only boards</h2><p>A board marked as <a href=\"#root/_help_CoFPLs3dRlXc\">read-only</a> only shows its cards. It has no buttons to add a card or a column, column and card titles can't be renamed, and column icons can't be changed. Cards and columns can't be dragged, moved or deleted with the keyboard, and notes dragged in from the note tree aren't added. The context menus of a card or a column keep only the entries that change nothing, such as opening the note or <span class=\"tn-icon bx bx-copy\"></span> <em>Copy reference</em>, and the board's own menu doesn't open. The cards can still be grouped by another attribute, but the choice isn't saved, and no new grouping attribute can be created.</p>",
"_help_81SGnPGMk7Xc": "<figure class=\"image\"><img style=\"aspect-ratio:1561/1149;\" src=\"{{helpAssets}}/User%20Guide/Collections/Geo%20Map_image.png\" width=\"1561\" height=\"1149\"></figure><p>This note type displays the children notes on a geographical map, based on an attribute. It is also possible to add new notes at a specific location using the built-in interface.</p><h2>Features</h2><ul><li>Add markers on the map, which can be customized with icons, colors and text.</li><li>Search the notes already on the map, and look up places anywhere in the world.</li><li>Turn a place the map already shows into a marker by clicking it.</li><li>Draw paths, areas, rectangles and circles onto the map.</li><li>Display tracks on the map using <code>.gpx</code> files.</li><li>Show your own location on the map and follow it as you move.</li><li>3D view of the map, which displays buildings when using a vector map.</li></ul><h2>System requirements</h2><p>Starting with v0.105.0, the geomap uses MapLibre GL which requires WebGL v1 support. In general, most devices will support it because browsers/Electron can render it in software if needed.</p><p>If the map could not be drawn because WebGL could not be initialized, an error message will appear instead of the map (<em>This map can't be drawn because WebGL isn't available…</em>).</p><p>The button that shows your location is offered only when Trilium is reached over HTTPS, in the desktop application or in the mobile application. Browsers refuse to share the location of a device with a page served over plain HTTP, so on such a server the button does not appear.</p><h2>Interaction</h2><ul><li>At the top-left there is the search bar. It searches the notes already on the map, and it can also search for places online when you ask it to. While you move through the results of a search, a counter with previous (<span class=\"tn-icon bx bx-chevron-left\"></span>) and next (<span class=\"tn-icon bx bx-chevron-right\"></span>) buttons appears under it.</li><li>At the bottom-center there is a central toolbar which provides editing features: adding new markers on the map (<span class=\"tn-icon bx bx-pin\"></span>) and importing GPX tracks (<span class=\"tn-icon bx bx-trip\"></span>).</li><li>At the bottom-right there are the viewport items:<ul><li>Zoom in/out (<span class=\"tn-icon bx bx-plus-circle\"></span> / <span class=\"tn-icon bx bx-minus-circle\"></span>)<ul><li>On mobile these are hidden, use pinch to zoom instead.</li><li>On desktop, alternatively use the scroll wheel to adjust the zoom.</li></ul></li><li>A <span class=\"tn-icon bx bx-current-location\"></span> button that shows your location on the map and follows it (see <em>Going to your location</em> below).</li><li><span class=\"tn-icon bx bx-fullscreen\"></span> Full screen button which focuses the entire map onto the screen, while still allowing for edits.</li></ul></li><li>At the top-center (on desktop, or left-center on mobile and in split views) there are the drawing tools such as paths, areas, rectangles and circles.<ul><li>When the map is read-only, the toolbar is not shown.</li></ul></li></ul><h2>Creating a new geo map</h2><p>Right click on an existing note in the&nbsp;<a class=\"reference-link\" href=\"#root/_help_oPVyFC7WL2Lp\">Note Tree</a>&nbsp;and select <em>Insert child note</em> → <em>Collection</em> → <em>Geo Map</em>.</p><p>By default the map will be empty and will show the entire world.</p><h2>Repositioning the map</h2><ul><li>Click and drag the map in order to move across the map.</li><li>Use the mouse wheel, two-finger gesture on a touchpad or the +/- buttons on the bottom-right to adjust the zoom.</li></ul><p>The position on the map and the zoom are saved inside the map note and restored when visiting again the note.</p><p>A map that has no position saved yet is framed around the markers it contains when you open it, so they are all in view without having to go looking for them. A map that contains no markers shows the whole world instead.</p><p>In practice this applies to maps whose markers were added externally, by a script or through&nbsp;<a class=\"reference-link\" href=\"#root/_help_pgxEVkzLl1OP\">ETAPI (REST API)</a>. When you add markers yourself you have already moved the map to reach the place you are marking, and that movement saves a position.</p><h2>Going to your location</h2><p>Press the <em>Show your location</em> (<span class=\"tn-icon bx bx-current-location\"></span>) button at the bottom-right of the map, beside the zoom buttons. The first time, the browser or the operating system asks whether Trilium may know where the device is. In the desktop application the operating system's location settings decide.</p><p>The map then moves to where the device is and marks it with a blue dot. A lighter circle around the dot shows how accurate the position is: a phone with GPS gives a dot on the street, while a computer located through its network connection can give a circle that covers a neighbourhood. The map follows the dot as it moves, and the button stays pressed while it does.</p><p>Dragging the map stops it from following. The dot stays and keeps moving, and pressing the button again brings the map back to it. Pressing the button while the map is following turns the dot off.</p><p>Click the dot to see its coordinates in the panel a searched place is shown in. From there the position can be kept as a marker (see <em>Keeping a place as a marker</em>). Clicking the lighter circle around the dot is a click on the map.</p><p>If the position cannot be found, a message says so and the button keeps waiting for one; press it again to stop. If you refuse the permission, the button is disabled until the map is opened again. To allow it after all, change the permission for Trilium in the browser or in the system's location settings.</p><p>Your position is not stored in the note, and Trilium does not send it anywhere on its own. Moving the map there does what any other pan or zoom does: the tile provider behind the map's style sees the coordinates of the area now on screen. The map does remember where you left it, as it does after any other movement, so a map you have taken to your location opens there the next time.</p><h2>Searching the map</h2><p>The search bar at the top-left of the map searches in two places. It always searches the notes that are already on the map. It can also search for places online, but only when you ask it to.</p><h3>Searching the notes already on the map</h3><p>Type in the search bar, and the notes on the map are matched by their title as you type. Accents are ignored, both in what you type and in the titles, so <code>zurich</code> finds <em>Zürich Hauptbahnhof</em>. Each word is searched for on its own, so <code>hotel paris</code> finds <em>Paris Hotel</em>. Notes without a <code>#geolocation</code> attribute are not offered, since there would be nowhere to go. Drawn shapes and GPS tracks are offered, even though they carry no such attribute: selecting one brings the whole shape or route into view.</p><p>If more notes match than the list can show, you are offered the ones closest to the area you are viewing.</p><h3>Searching for places online</h3><p>Looking up a place sends what you typed to a third-party service. For this reason, it never happens while you type. Instead, the last row of the result list offers the search. That row reads <em>Search online for \"…\"</em>, with the name of the service below it. The search runs only when you press that row or select it with Enter.</p><p>Trilium uses Nominatim, the place search run by the OpenStreetMap Foundation. It needs no account and no API key. Its name is shown on every row that belongs to it: the row that offers the search, the row that says a search is running, and the row that reports that nothing was found or that the service could not be reached.</p><p>The search prefers the area you are viewing. Places inside the current view are searched for first and listed above the others. If you search for a shop while looking at your own town, you therefore find the branch in that town, and not one with the same name on another continent. The view is always treated as at least 25 km across, so a search made while zoomed into a single street still covers the town around it.</p><h3>Going to a point</h3><p>If you type or paste coordinates into the search bar, a <em>Go to</em> row is offered above all the other results. Selecting it moves the map to that exact spot and marks it. You can then keep it as a marker, in the same way you keep a place found by searching.</p><p>Points are untitled by default; the corresponding note opens with the default name selected so it can be easily replaced. If the map has a&nbsp;<a class=\"reference-link\" href=\"#root/_help_47ZrP6FNuoG8\">Default Note Title</a>&nbsp;label, the marker is named by that template instead.</p><p>The supported forms are:</p><ul><li>A plain pair, such as <code>45.9432, 24.9668</code>. This is what Google Maps and OpenStreetMap both give you when you ask for the coordinates of a place, and it is also what the <code>#geolocation</code> attribute holds.</li><li>The <code>geo:</code> link that the map itself offers for a place, through the <em>Open location</em> action.</li><li>The address of a place on Google Maps or OpenStreetMap, pasted whole.</li></ul><p>A pair that is not a place on Earth, such as <code>1234, 5678</code>, is not offered.</p><h3>Reading the results</h3><p>Results are gathered under headings, and each group is ordered by distance from the middle of the map:</p><ul><li><em>On this map</em>: notes that are already on the map, whatever their distance.</li><li><em>Nearby</em>: places found within about 25 km of the view.</li><li><em>Far away</em>: all the other places.</li></ul><p>The headings only appear when at least two of the three groups contain something. Every row that has a position shows how far away it is, in kilometres or miles according to your locale. A place found online shows its name on the first line and its address on the second.</p><h3>Selecting a result</h3><p>Selecting a note already on the map moves to its marker and opens the note beside the map, as clicking the marker would.</p><p>Selecting a place found online moves the map to it and marks it with a temporary pin. The pin has a different color from the map's own markers. The map is fitted to the area that the place covers, so a country fills the view, while a house is shown at street level. Some places have a boundary, such as a country, a county or a park. When the service reports one, that boundary is outlined under the pin.</p><p>A panel then opens with the place's full address and its coordinates: in the top-right corner on desktop, and at the bottom of the map on mobile, where the top is kept for the search bar and the result counter. Pressing the coordinates copies them to the clipboard.</p><h3>Keeping a place as a marker</h3><p>Press <em>Add as marker</em> in that panel to keep the place. A child note is created under the map. It takes the name of the place, as well as the icon, which matches the kind of place it is. Its <code>#geolocation</code> attribute is already set. The note opens beside the map, so you can edit it straight away. The temporary pin disappears, because the place is now a marker like any other.</p><p>The button is not offered on a map that cannot be edited, where the panel can still be read.</p><p>Press the panel's close button, or the Escape key, to send the place away without keeping it. The pin goes with it.</p><h3>Stepping through the results</h3><p>Once you select a result, a counter appears under the search bar, with a previous (<span class=\"tn-icon bx bx-chevron-left\"></span>) and a next (<span class=\"tn-icon bx bx-chevron-right\"></span>) button. These buttons move through everything the search offered, in the order it was listed. You can therefore compare several results without opening the list again. Pressing the counter itself moves the map back to the current result, which is useful after you have moved the map away from it.</p><h3>The keyboard</h3><ul><li><kbd>Enter</kbd> runs the online search when its row is the one selected, and otherwise moves to the highlighted result. Pressed after a result has been taken, it brings the list back.</li><li><kbd>Escape</kbd> closes the result list, and closes the place panel.</li><li>Returning to the search bar reopens the list it was showing.</li><li>The <span class=\"tn-icon bx bx-x\"></span> button at the end of the bar empties it, which also takes a searched place, its pin and its panel off the map.</li></ul><h2>Adding a marker using the map</h2><h3>Adding a new note using the <em>Add marker</em> button</h3><ol><li><p>To create a marker, first navigate to the desired point on the map. Then press the <em>Add marker</em> (<span class=\"tn-icon bx bx-pin\"></span>) button at the center-bottom of the map.</p></li><li><p>Once pressed, the map will enter in the insert mode, as illustrated by the notification. Additionally, a preview of the marker will be shown at the cursor position.</p><p>Simply click the point on the map where to place the marker. To cancel, press either the &nbsp;Escape key or press again the <em>Add marker</em> button.</p></li><li><p>Once clicked, the marker will show up on the map and a popup will show to the right with the title already selected to be changed.</p></li></ol><h3>Adding a new note using the contextual menu</h3><ol><li>Right click anywhere on the map, where to place the newly created marker (and corresponding note).</li><li>Select <em>Add a marker at this location</em> (<span class=\"tn-icon bx bx-pin\"></span>).</li><li>Once clicked on a position on the map, the marker will show up on the map and a popup will show to the right with the title already selected to be changed.</li></ol><h3>Adding an existing note from the note tree</h3><ol><li>Select the desired note in the&nbsp;<a class=\"reference-link\" href=\"#root/_help_oPVyFC7WL2Lp\">Note Tree</a>.</li><li>Hold the mouse on the note and drag it to the map to the desired location.</li><li>The map should be updated with the new marker.</li></ol><p>This works for:</p><ul><li>Notes that are not part of the geo map, case in which a <a href=\"#root/_help_IakOLONlIfGI\">clone</a> will be created.</li><li>Notes that are a child of the geo map but not yet positioned on the map.</li><li>Notes that are a child of the geo map and also positioned, case in which the marker will be relocated to the new position.</li></ul><aside class=\"admonition note\"><p>Dragging existing notes only works if the map is in editing mode. See the <em>Read-only</em> section for more information.</p></aside><h3>Adding a note from a place the map already shows</h3><p>When a vector map style is used, the map itself draws the shops, cafés, museums and other places around the area being viewed. Once the map is zoomed in far enough for these to be drawn, they can be clicked:</p><ol><li>Look for the places drawn in orange. This is the same color used for a place found by searching. These are the places you can click. They are drawn almost solid, while the other places on the map stay a faint grey.</li><li>Rest the mouse on one of them. Its name appears above it, and the mouse cursor changes to a pointer. The map draws these places as icons without names, so you read a name by hovering over it. If all the names were shown at once, they would crowd out the titles of your own markers.</li><li>Click it. The same panel used for a place found by searching appears. It shows the name of the place and its coordinates, and a pin is placed on the map.</li><li>Press <em>Add as marker</em> to keep it. The note is created with the name of the place as its title, and with the icon that matches the kind of place it is.</li></ol><p>Places are read from the map data that has already been downloaded, so clicking one does not send anything to the internet.</p><p>Some things to keep in mind:</p><ul><li>Places with no name in the map data, such as benches or parking spaces, show no name and cannot be clicked. Clicking them does nothing, just like clicking an empty part of the map.</li><li>The map's own markers come first. If a marker covers a place, clicking it opens the note and not the place.</li><li>This does not work with the raster (OpenStreetMap) style, because its places are part of the map image. It also does not work with the <em>Neutrino</em> style, which draws no places.</li><li>In read-only mode you can still click a place and read it, but you cannot keep it as a marker.</li></ul><h2>How the location of the markers is stored</h2><p>The location of a marker is stored in the <code>#geolocation</code> attribute of the child notes:</p><p>This value can be added manually if needed. The value of the attribute is made up of the latitude and longitude separated by a comma.</p><p>On an image map, the position is stored in <code>#mapPosition</code> instead (see&nbsp;<a class=\"reference-link\" href=\"#root/_help_ZRDXGc0nAIh4\">Image maps</a>).</p><h2>Repositioning markers</h2><p>Once a marker is set, it can be repositioned using one of the two ways:</p><ul><li>By right clicking the marker and selecting <em>Move to another location</em> (<span class=\"tn-icon bx bx-move\"></span>).</li><li>By clicking the marker to open the popup and selecting the <em>Move to another location</em> (<span class=\"tn-icon bx bx-move\"></span>) button underneath the title bar.</li></ul><p>After clicking the button to move the marker, click at the desired position on the map to replace it. To cancel the operation, press Escape.</p><aside class=\"admonition note\"><p>If the map is locked for editing (see below), the map needs to be unlocked before moving the marker.</p></aside><h2>Interaction with the markers, tracks or shapes</h2><ul><li>Hovering over a marker will display a&nbsp;<a class=\"reference-link\" href=\"#root/_help_lgKX7r3aL30x\">Note Tooltip</a>&nbsp;with the content of the note it belongs to.<ul><li>Clicking on the note title in the tooltip will navigate to the note in the current view.</li></ul></li><li>Right-clicking the marker will open a contextual menu (as described below).</li><li>Clicking a marker will focus on the marker and display a dedicated popup with the details. This works regardless of whether the map is editable or not.</li></ul><h3>Popup view</h3><p>When a marker, a <a href=\"#root/_help_C2H9HK4BzwG7\">shape</a>, or track is clicked, a popup will open to the right which contains the following information:</p><ul><li>The title and icon of the marker, both editable.</li><li>An indicator for the coordinates (<span class=\"tn-icon bx bx-crosshair\"></span>); clicking it will copy the coordinates to clipboard.</li><li>A <span class=\"tn-icon bx bx-expand-alt\"></span> button to maximize the popup.</li><li>Buttons to interact with the current item:<ul><li><span class=\"tn-icon bx bx-log-in\"></span> Open the marker in the same pane, or use <span class=\"tn-icon bx bx-dots-horizontal-rounded\"></span> to open it in a new tab, split, etc.</li><li>A <span class=\"tn-icon bx bx-map-alt\"></span> button to open the location in a dedicated application (e.g. Google Maps on mobile).</li><li><span class=\"tn-icon bx bx-palette\"></span> Color picker to change the color of the marker.</li><li><span class=\"tn-icon bx bx-move\"></span> Markers can also be moved, unlike tracks or shapes (which need to be redrawn).</li><li><span class=\"tn-icon bx bx-trash\"></span> Button to remove the marker from the map, which can optionally delete its corresponding note.<ul><li>Removing a marker without deleting the note will only remove its <code>#geolocation</code> attribute (case in which the coordinates have to be manually added back in in order to get the note to show on the map again).</li><li>Similarly, removing a shape will remove its <code>#geoShape</code> attribute.</li></ul></li></ul></li><li>The&nbsp;<a class=\"reference-link\" href=\"#root/_help_OFXdgB2nNk1F\">Promoted Attributes</a>&nbsp;of the marker, if any.</li><li>The note's content which can be edited directly from the panel.</li></ul><p>To dismiss the popup:</p><ul><li>Press the X button at the top-right of the popup.</li><li>In the map, press anywhere outside the popup.</li><li>Or simply press the Escape key.</li></ul><p>When a marker is clicked, the map will automatically adjust the viewport so that the marker is still visible with the popup open. The currently selected marker is shown slightly bigger.</p><p>It is possible to switch between markers by clicking on them even when the popup view is already open.</p><p>Markers can have&nbsp;<a class=\"reference-link\" href=\"#root/_help_hrZ1D00cLbal\">Internal (reference) links</a>&nbsp;between them and clicking on such a link will automatically adjust the viewport and the popup view to the new note.</p><h3>Contextual menu</h3><p>It's possible to press the right mouse button to display a contextual menu.</p><ol><li>If right-clicking an empty section of the map (not on a marker), it allows to:<ol><li><span class=\"tn-icon bx bx-crosshair\"></span> Displays the latitude and longitude. Clicking this option will copy them to the clipboard.</li><li><span class=\"tn-icon bx bx-map-alt\"></span> Open the location using an external application (if the operating system supports it).</li><li><span class=\"tn-icon bx bx-pin\"></span> Adding a new marker at that location.</li></ol></li><li>If right-clicking on a marker, it allows to:<ol><li><span class=\"tn-icon bx bx-crosshair\"></span> Displays the latitude and longitude. Clicking this option will copy them to the clipboard.</li><li><span class=\"tn-icon bx bx-map-alt\"></span> Open the location using an external application (if the operating system supports it).</li><li>Open the note in a new tab, split or window.</li><li><span class=\"tn-icon bx bx-move\"></span> Move the marker to another location.</li><li><span class=\"tn-icon bx bx-trash\"></span> Button to remove the marker from the map, which can optionally delete its corresponding note. Removing a marker without deleting the note will only remove its <code>#geolocation</code> attribute (case in which the coordinates have to be manually added back in in order to get the note to show on the map again).</li></ol></li><li>Shapes can also be right-clicked and the menu is similar to markers except they cannot be moved.</li></ol><h3>Icon and color</h3><figure class=\"image image-style-align-right image_resized\" style=\"width:47.42%;\"><img style=\"aspect-ratio:885/321;\" src=\"{{helpAssets}}/User%20Guide/Collections/3_Geo%20Map_image.png\" width=\"885\" height=\"321\"></figure><p>The markers will have the same icon as the note.</p><p>It's possible to add a custom color to a marker by assigning them a <code>#color</code> attribute such as <code>#color=green</code>.</p><p>This also applies to tracks and <a href=\"#root/_help_C2H9HK4BzwG7\">shapes</a>.</p><aside class=\"admonition note\"><p>The color as it will be displayed on the map might be slightly tinted in order to make the text or icon more legible.</p></aside><h3>Adding the coordinates manually</h3><p>Searching for the place is usually quicker (see <em>Searching the map</em> above). The steps below remain useful for a coordinate that is already to hand, or for a place the search cannot find.</p><p>In a nutshell, create a child note and set the <code>#geolocation</code> attribute to the coordinates.</p><p>The value of the attribute is made up of the latitude and longitude separated by a comma.</p><h4>Adding from Google Maps</h4><ol><li>In Google Maps, on the web:<ol><li>Look for a desired location, right click on it and a context menu will show up.</li><li>Simply click on the first item displaying the coordinates and they will be copied to clipboard.</li></ol></li><li>In Trilium, create a child note under the map.</li><li>Then paste the value inside the text box into the <code>#geolocation</code> attribute of a child note of the map (don't forget to surround the value with a <code>\"</code> character).</li></ol><h4>Adding from OpenStreetMap</h4><p>Similarly to the Google Maps approach:</p><ol><li>Go to any location on openstreetmap.org and right click to bring up the context menu. Select the <em>Show address</em> item.</li><li>The address will be visible in the top-left of the screen, in the place of the search bar.&nbsp;Select the coordinates and copy them into the clipboard.</li><li>Simply paste the value inside the text box into the <code>#geolocation</code> attribute of a child note of the map and then it should be displayed on the map.</li></ol><h2>Drawing shapes on the map</h2><p>See the dedicated&nbsp;<a class=\"reference-link\" href=\"#root/_help_C2H9HK4BzwG7\">Drawing shapes</a>&nbsp;page.</p><h2>Using an image instead of the world map</h2><p>A geo map can be drawn over an image of your own, such as a floor plan or a fantasy map, with markers placed in the image's pixels. See&nbsp;<a class=\"reference-link\" href=\"#root/_help_ZRDXGc0nAIh4\">Image maps</a>.</p><h2>Adding GPS tracks (.gpx)</h2><figure class=\"image\"><img style=\"aspect-ratio:1566/1155;\" src=\"{{helpAssets}}/User%20Guide/Collections/1_Geo%20Map_image.png\" width=\"1566\" height=\"1155\"></figure><p>Trilium can display GPS tracks on the geo map, in the form of <code>.gpx</code> files.</p><p>To add a track, either:</p><ol><li>Drag &amp; drop a <code>.gpx</code> file inside the geo map in the note tree.<ol><li>In order for the file to be recognized as a GPS track, it needs to show up as <code>application/gpx+xml</code> in the <em>File type</em> field.</li></ol></li><li>Press the <em>Add a GPS track from a GPX file</em> (<span class=\"tn-icon bx bx-trip\"></span>) button which will directly prompt for a GPX file and import it as a subnote of the collection.</li></ol><p>When going back to the map, the track should now be visible.</p><p>The starting point of the track will be displayed as a marker, with the name of the note underneath. The start marker will also respect the icon and the <code>color</code> of the note. The end marker is displayed with a distinct icon.</p><p>If the track file contains multiple tracks, they will all be displayed as well as markers. Trilium will also split a single track that happens to have non-continuous points.</p><p>If the GPX contains waypoints, they will also be displayed, including their names.</p><p>When the track is clicked, the entire route is brought into view, as well as the right popup will indicate details about the track such as distance, duration and the elevation map. This information is also displayed when clicking the <code>.gpx</code> note itself.</p><p>When clicking on the markers of a track (whether it's the start or stop builtin markers, or custom markers that are part of the track), only that marker is brought into view, as opposed to the entire route.</p><h2>Read-only mode</h2><p>When a map is <a href=\"#root/_help_CoFPLs3dRlXc\">read-only</a> all editing features will be disabled such as:</p><ul><li>The <em>Add marker</em> (<span class=\"tn-icon bx bx-pin\"></span>) button at the bottom of the map.</li><li>Repositioning markers.</li><li>Editing from the contextual menu (removing locations or adding new items).</li><li>Keeping a place as a marker, whether you found it by searching or clicked it on the map. You can still search and click, and you can still look at a place and copy its coordinates.</li><li>Drawing <a href=\"#root/_help_C2H9HK4BzwG7\">shapes</a>.</li><li>The <em>Geo map properties</em> dialog; its entry is hidden from the&nbsp;<a class=\"reference-link\" href=\"#root/_help_8YBEPzcpUgxw\">Note menu</a>.</li></ul><p>To set a map as read-only, go to&nbsp;<a class=\"reference-link\" href=\"#root/_help_8YBEPzcpUgxw\">Note menu</a>&nbsp;→ <em>Editable</em> → <em>Read-only</em>.</p><h2>Configuration</h2><h3>Map Style</h3><p>The styling of the map can be adjusted in the&nbsp;<a class=\"reference-link\" href=\"#root/_help_CssoWBu8I7jF\">Collection Properties</a>, under <em>Background</em> in the <em>Geo map properties</em> dialog, or manually via the <code>#map:style</code> attribute.</p><p>The geo map comes with two different types of styles:</p><ul><li>Raster styles<ul><li>For these styles the map is represented as a grid of images at different zoom levels. This is the traditional way OpenStreetMap used to work.</li><li>Zoom is slightly restricted.</li><li>Currently, the only raster theme is the original OpenStreetMap style.</li></ul></li><li>Vector styles<ul><li>Vector styles are not represented as images, but as geometrical shapes. This makes the rendering much smoother, especially when zooming and looking at the building edges, for example.</li><li>The map can be zoomed in much further.</li><li>These come in various styles that are both light (Colorful, Graybeard, Neutrino) and dark (Eclipse, Shadow).</li><li>The vector styles come from <a href=\"https://versatiles.org/\">VersaTiles</a>, a free and open-source project providing map tiles based on OpenStreetMap.</li><li>The VersaTiles layers also provide 3D building information (see below).</li></ul></li></ul><p>The default theme is Versatiles Colorful (vector).</p><h4>3D view with buildings</h4><figure class=\"image\"><img style=\"aspect-ratio:2727/1642;\" src=\"{{helpAssets}}/User%20Guide/Collections/2_Geo%20Map_image.png\" width=\"2727\" height=\"1642\"></figure><p>Trilium v0.105.0 introduces a 3D view, courtesy of MapLibre GL. To enter 3D mode, simply press the <em>3D</em> button at the bottom-right of the map or press Ctrl and drag across the map.</p><p>The buildings will only appear from zoom 14 onwards to avoid lag.</p><aside class=\"admonition note\"><p>To get 3D buildings, make sure you are using the <em>VersaTiles</em> styles which provide the building informatia via the <code>versatiles-shortbread</code> source.</p></aside><h3>Custom map style / tiles</h3><p>Starting with v0.102.0 it is possible to use custom tile sets, but only in raster format.</p><p>To use one:</p><ol><li>Open the <em>Geo map properties</em> dialog from the <a class=\"reference-link\" href=\"#root/_help_8YBEPzcpUgxw\">Note menu</a>.</li><li>Under <em>Background</em>, set <em>Type</em> to <em>Custom tileset</em>.</li><li>In <em>Tile URL</em>, enter the address of the tile set, with <code>{z}</code>, <code>{x}</code> and <code>{y}</code> where the zoom level and the position of the tile go. For example, to use Esri.NatGeoWorldMap, enter <a href=\"https://server.arcgisonline.com/ArcGIS/rest/services/NatGeo_World_Map/MapServer/tile/%7Bz%7D/%7By%7D/%7Bx%7D\"><code>https://server.arcgisonline.com/ArcGIS/rest/services/NatGeo_World_Map/MapServer/tile/{z}/{y}/{x}</code></a>. The URL is saved once you leave the field; a URL that doesn't start with <code>http://</code> or <code>https://</code>, or that lacks one of the three placeholders, is not saved. A map drawn over an image keeps its image until a URL is saved.</li><li>If the tiles are dark, turn on <em>Dark tileset</em>, which draws the marker titles in a light color so that they remain readable.</li></ol><p>Additionally:</p><ul><li>Hi-DPI tiles are supported via the <code>{r}</code> placeholder.</li><li>Servers that number their tiles by quadkey are supported via the <code>{quadkey}</code> placeholder, in place of <code>{z}</code>, <code>{x}</code> and <code>{y}</code>.</li></ul><p>To go back to a built-in style, set <em>Type</em> back to <em>Vector &amp; Raster</em>. The tile set is switched off rather than removed: its label is renamed to <code>#disabled:map:style</code>, so setting <em>Type</em> to <em>Custom tileset</em> again brings back the same URL. A tile set inherited from a parent note or a template is overridden by the default style instead.</p><p>The tile set can also be set manually: the URL goes in the <code>#map:style</code> <a href=\"#root/_help_HI6GBBIduIgv\">label</a>, and the <code>#map:darkStyle</code> label marks it as dark. <code>#map:darkStyle</code> also overrides the built-in styles.</p><aside class=\"admonition note\"><p>For a list of tile sets, see the <a href=\"https://leaflet-extras.github.io/leaflet-providers/preview/\">Leaflet Providers preview</a> page. Select a desired tile set and just copy the URL from the <em>Plain JavaScript</em> example.</p></aside><p>Custom vector map support is planned, but not yet implemented.</p><h3>Other options</h3><p>The following options can be configured either via the&nbsp;<a class=\"reference-link\" href=\"#root/_help_CssoWBu8I7jF\">Collection Properties</a>, by clicking on the settings (<span class=\"tn-icon bx bx-cog\"></span>) button. Alternatively, each of these options also have a corresponding <a href=\"#root/_help_HI6GBBIduIgv\">label</a> that can be set manually.</p><ul><li>Scale, which illustrates the scale of the map in either kilometers or miles in the bottom-left of the map.<ul><li>The unit is determined by the <em>Formatting locale</em> option in <em>Language &amp; Region</em>.</li></ul></li><li>The name of the markers is displayed by default underneath the pin on the map. Since v0.102.0, it is possible to hide these labels which increases the performance and decreases clutter when there are many markers on the map.</li><li>v0.105.0 also introduces a feature called <em>Group nearby markers</em> which will cluster multiple markers together at low zoom.<ul><li>The clusters display the number of items they contain. The color also changes based on the count.</li><li>Clicking on a cluster will automatically zoom in so that the individual markers that make up the cluster are now visible.</li></ul></li></ul><p>The same options are also listed under <em>General</em> in the <span class=\"tn-icon bx bx-cog\"></span><em>Geo map properties</em> dialog, opened from the&nbsp;<a class=\"reference-link\" href=\"#root/_help_8YBEPzcpUgxw\">Note menu</a> or from the settings menu of the&nbsp;<a class=\"reference-link\" href=\"#root/_help_CssoWBu8I7jF\">Collection Properties</a>. Its <em>Included notes</em> section sets whether archived notes are shown and the <em>Maximum nesting depth</em> (see below), and its <em>Background</em> section holds the map style, the URL of a custom tile set when <em>Type</em> is set to <em>Custom tileset</em> (see above), or, with <em>Type</em> set to <em>Custom image</em>, draws the map over an image of your own instead, as described in&nbsp;<a class=\"reference-link\" href=\"#root/_help_ZRDXGc0nAIh4\">Image maps</a>.</p><p>The map shows the notes of its whole subtree, not only its children. <em>Maximum nesting depth</em> (<code>#maxNestingDepth</code>) limits how deep below the map it looks: <code>0</code> shows only the children, <code>1</code> adds their children, and so on. Without a value, every level is shown.</p>",
"_help_C2H9HK4BzwG7": "<p>The following shapes can be drawn on the map: a path, an area, a rectangle or a circle.</p><p>Unlike markers, the title of the shape is not displayed directly on the map but it will be displayed when hovered.</p><p>The shape will also be drawn in the <a href=\"#root/_help_p9kXRFAkwN4o\">color of the note</a>, if set.&nbsp;</p><h2>Drawing a shape on the map</h2><p>To draw a shape, use the toolbar that appears in the top-center area on desktop and on the left-center on mobile and in split view.</p><p>Once a shape is drawn, it cannot be moved or modified. To do so, simply remove the shape and draw another one instead.</p><h3>Drawing a path or an area</h3><ol><li>Press the <em>Draw a path on the map</em> (<span class=\"tn-icon bx bx-vector\"></span>) or <em>Draw an area on the map</em> (<span class=\"tn-icon bx bx-shape-polygon\"></span>) button. The button stays held down while the tool is armed, and a notification describes what to do.</li><li>Click on the map once for each point. The shape is previewed as it grows.</li><li>Finish it by pressing <kbd>Enter</kbd>. A path can also be finished by clicking its last point again, and an area by clicking the corner it started from. A path needs at least two points and an area at least three.</li></ol><h3>Drawing a rectangle or a circle</h3><ol><li>Press the <em>Draw a rectangle on the map</em> (<span class=\"tn-icon bx bx-shape-square\"></span>) or <em>Draw a circle on the map</em> (<span class=\"tn-icon bx bx-shape-circle\"></span>) button.</li><li>Click once to set the first corner, or the center of the circle. Click a second time at the opposite corner, or at the distance the circle should reach.</li><li>Instead of two clicks you can drag from one to the other. This also works on mobile and other touch-based apps.</li></ol><h3>Finishing and cancelling</h3><p>To give up on a shape while drawing it, press <kbd>Escape</kbd> or press the tool's button again. Whatever has been drawn so far is discarded.</p><p>The tool is deactivated once a shape is finished, so drawing a second shape requires another button press.</p><h2>Interaction</h2><p>Once a shape is created:</p><ul><li>Clicking a shape opens the standard panel which allows changing the title, the content and with buttons to open the note or remove it.<ul><li>When clicking, a marker takes priority over the shape.</li></ul></li><li>Right-clicking a shape opens a contextual menu similar to the one for markers, which allows opening the corresponding note or removing the shape.</li><li>Typing in the map's search bar finds shapes by their title, as it does markers. Selecting one brings the whole shape into view.</li></ul><h2>How shapes are represented</h2><p>Shapes are represented quite similarly to markers, which means each shape is a note. The information about the same is stored using a <a href=\"#root/_help_HI6GBBIduIgv\">label</a> called <code>geoShape</code>.</p>",
"_help_ZRDXGc0nAIh4": "<p>An image map is a geo map drawn over an image of your own instead of a world map, such as a floor plan, a fantasy map for a tabletop game, or a diagram to annotate. Markers and shapes work as they do on a geo map, but their positions are measured on the image instead of in latitude and longitude: in the image's own pixels, or in a coordinate system of your choosing, such as the one a video game uses.</p><h2>Creating an image map</h2><ol><li>Upload the image as a note of its own, for example by dragging the file into the note tree. PNG, JPEG, WebP and GIF images are supported; SVG images are not.</li><li>Create a geo map, or open an existing one.</li><li>Open the <span class=\"tn-icon bx bx-cog\"></span><em>Geo map properties</em> dialog from the&nbsp;<a class=\"reference-link\" href=\"#root/_help_8YBEPzcpUgxw\">Note menu</a> or from the settings menu of the&nbsp;<a class=\"reference-link\" href=\"#root/_help_CssoWBu8I7jF\">Collection Properties</a>.</li><li>Under <em>Background</em>, set <em>Type</em> to <em>Custom image</em>, then choose the image note in <em>Image note</em>. The list only offers image notes in a format the map can draw (PNG, JPEG, WebP or GIF), and shows all of them before anything is typed.</li></ol><p>The map then shows the image instead of the world map and opens with the whole image in view. To go back to a world map, set <em>Type</em> back to <em>Vector &amp; Raster</em>. The image is switched off rather than removed: its relation is renamed to <code>~disabled:map:image</code>, so setting <em>Type</em> to <em>Custom image</em> again brings back the same image, with its coordinates. An image that the geo map inherits from a parent note or a template can only be switched off on the note that holds it.</p><p>The image note is stored in a <code>~map:image</code> <a href=\"#root/_help_Cq5X6iKQop6R\">relation</a> of the geo map, which can also be added by hand.</p><h2>Image size</h2><p>Images are resized when they are uploaded, so by default the image of a map is at most 2000 pixels on its longer side, which can be too coarse for a detailed map. To keep an image at a higher resolution, do one of the following before uploading it:</p><ul><li>In <a class=\"reference-link\" href=\"#root/_help_4TIF1oA4VQRO\">Options</a> → <em>Media</em>, raise <em>Max image dimensions</em> or turn off <em>Automatically compress images</em>.</li><li>Upload it through the <em>Import</em> dialog with <em>Compress images</em> unchecked.</li></ul><p>An image that was already uploaded keeps its size; upload it again after changing the settings.</p><p>The image is drawn as a single picture by the graphics card, which limits how large it can be. Images up to 4096 pixels on their longer side are safe on practically every device, and most computers handle up to 16384 pixels. On a device whose graphics card cannot hold the image, the markers and shapes still appear but the image itself does not. The <em>Geo map properties</em> dialog warns about an image larger than 4096 pixels, and about one that can't be used at all, such as an SVG image.</p><h2>Interaction</h2><p>Adding, moving and removing markers, drawing shapes, the popup view and the contextual menu work as described for the&nbsp;<a class=\"reference-link\" href=\"#root/_help_81SGnPGMk7Xc\">Geo Map</a>. The camera stays over the image and can zoom in up to four times past the image's own resolution.</p><p>The features that only make sense on a real map are not available on an image map:</p><ul><li>Searching the map and searching for places online.</li><li>Going to your location.</li><li>Adding GPS tracks.</li><li>Clicking the places the base map shows.</li><li>The 3D buildings.</li><li>Opening a location in an external map application.</li></ul><p>The look of the marker titles follows the image: if the image is dark, turn on <em>Dark image</em> under <em>Background</em> in the <em>Geo map properties</em> dialog, so that the titles are drawn in a light color. This sets the <code>#map:darkStyle</code> label.</p><p>The <em>Map style</em> setting doesn't apply to an image map, so it's hidden from the settings menu of the collection while the map has an image.</p><h2>Choosing the coordinate system</h2><p>By default, positions are measured in pixels of the image at its original size, from its top-left corner, with <code>x</code> growing to the right and <code>y</code> growing downwards.</p><p>To use coordinates of your own instead, open the <em>Geo map properties</em> dialog, set <em>Coordinates</em> under <em>Background</em> to <em>Custom</em>, and enter the coordinates of the image's <em>Top-left corner</em> and <em>Bottom-right corner</em>. Switching to <em>Custom</em> starts from the image's size in pixels, so the markers stay where they are until the corners are changed; for that reason, <em>Custom</em> can only be chosen once the image has loaded. All positions are then read and written in those coordinates, including the ones shown in the contextual menu and in the popup view. To go back to pixels, set <em>Coordinates</em> to <em>Image pixels</em>. Corners that the geo map inherits from a parent note or a template can only be removed on the note that holds them; entering other corners on this map overrides them.</p><p>The corners are stored in the <code>#map:imageBounds</code> label of the geo map as <code>x,y x,y</code>, with a space between the two corners, which can also be set by hand. For example:</p><ul><li>A screenshot of a game map that covers <code>x</code> from -512 to 512 and <code>y</code> from -512 to 512, with <code>y</code> growing downwards: <code>#map:imageBounds=-512,-512 512,512</code>. Coordinates copied from the game can then be pasted directly into <code>#mapPosition</code>.</li><li>A world whose <code>y</code> grows upwards, with the origin in the middle of the image: <code>#map:imageBounds=-2000,1000 2000,-1000</code>. A top-left <code>y</code> larger than the bottom-right one is what flips the axis.</li><li>A floor plan measured in meters: <code>#map:imageBounds=0,0 24,12</code>.</li></ul><p>The two axes don't have to use the same scale. A circle is always measured in the map's own units, so it appears as an ellipse when the units are stretched differently along the two axes.</p><p>Corners that share an <code>x</code> or a <code>y</code> don't span an area: the dialog doesn't save them, and a label holding them, or a value that cannot be read, is ignored and the pixels of the image are used instead.</p><h2>Coordinate rulers</h2><p>Enabling <em>Show scale</em> in the collection properties draws rulers along the edges of the image instead of a distance scale. Round values of the map's coordinates are marked with ticks along all four edges, labeled along the top and left ones, with faint grid lines across the image. The spacing follows the zoom level, and the values follow <code>#map:imageBounds</code> when it is set.</p><p>The rulers are drawn on the image itself, so they move out of view along with its edges when zooming in. The grid lines remain visible across the image.</p><h2>How the positions are stored</h2><p>Because positions are stored in different labels from the ones of a geo map, the same note can be placed both on a geo map and on an image map.</p><figure class=\"table\"><table><thead><tr><th>Label</th><th>Content</th></tr></thead><tbody><tr><td><code>#mapPosition</code></td><td>The position of a marker, as <code>x,y</code>, for example <code>#mapPosition=320,145</code>.</td></tr><tr><td><code>#mapShape</code></td><td>A shape, in the same format as <code>#geoShape</code> (see&nbsp;<a class=\"reference-link\" href=\"#root/_help_C2H9HK4BzwG7\">Drawing shapes</a>) but with <code>x,y</code> pairs, and a circle's radius in the map's units, for example <code>#mapShape=circle:400,300 50</code>.</td></tr></tbody></table></figure><p>The positions belong to the coordinate system, not to the image. When replacing the image with a different one, for example a higher-resolution copy, keep <code>#map:imageBounds</code> describing the area the new image covers and every marker stays in place. With <em>Image pixels</em>, the positions are pixels, so an image of a different size moves the markers relative to what the image shows; to avoid that, switch <em>Coordinates</em> to <em>Custom</em> before replacing the image, which keeps the size of the old one (<code>0,0 &lt;width&gt;,&lt;height&gt;</code>) as the corners.</p><aside class=\"admonition tip\"><p>To draw freely over an image instead of placing notes on it, consider a&nbsp;<a class=\"reference-link\" href=\"#root/_help_grjYqerjn243\">Canvas</a>.</p></aside>",
diff --git a/docs/User Guide/User Guide/Collections/Kanban Board.md b/docs/User Guide/User Guide/Collections/Kanban Board.md
index 710303f8a9..9559b65abf 100644
--- a/docs/User Guide/User Guide/Collections/Kanban Board.md
+++ b/docs/User Guide/User Guide/Collections/Kanban Board.md
@@ -340,7 +340,7 @@ Here is an example of the attributes you can define for a typical Kanban board u
To set the value of a custom attribute, click or tap the card, and then enter or select the desired value in the dialog header.
-For attributes of the “select” or “checkbox” type, you can quickly change the value by using the card's context menu under the _Attributes_ section.
+For attributes of the “select”, “checkbox” or “date” type, you can quickly change the value by using the card's context menu under the _Attributes_ section. A date attribute's submenu offers _Today_, _Tomorrow_ and _Next week_ (the first day of next week, as set in the first day of the week option), and _Not set_ to clear the value; any other date is entered in the dialog header.
#### Reordering, hiding, redefining, and deleting custom attributes