Trigger Title & Description

Give every trigger a short Title and a longer, multi-line Description — so the list reads like “keyword → title” instead of borrowing the first line of a note.

What Title and Description are for

  • Title — a single-line label. This is what shows in the triggers table and in the Quick Overlay. Keep it short: “Meeting sign-off”, “Support greeting”, “Invoice footer”.
  • Description — free-form, multi-line notes about the trigger: what it does, when to use it, any caveats. It never fires or gets pasted; it’s purely for you.

The two are separate fields, so you can write a paragraph of notes and still keep a tidy one-line label in the table.

How to set them

In the editor: open a trigger (double-click it, or press Enter / Ctrl+E). Above the Description you’ll find a single-line Title field. Type the label there; use the Description box below for longer notes — press Enter for new lines.

In the table: double-click the Title cell to edit it in place. Or select a trigger and press F2 to cycle through the editable cells: keyword first, then title.

Automatic migration from older triggers

When you update from a version without titles, your existing triggers are migrated automatically:

  • The first line of each description becomes the Title.
  • Everything after the first line stays as the Description.

Nothing is lost, and triggers that only ever had a one-line description end up with a clean title and an empty description.

Where the title shows up

  • Triggers table — the Title column is shown by default; the Description column is hidden by default (enable it in the column chooser if you want it back).
  • Quick Overlay — each trigger row shows its title. Press F3 on a trigger row to open a readable preview card with the title, the full description, the steps and any form fields.
  • Trigger forms — if a form-trigger has no description, the form’s info banner falls back to showing the title, so the window is never blank.

Origin — where a trigger came from

Alongside the title, every trigger records an Origin:

Origin Meaning
Mine You wrote it yourself
Imported It came in from a YAML file, a pack, or a URL
Samples One of the built-in samples (“Load Sample Triggers”)

The triggers sidebar has an Origin section (Mine / Imported / Samples) so you can jump straight to a group. Your choice is remembered across restarts. Editing an imported or sample trigger makes it Mine — because once you’ve changed it, it’s yours.

See Filter & Column Chooser for the Origin sidebar filter and the optional Origin column.

Edge cases & known limits

  • Sharing a trigger as YAML carries its title. Importing an older YAML file without a title derives one from the first description line, so nothing shows up blank.
  • The Description column is hidden by default. Show it via the column chooser (right-click the table header).
  • Editing a trigger’s definition (keyword, title, description, steps, tags) flips its Origin to Mine. Just using a trigger, or moving it to Trash and back, does not.

See also