Annotate images

The editor is where you annotate the images of an image dataset. You draw bounding boxes and polygons by hand, or let Magic Select outline an object from a single click.

Open the editor

On the dataset page, select Annotate > Editor, or select any image in the asset grid. The editor opens on that image and keeps the dataset filters, so you move only through the images that match them.

You need at least one label to annotate. See Labels.

Editor layout

Area	What you find there
Top bar	Back to dataset, the review status buttons, Previous asset and Next asset with the position (for example 3 of 120), Download image, and Remove from dataset.
Toolbar (left)	The drawing and AI tools, plus Undo and Redo.
Right panel	The Annotations and Labels tabs, and an Assets section with thumbnails and a Filter button.
Bottom bar	Zoom out, the zoom level (select it to fit the image), Zoom in, Fit to viewport, Settings, and Keyboard Shortcuts.

Settings lets you change the Theme, the Language, the Background Darkness around the image, and Always Show Labels, which keeps label names visible on every shape instead of only on the selected one.

Tools

Tool	Key	What it does
Drag Tool	D	Pan the image, and select, move, and reshape annotations.
Bounding Box	B	Draw a rectangle.
Polygon	G	Draw an outline point by point.
Add Area		Extend the selected polygon with a new shape.
Subtract Area		Cut a shape out of the selected polygon.
Intersect Area		Keep only the overlap between a new shape and the selected polygon.
Magic Select	S	Click an object to create a polygon around it. Uses credits.
Magic Annotate	A	Find every instance of one or more labels. See Automatic annotation.

The area tools are available when a polygon is selected. For every shortcut, see Keyboard shortcuts.

Draw a bounding box

1. Select Bounding Box (or press B).
2. Drag from one corner of the object to the opposite corner, then release. Very small boxes are ignored, so an accidental click does not create one.
3. In the label picker, select a label. You can type to search. Press Enter before typing to pick the first label in the list: the label you used last always comes first.

Draw a polygon

1. Select Polygon (or press G).
2. Click to place each point around the object. Press Backspace to remove the last point, or Escape to start over.
3. After at least three points, click the first point again to close the outline.
4. Select a label in the label picker.

Shapes always stay inside the image: points placed outside snap to the nearest edge.

Annotate with Magic Select

Magic Select turns one click into a polygon that follows the object’s outline.

1. Select Magic Select (or press S).
2. Click a point inside the object.
3. In the label picker, adjust the Confidence threshold if needed and check the credit cost shown below it.
4. Select a label. The prediction starts, and the polygon appears when it is ready.

If nothing is found, you see No object found at the clicked point. Each Magic Select prediction uses credits, including one that finds nothing. The editor shows the exact cost next to the tool. See Credit usage.

The Confidence threshold goes from 0.05 to 0.95 (default 0.5). A higher value keeps only the results the model is more sure about. The value stays the same as you move between images.

Edit annotations

Select an annotation with the Drag Tool, or select it in the Annotations tab. Then:

• Move it: drag the shape.
• Resize a box: drag its handles.
• Reshape a polygon: drag a point. Click the middle of an edge to add a point there. To remove a point, right-click it and select Delete point, or select it and press Delete. A polygon keeps at least three points.
• Add, subtract, or intersect an area: with a polygon selected, choose an area tool and draw a closed shape across the polygon’s edge. The result must be a single, joined and filled shape. If it is not, you see Shape not supported: adjust your drawing and try again.
• Change the label: double-click the shape with the Drag Tool, or select the pencil button next to it in the Annotations tab.
• Delete it: press Delete or Backspace, or select the trash button in the Annotations tab.

Annotations created by Magic Select or Magic Annotate show their confidence score next to the label name. You cannot drag or resize them, but you can change their label, delete them, or reshape a polygon with the area tools.

Saving and undo

Annotations save automatically as you work: there is no save button. If a change cannot be saved, you see an error such as Could not save the annotation. Use Undo and Redo in the toolbar, or

Ctrl/⌘ + Z and Ctrl/⌘ + Y, to step through your annotation changes.

Move between images

Use Previous asset and Next asset, the ← and → keys, or select a thumbnail in the Assets section. To change which images you move through, select Filter in the Assets section.

When you finish an image, set its review status in the top bar. See Review assets.

Note

With view-only access, the editor opens without the toolbar: you can zoom, pan, move between images, and inspect annotations, but not change them.

Next steps

• Keyboard shortcuts
• Automatic annotation
• Review assets