A tour of the main window and the day-to-day tagging workflow. See Quick Start first if you haven't created a project yet.
- Image grid — thumbnail, name, tags, and info columns for every image in the project (or the current filter/folder — see below).
- Folders list — a quick filter listing each import folder and how many images it holds. Toggle it from View ▸ Show folders list.
- Preview pane — shows the selected image. View ▸ External image window pops it out into its own resizable window, which is also where you draw and edit bounding-area tags.
- Tag editor — the tag list for whichever image(s) are currently selected, with columns for name, weight, category, and layer.
- Pending-changes bar — tag edits are staged, not applied instantly; use Apply or Revert (or the shortcuts below) to commit or discard them.
- Tag overview — a project-wide list of every tag in use, with its layer and how many images use it. Has its own filter box.
- Layers list — the project's tag layers, in stack order.
- Status bar — background progress, and a script status/selector for the Scripting feature.
- File — New Project, Import Project Template, Open Project, Save All, Recent, Import File, Import Folder, Export, Exit.
- View — External image window, Image preview on mouse over, Show tag category, Show tag weights, Raw tag view, Show autocomplete suggestions, Highlight selected tags, Show folders list, Show check column, Tag Database, Tag Wildcards.
- Scripting — see Script Usage.
- Tools — Settings, Associate *.SharpTag files.
Type into the filter box above the image grid to narrow the grid down. It accepts a plain substring, */? wildcards, or you can drive it from elsewhere in the UI — clicking a folder in the folders list or a tag in the tag overview sets the filter to Folder: <name> or Tag: <name> for you (multiple tags combine as AND/OR depending on how you select them). The box flashes briefly whenever a filter gets applied this way, so it's obvious the grid is currently restricted.
Select one image to edit its tags in the tag editor; select several to see and edit the tags common across all of them at once. Add a tag with Insert or by typing into the editor's autocomplete box — suggestions are drawn from tags already used in the project, your wildcard lists, and the built-in tag database, filtered according to the active layer's Autocomplete mode. Typing # opens a color picker for inline color-code tags, if enabled.
Useful tag-editor shortcuts:
| Key | Action |
|---|---|
Insert |
Add a new tag |
Enter |
Edit the selected tag |
Delete |
Delete the selected tag |
Escape |
Revert pending changes |
Ctrl+C / Ctrl+X / Ctrl+V |
Copy / cut / paste tags (weight and bounding area included) |
Ctrl+= / Ctrl+- |
Increase / decrease the selected tag's weight |
Right-clicking a grid (image items, folders, tag editor, or tag overview) shows a context menu of the same actions available via shortcuts, plus a few overview-only extras like Find/Replace... and per-row filtering.
A tag can be tied to a region of the image instead of (or in addition to) applying to the whole thing — either a simple rectangle or one-or-more polygons — for object-detection-style datasets. Draw and edit these in the image preview window (View ▸ External image window): draw a new shape and it becomes a bounding area on whichever tag you assign it to, or drag an existing area's handles to reshape it. See Export and Augment Layers for how bounding areas feed into cropping, masking, and grounding-style export formats.
Select multiple rows in the image grid to batch-edit their common tags. Ctrl+C/Ctrl+V on the grid copies and pastes an image's entire tag set onto others, weights and bounding areas included — pasted text also round-trips with plain text elsewhere (each tag on its own line, without weight/area), so you can copy tags out to/from a text editor too. PageUp/PageDown step through images one at a time when a single image is selected. Delete removes the selected image(s) from the project — by default these move into a .delete subfolder rather than being deleted outright (configurable in Tools ▸ Settings).
Turn on View ▸ Show check column to add a checkbox column to the image grid, for marking a working subset of images independently of the selection. Click a checkbox to mark just that image, press Space to toggle the mark on the current selection, or right-click ▸ Check/Uncheck Selected. Checked rows get a highlight color so they're easy to spot even after the selection changes. The Folders list has its own Shown checkbox per folder (click to toggle, or right-click ▸ Check All / Uncheck All) — unrelated to image marking, it controls which folders' images appear in the grid at all.
Right-click in the Tag overview and choose Find/Replace... to bulk-rename tags by substring. With more than one tag selected it operates on just that selection; otherwise it operates on every tag currently listed (respecting the overview's own filter box). Type into the Find/Replace boxes to see a live preview of every affected tag and its new name before applying.
Every grid in the main window supports drag and drop, both with each other and with the rest of Windows:
- Import by dragging in — drop image files, or a whole folder, from File Explorer onto the image grid to import them (same as Import).
- Drag an image out — drag a row out of the image grid onto File Explorer or another application to hand off the actual image file; if the row you drag is part of a larger selection, every selected image goes along with it.
- Apply a tag to an image — drag a tag row from the tag editor or the tag overview onto an image in the grid.
- Add an existing tag to the current image(s) — drag a tag row from the tag overview into the tag editor; it's inserted right where you drop it.
- Add tags by dragging in plain text — drag text from another program (a browser, a text editor, etc.) onto the tag editor and it's added the same way pasting text is: one tag per line.
- Reorder tags — drag rows within the tag editor to reposition them. Dropping one onto another layer's grouped block moves it onto that layer too (only works between layers that share the same Grouping setting). Tags on a locked layer, and a few structural placeholder rows, can't be dragged at all.
- Move a tag to a different layer — drag a row out of the layers list and drop it onto a tag in the tag editor or the tag overview to reassign that tag to it. Select several tags in the tag overview first to bulk re-file all of them into that layer at once, project-wide.
- Reorder layers — drag rows within the layers list to change their stack order, which feeds into layer grouping/sorting and export order.
Add, remove (Delete), and open properties (Enter) for the project's tag layers here — see Tag Layers and Augment Layers for what each layer type and property does, and Drag and drop above for reordering them. Double-clicking a layer filters the tag overview down to just that layer's tags — handy for reviewing one layer's contents in isolation.
Your layer setup isn't locked in once tags exist — everything can be reshuffled later:
- Move a tag to a different layer, on one image — in the tag editor, edit the tag (
Enter) and change the layer field in the dialog, or drop a layer from the layers list onto the tag's row. Only the selected image is affected. Typing a layer name that doesn't exist yet creates it. - Move a tag to a different layer, everywhere — drop a layer from the layers list onto the tag in the tag overview: every instance of that tag, across all images, moves to the new layer. Select multiple tags in the overview first to re-file them all at once.
- Merge two layers — rename one layer (in its properties) to the other's exact name; their tags are combined into a single layer.
- Split a layer — filter the tag overview to the layer, select the tags you want to break out, and drag a new empty layer onto the selection.
- Delete a layer — removes the layer and its tags from every image. If you want to keep the tags, move them to another layer first.