Settings & Shortcuts
The Annotation tool exposes two panels, from the right-side icon rail, dedicated to personalizing how you work: Settings, which holds your display and behavior preferences, and Shortcuts, which recaps the keyboard shortcuts currently active, whether at their default value or the one you personalized.

Access settings or shortcuts pages from Annotation tool
1. Settings panel
The Settings panel groups your personal preferences for the tool. They apply to your own account and persist across DatasetVersion. Once changed, click Update to save them.
A setting enforced by your OrganizationAn Admin of your Organization can set a value for any of these preferences and mark it as Enforced from the Policy page of the Organization settings (see Organization policy). An enforced setting is displayed with the value chosen for the whole team and cannot be changed from this panel, which is how a Computer Vision team keeps every annotator on the same display rules.

Settings available in the Annotation tool
A. General
- Auto move next on submit: automatically open the next
Assetin the queue right after submitting or reviewing the currentAnnotation. It doesn't apply to Save. - Auto-enable draw after release: automatically re-enable the Draw mode after finishing a
Shape, instead of falling back to Selection mode. - Lock shapes after creation: lock every
Shapeas soon as you validate it, so that aShapeyou have already placed cannot be moved by mistake while you draw the next one. It is turned off by default, and a lockedShapecan be unlocked at any time. - Default Zoom (%): the zoom level applied when opening an
Assetor using Reset Zoom. - Display minimap: show or hide the minimap displayed above the zoom controls, which situates the part of the
Assetyou are looking at inside the whole image. It is turned on by default, and it is most useful on large images you annotate zoomed in. See Navigation.
B. Grid
An optional grid can be displayed over the Asset, under the Shape. Its cells are named A1, B3… (and AA1 once past Z), which gives you and your reviewers a shared vocabulary to point at a region of a large image instead of describing it:
- Display grid: show or hide the grid. It is turned off by default, and the Shapes panel header also carries a button to turn it on for the current session only.
- Per-pixel grid: draw one cell per pixel of the image instead, which is useful when you zoom all the way in on a mask.
- Grid cells (longest side): the number of cells along the longest side of the image.
- A toggle to hide the A1, B2… names of the cells, for when you use the grid to align
Shaperather than to name a region of the image.
The lines are hidden when the zoom level makes the cells too small to be readable, and the cell names are only displayed when they fit.
C. Performances
- Enable cache: cache the next images in the queue. This aims at speeding up the navigation across the Asset gallery, especially if the files to display are big or if you have a slow internet connection.
- Cache size: the number of
Assetkept in cache.
D. Shapes
- Shape opacity (%): the fill opacity used to display all the
Shapeon theAsset. - Display the Shape opacity slider: show or hide the opacity slider displayed next to the zoom controls, which changes the same value without opening the Settings panel. It is turned on by default. See Actions on Shape.
- Display each shape with a unique color: display every
Shapeof theAssetin its own color instead of the color of itsLabel, which is the way to tell apartShapeof the sameLabelthat overlap. It is turned off by default. The Shapes panel header also carries a palette button to turn it on for the current session, with Shift + U as its default shortcut; the button is read-only when your Organization enforces the preference. TheShapelist and the timeline keep theLabelcolors. - Polygon simplification factor: how aggressively a polygon
Shapeis simplified when using the Simplify action (see Polygon editing) — the higher the factor, the more points are removed.
E. Labels
- Label Order: how
Labelare ordered in theLabeldropdown and the Shapes panel (Default, Alphabetical, or Reverse Alphabetical). - Display Shape Labels: show or hide the
Labelname next to eachShapeon theAsset. - Display Shape IDs: add the index of the
Shape(#1, #2…) next to itsLabelon theAsset, the same index as the one displayed in the Shapes panel. It is turned off by default, and it is what lets you name the exactShapeyou are discussing with a reviewer. The Shapes panel header also carries a button to turn it on and off for the current session, with Shift + I as its default shortcut.
F. Player
On a video DatasetVersion, an additional Player section configures the video player used to annotate:
- Annotation Default Duration when created (timeline only): the default duration (in frames) given to a new
Annotationwhen it is created. AShapedrawn in the Timelapse covers its step instead (see Annotate with the Timelapse). - Annotations last until the end of the video when created: a new
Annotationruns to the last frame of the video instead of lasting the default duration. - Step (frames): the number of frames of a jump of the player, and the size of a step in the Timelapse. It is the same value as the Step selector of the player, and it is kept from one
Assetto the next. - Display Skip to End / Beginning control: show or hide the buttons to jump to the start or end of the video.
- Display Frame Step controls: show or hide the buttons to move frame by frame.
- Enable Interpolation: automatically interpolate a
Shape's position between two keyframes. - Display Interpolation's Motion Path: draw, on the video itself, the path followed by the selected
Trackbetween its keyframes. See Linear interpolation. - Track order: how the
Trackare listed in the Shapes panel and in the timeline — grouped byLabel(the default), flat by creation date, or flat by first keyframe. The last one follows the chronology of the video, which helps when you work through a long sequence object after object. - Cursor out of Timeline behavior: how the timeline scrolls when the playback cursor reaches its edge (Stick to the Right, Stick to the Middle, or Moves back to the left).
2. Consult the active shortcuts
Most of the actions available in the Annotation tool can also be triggered through a keyboard shortcut. Shortcuts depend on the context you are in (the Annotation tool itself, an Assets overview, or globally across Picsellia) and, within the Annotation tool, on the Version Type of the DatasetVersion you are annotating.
The Shortcuts panel (right-side icon rail) displays a read-only, always up-to-date recap of every shortcut currently active for the DatasetVersion you are annotating, grouped into Tool, Annotation, and Queue Navigation sections, plus a Timeline section on video (see Video player).

Consult available shortcuts for Annotation tool
3. Personalize your shortcuts
Every shortcut of the Annotation tool can be personalized from the Shortcuts tab of your Personal Settings, under the Studio tab of the table. An Admin can also replace the default shortcuts for the whole Organization, and your personal shortcuts take precedence over them. Both are detailed in Customize your Keyboard Shortcuts.
4. Reference
The main shortcuts available by default are summarized below. Refer to the Shortcuts settings page for the exhaustive and always up-to-date list, including all the Version Type-specific variants.
A. Navigation
| Action | Default shortcut |
|---|---|
| Enable select mode | Esc |
| Pan | Space |
| Scroll | Shift + Space |
| Reset Zoom | R |
| Zoom in / out | Cmd/Ctrl + = / - |
Move to previous / next Asset | Shift + Tab / Tab |
Save Annotation | Cmd/Ctrl + S |
| Undo / Redo | Cmd/Ctrl + Z / Cmd/Ctrl + Shift + Z |
Lock / unlock the selected Shape | F |
Accept / Reject Annotation | Cmd/Ctrl + Shift + Enter / Cmd/Ctrl + Shift + Delete |
Change active Label | 0-9 |
| Open a panel of the right-side rail | Alt + 1 … Alt + 0 |
Show / hide the Shape indexes | Shift + I |
Display each Shape with a unique color | Shift + U |
The Alt + 1 to Alt + 0 shortcuts follow the display order of the icons in the right-side rail: Shapes, Selection, Data, Attributes, Instructions, History, Issues, Details, Settings, and Shortcuts. Each one is recalled in the tooltip of its button, and can be personalized like any other shortcut.
B. Drawing, by Version Type
| Version Type | Draw action | Default shortcut |
|---|---|---|
| Classification | Classify Asset | D |
| Object Detection | Draw rectangle | D |
| Object Detection | Draw rectangles with exemplar box (SAM3) | X |
| Object Detection | Draw rectangles with label prompts (SAM3) | Shift + X |
| Segmentation | Draw polygon | D |
| Segmentation | Draw polygon with pencil | Shift + D |
| Segmentation | Draw polygon with points (SAM3) | X |
| Segmentation | Draw polygon with box (SAM3) | X, 1 |
| Segmentation | Edit polygon with SAM (SAM3) | E, X |
| Segmentation | Cut polygon with scissors | S |
| Segmentation | Add / remove points with pencil | E / Shift + E |
| Segmentation | Draw polygons with points (SAM3) | Shift + X |
| Segmentation | Draw polygons with exemplar box (SAM3) | Shift + X, 1 |
| Segmentation | Draw polygons with label prompts (SAM3) | Shift + X, 2 |
| Segmentation | Draw polygons with text prompts (SAM3) | Shift + X, 3 |
| Mask | Draw mask with pencil | D |
| Mask | Draw mask with brush | Shift + D |
| Mask | Draw mask with point (SAM3) | X |
| Mask | Draw mask with box (SAM3) | X, 1 |
| Mask | Add / remove pixels with pencil | E / Shift + E |
| Mask | Add / remove pixels with brush | Cmd + E / Cmd + Shift + E |
| Mask | Edit mask with SAM (SAM3) | E, X |
| Mask | Draw masks with points (SAM3) | Shift + X |
| Mask | Draw masks with exemplar box (SAM3) | Shift + X, 1 |
| Mask | Draw masks with label prompts (SAM3) | Shift + X, 2 |
| Mask | Draw masks with text prompts (SAM3) | Shift + X, 3 |
| Point | Draw point | D |
| Line | Draw line | D |
| Keypoint | Draw keypoint | D |
| Keypoint | Draw with template (Skeleton) | T |
Version Type-specific keysSeveral of these actions share the same default key (e.g. D) because only one Version Type is active at a time on a given
DatasetVersion. The Shortcuts settings page also lists a distinct key mapping for a Multi Version Type, meant to make every Version Type's shortcuts active at once on the same key; as noted here, Multi cannot be selected yet, so this mapping is not usable in practice for now.
C. Video player
On a DatasetVersion that contains videos, the Annotation tool displays a player and a timeline (see Annotation tool for video). The group of the Shortcuts panel named Timeline lists the shortcuts of the player (which plays the video and moves along its frames) and the ones of the timeline (the grid that represents the Track along the frames):
| Action | Default shortcut |
|---|---|
| Play / Pause | K |
| Previous / Next frame | J / L |
| Jump backward / forward (Step frames) | Cmd/Ctrl + J / Cmd/Ctrl + L |
| Go to start / end frame | Alt + J / Alt + L |
| Previous / Next keyframe | Alt + Shift + J / Alt + Shift + L |
| Zoom the timeline in / out | Cmd/Ctrl + Wheel |
| Scroll the timeline horizontally | Shift + Wheel |
The number of frames of a jump is the Step value displayed on the right of the timeline. The Alt key is the Option key on a Mac. The two wheel gestures are listed with a + Wheel suffix, and the modifier they rely on can be rebound like any other shortcut. In the Timelapse tab, the four navigation shortcuts move between the steps instead of the frames, Shift + P propagates the selected Track to the next step, and Shift + N hides it on the current step only.
Working on a Track also comes with a few shortcuts:
| Action | Default shortcut |
|---|---|
Copy / Paste a Track | Cmd/Ctrl + C / Cmd/Ctrl + V |
Paste a Track without its keyframes | Cmd/Ctrl + Shift + V |
Duplicate a Track | Cmd/Ctrl + B |
Remove a Track | Backspace |
Split the selected Track at the cursor | Shift + S |
Cut the selected Track to the cursor | Shift + C |
| Join two sub-tracks (Join tracks) | Shift + M |
| Expand to the first frame / the cursor / the last frame | Shift + J / Shift + K / Shift + L |
The other actions of the video Annotation tool use the shortcuts of the tables above, for instance Draw rectangle, Undo, Save, or Change active label.
Updated 4 days ago