Annotation
Create instance
Annotation tools
The Image Editor has 7 annotation tools: Point, Polyline, Polygon, Bounding Box, Rotated Box, Ellipse, and Cuboid.
- To move around an image while annotating, you can click and hold the scroll wheel and move the mouse, or you can use the W, A, S, and D keys on the keyboard. Press W and S to go up and down, and press A and D to go left and right.
- Use the ruler in the left panel to measure the size of your objects and instances.
Point
To annotate with the Point tool:
- In the left panel, select the Point tool or press P on the keyboard.
- Click on the object you want to annotate.
Polyline
To annotate with the Polyline tool:
- In the left panel, select the Polyline tool or press L on the keyboard.
- Click where you want to start outlining the object. If you want to annotate an irregular shape, you need to create multiple lines that are connected to each other. In this case, you can click to start a new line that goes in a different direction.
- Finish the annotation by clicking twice where you want it to end.
Polygon
To annotate with the Polygon tool:
- In the left panel, select the Polygon tool or press Z on the keyboard.
- Click where you want to start outlining the object.
- Outline the object using clicks.
- Finish the annotation by clicking the starting point.
Create a polygon with an existing point
You can create a polygon using a point from an existing polygon as a starting point:
- In the left panel, select the Polygon tool or press Z on the keyboard.
- Hover over an existing polygon and click on a starting point.
- Draw the polygon.
- Finish the annotation by clicking the starting point.
Create a polygon with a common side with another polygon
To create a polygon that has a common side with an existing polygon:
- In the left panel, select the Polygon tool or press Z on the keyboard.
- Enable Clip mode.
- Hover over an existing polygon and click the two points that make up the side you want to connect to your new polygon.
- Draw the polygon.
- Finish the annotation by clicking the starting point.
Subtract polygon
You can remove part of a Polygon.
To remove part of a Polygon:
- Right-click on an existing Polygon. We’ll call this the parent polygon.
- Click Subtract polygon or press Shift+S on the keyboard.
- Draw a Polygon over the area you want to remove. Let’s call the removed area the child polygon. The intersection of the parent polygon and child polygon will be removed.
Magic Polygon
With the Magic Polygon, you can draw a line or scribble on an object to get a Polygon annotation. This helps automate and speed up the annotation process.

Magic Polygon
To annotate with the Magic Polygon tool:
- Select the Magic Polygon tool or press M on your keyboard.
- Scribble or draw a line on an object.
- Double-click or press Enter on your keyboard.
- A Polygon annotation will be created.
You can edit the Magic Polygon if needed.
Bounding Box
To annotate with the Bounding Box tool:
- In the left panel, select the Bounding Box tool or press X on the keyboard.
- Click on the image and drag the cursor to draw a Bounding Box.
- Let go of the click.
Rotated Box
To annotate with the Rotated Box tool:
- In the left panel, select the Rotated Box tool or press Ctrl+X on the keyboard.
- Draw a line (click to start the line and click to end the line).
- Move the cursor to draw a box.
- Rotate the box (optional).
Ellipse
To annotate with the Ellipse tool:
- In the left panel, select the Ellipse tool or press E on the keyboard.
- Click on the image and drag the cursor to draw an Ellipse.
- Let go of the click.
Cuboid
To annotate with the Cuboid tool:
- In the left panel, select the Cuboid tool or press Q on the keyboard.
- Click on the image and drag the cursor to draw a square.
- Click when you're satisfied with the size of the square.
- Drag the cursor forward, backward, or sideways to draw the cuboid.
Point label
You can add point labels to all the instances in the Image Editor.
To do add a point label:
- Select an instance.
- Right-click on a point.
- Type a point label name.
- Click the check button.
When you add a label to a point, it turns red.
To delete a point label:
- Select an instance.
- Right-click on a point.
- Click the X button.
To add a point label on a Keypoint:
- Select the Keypoint.
- While holding the Shift key on the keyboard, right-click on the Keypoint.
- Type a point label name.
- Click the check button.
To delete a point label on a Keypoint:
- Select the Keypoint.
- While holding the Shift key on the keyboard, right-click on the Keypoint.
- Click the X button.
Layer instances
You can layer instances in the Image Editor.
To send an instance to the top:
- Right-click on the instance.
- Select the up arrow or press Shift+] on the keyboard.
To send an instance to the bottom:
- Right-click on the instance.
- Select the down arrow or press Shift+[ on the keyboard.
Copy instance
To copy and paste an instance:
- Select the instance you want to copy.
- Press Ctrl+C+V to copy the instance once. Press Ctrl+C+V+V to copy the instance twice, and so on.
Group instances
In some cases, you might need to use more than one tool to annotate a single object. To indicate that several instances form one object, you need to group them.

To group instances:
Method 1:
- Select an instance.
- Press and hold the Ctrl key on the keyboard.
- While holding the Ctrl key, click on the instances you want to include in the group.
- Click Group in the top panel.
Method 2:
- Right-click on the instance.
- Go to the Group tab.
- Click the + button or choose a Group ID from the drop-down list.
Method 3:
- Select the instance.
- Press Ctrl+G on the keyboard.
Method 4:
- Select the instance that you want to add to a new group.
- Expand it in the right panel.
- In the Group tab, click the + button.
To add an instance to an existing group:
Method 1:
- Right-click on the instance.
- Go to the Group tab.
- Select a group from the list under Group ID.
Method 2:
- Select the instance that you want to add to an existing group.
- Expand it in the right panel.
- Go to the Group tab.
- Select a group from the list under Group ID.
Ungroup instances
To ungroup instances:
Method 1:
- Select the group.
- Click Ungroup in the top panel or press Ctrl+Shift+G on the keyboard.
Method 2:
- Right-click on the instance.
- Go to the Group tab.
- Select the X button next to the group name.
Method 3:
- Select the instance.
- Press Ctrl+Shift+G on the keyboard.
Approve/Disapprove instance
To approve an instance:
- Select the instance.
- Click the corresponding thumbs up button in the right panel or press Shift+Up arrow.
To disapprove an instance:
- Select the instance.
- Click the corresponding thumbs down button in the right panel or press Shift+Down arrow.
Apply annotations
To apply annotations to an image:
- Upload annotations to the project. Learn more.
- Open the image in the editor.
- In the top panel, click Apply pre-annotation.
- In the popup, click Yes. Note that the uploaded annotations will overwrite the current annotations.
Only Team Owners, Team Admins, and Project Admins can apply annotations.
Show/Hide multiple instances
To show and hide multiple objects at the same time:
- Select one or multiple instances on the canvas or the group’s dashed line.
- Right-click on any instance.
- Select the eye icon to show or hide the instances.
To unhide instances, select the eye icon of every instance you want to unhide in the right panel.
Delete instance
Delete instance
There are 2 ways to delete an instance:
Method 1
- Select the instance you want to delete.
- Press the Backspace or Delete keys on the keyboard.
Method 2
- Find the instance you want to delete in the right panel.
- Click the corresponding delete button.
Delete multiple instances
There are 2 ways to delete multiple instances at the same time:
Method 1
- Select an instance.
- Press and hold the Ctrl key on the keyboard.
- While holding the Ctrl key, select other instances.
- Press the Backspace or the Delete keys on the keyboard.
Method 2
- In the left panel, select the Select button.
- Click and hold while you drag your cursor to select the instances you want.
- Press the Backspace or the Delete keys on the keyboard.
Delete all the instances
To delete all the instances:
- Click the delete button in the right panel.
- In the popup, click Yes.
Updated 9 days ago