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
F3on 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
- Filter & Column Chooser — the Origin sidebar filter and the Title / Expands To / Origin / Modified columns
- Load Sample Triggers — the built-in samples that land under Samples
- YAML Import — importing packs (they land under Imported) and how titles travel in YAML