Tag Groups

Tag groups segment your tags into parent categories — place, scene, shot, person, anything you like. Each group has a colour, an optional description, and a required flag that surfaces clips missing a tag from the group.

Tags inside a group are still ordinary tags. Think of the group as the "type" and the tag as the "value": place:backyard, scene:interview, shot:wide — the part before the colon is the group, the part after is the tag.

Why Groups

• Consistent organisation — keep place, scene, shot separate instead of throwing every tag into one flat list.
• Visual structure — every tag in a group inherits the group's colour, so your library reads at a glance.
• Coverage warnings — mark a group as required, and any clip missing a tag from it shows an amber alert with a tooltip listing exactly which groups are missing.
• Better routing — the DaVinci Resolve send dialog can split clips into sub-bins using a group as the routing key.

The Groups Tab

Open Tags from the bottom bar, then switch to the Groups tab. The tab lists every group with its colour dot, name, optional description, tag count, and a Required badge if applicable.

Creating a Group

Click New Group and fill in:

Field	Notes
Name	Case-insensitive, unique. Lowercase + short is conventional (place, not Place / Location).
Color	One of the 8 preset colours: blue, green, yellow, red, purple, pink, orange, teal.
Description	Optional. Shown next to the group name in the management list.
Required	When checked, clips without any tag from this group show the missing-required indicator.

Editing a Group

Click the pencil icon next to any group to rename, recolour, edit the description, or toggle the required flag. Changes apply immediately — every tag inside the group re-renders with the new colour.

Deleting a Group

Click the trash icon. The confirmation dialog gives you two modes:

• Orphan tags (recommended) — keep the tags and their clip associations; they become free-form (no group, but still usable).
• Delete tags too — permanently delete every tag inside the group, removing them from all clips.

If you only want to retire the group label but keep your existing taxonomy intact, orphan is what you want.

The prefix:value Shortcut

You don't need to visit the Groups tab to create a group. In any tag input — the media detail modal, the batch tag bar, the import page — type group:tag and Clipthesis will:

1. Create the group group if it doesn't exist (default blue colour, not required).
2. Create the tag tag underneath it.

Examples:

Type this	You get
place:backyard	Group place (created if missing) + tag backyard inside it
scene:interview	Group scene + tag interview
shot:wide	Group shot + tag wide

If the group already exists, the new tag just joins it. You can refine the group later (colour, required flag, description) from the Groups tab.

Required Groups & the Missing-Required Indicator

When at least one group has the Required flag set, every clip in your library is checked: does it carry at least one tag from each required group? If not, the clip is flagged.

• On the card — an amber alert triangle appears next to the tags icon in the top-right corner.
• Tooltip — hover the triangle to see exactly which groups are missing: Missing required: place, scene.
• Filter — the filter sidebar shows a Missing required tags toggle (only when required groups exist). Enable it to narrow the grid down to clips that need attention.
• Live updates — after a batch tag add or remove, the indicator and tooltip refresh optimistically without a full reload.

Required groups are how you turn Clipthesis into an opinionated organiser. A common setup: mark place, scene, and shot as required, then sweep the Missing required tags filter until it's empty.

Where Groups Show Up

Filter Sidebar

The Tags filter section segments tags by group. Each group has its own collapsible header with a colour dot, the group name, a * marker if required, and the per-group tag count. The mini search input scopes to the expanded sections.

Ungrouped tags collect at the bottom.

Tag Autocomplete

When you start typing in a tag input, the suggestion popover groups results by tag group. Each group's suggestions sit under a coloured header, sorted alphabetically. Free-form (ungrouped) suggestions appear last.

Import Page

The Available Tags panel on the import page mirrors the filter sidebar — collapsible per-group sections with a chevron, colour dot, name, required marker, and tag count. Sections start collapsed so the panel stays scannable; expand the groups you want to tag from. See Importing.

Colour Resolution

When more than one colour could apply to a tag, the priority is:

1. Group colour — if the tag belongs to a group, the group's colour wins.
2. Per-tag colour — only used for ungrouped tags.
3. Default theme colour — fallback.

This means moving a tag into a group will override its own colour. If you want a specific tag to stay a unique colour, keep it ungrouped.

Send to DaVinci Resolve

The DaVinci Resolve send dialog uses tag groups for sub-bin routing. Pick a group as the routing key and Clipthesis splits clips into sub-bins named after the tag value in that group, with an _unsorted bin for clips that have no tag from the selected group.