Omniscio

Tag a session (coloured labels)

Session tags are short coloured labels you attach to a session for quick categorisation — things like urgent, bug or client-acme. There is one kind of tag: every tag has a colour and can be renamed, limited to certain projects, shown as a sidebar group, or deleted. This page covers putting tags on a session with the picker and the chips on the session header.

On this page

What it is

Session tags are short coloured labels you attach to a session — things like urgent, bug, client-acme, or followup. There is only one kind of tag. Every tag has a name and a colour, and can be renamed, recoloured, limited to certain projects, shown as a group in the sidebar, or deleted. Tags are managed in one place, the Tags view; the model behind them is on the tag manager page.

A tag you create without picking a colour gets one automatically, worked out from its name, so it is never plain grey. Existing tags keep the colour they already had. A session can carry up to 10 tags, and a tag name can be up to 30 characters.

If you used Omniscio before tags became one kind, nothing was lost. Shortly after the app starts, any older typed-in tags are upgraded automatically: they become full tags on the same sessions, and two tags that differ only in capital letters or accents merge into one. This check runs on every launch, so restoring an old backup never loses tags. Hidden internal markers that the app keeps beside your tags (for example the plugin marker) are left alone and never show up as tags.

The feature is gated by a setting: Settings → Sessions → Session Tags. When the toggle is off, the Tags entry is hidden from the overflow menu and the chip strip disappears from the session header — tags already on a session are kept and reappear when you switch it back on.

Where to find it

Press T with a session selected and the composer not focused, and a centred tag picker opens — or use Tags… in the session's ⋯ overflow menu, which opens the same picker. The session's tags show as coloured chips in the strip under the title of an open session. On a phone the strip collapses to the first tag plus a +N chip; tap it to show them all.

How it behaves

  1. Add a tag. Type a name. The list shows the tags available in this session's project (tags limited to other projects are hidden), most-used first when the box is empty. Pick one with the mouse or arrow keys and press Enter. If your text matches an existing tag's name, Enter applies that tag — matching ignores capital letters and accents, so Bug finds bug. If it matches nothing, a Create row appears; Enter (or clicking Create) makes a new, coloured tag available in every project and applies it to the session.
  2. Browse all tags. Click Browse all (N)… at the bottom of the list for a checkbox list of every tag with its session count. Type in the search box to filter; tick a box to add the tag, untick to remove it.
  3. Manage tags. Manage tags → at the bottom of the picker opens the Tags view, where you rename, recolour, limit or delete tags.
  4. Remove a tag. Click the × on a chip, or press Backspace with the input empty to remove the last tag. Removing works the same from the header chip, the picker and the Tags view: a Removed "name" message appears with Undo (Ctrl+Z also undoes it). The message only appears once the removal has actually succeeded.
  5. Limits. Trying to add an 11th tag does nothing; the Create row is disabled with the tooltip "Maximum 10 tags". Hidden internal markers do not count toward the 10.

Tags appear in colour on the session header only — sidebar session rows do not show tag chips. To see sessions grouped by a tag in the sidebar, switch on that tag's sidebar group option. The behaviour of the header strip is locked by session-tag-strip-contract.md, and the whole one-kind rule by session-tags-contract.md.

Other places that use tags: the search window's Tag filter lists every tag (coloured, with counts) and finds sessions carrying any tag you select; the Settings → Tags page is a short card with an Open Tags button.

  • tag-manager.md — the tag model: tables, project scope, sticky scope, cap, deletion, sidebar groups
  • tags-view.md — the Tags view, the one place tags are managed
  • snooze-a-session.md — another overflow-menu action for organising the session list
  • bulk-select-sidebar.md — Shift+J/K multi-select for batch operations on tagged sessions

Last verified 2026-10-10