---
updatedAt: 2026-10-08T14:32:41.000Z
agentTools:
  projectIndex: https://documentation.picsellia.com/llms.txt
---

# Settings & Shortcuts

The [Annotation tool](https://documentation.picsellia.com/docs/dataset-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.

<Image src="https://files.readme.io/3f7df6fb2f9527177cf2beb7eda9e7047bce9c93ee3aa7956077230de7b0b0ee-image.png" align="center" caption="Access settings or shortcuts pages from Annotation tool" border={true} />

## 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.

<Image src="https://files.readme.io/e8d61133ec3f6580066e52e65926b6176e3a6d089126c7b248a38fe6f85185a3-image.png" align="center" caption="Settings available in the Annotation tool" border={true} />

### A. General

* **Auto move next on submit**: automatically open the next `Asset` in the queue right after submitting or reviewing the current `Annotation`. 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.
* **Default Zoom (%)**: the zoom level applied when opening an `Asset` or using *Reset Zoom*.

### B. 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 `Asset` kept in cache.

### C. Shapes

* **Shape opacity (%)**: the fill opacity used to display all the `Shape` on the `Asset`.
* **Polygon simplification factor**: how aggressively a polygon `Shape` is simplified when using the *Simplify* action (see [Polygon editing](https://documentation.picsellia.com/docs/dataset-annotation-shape-creation#c-polygon-editing)) — the higher the factor, the more points are removed.

### D. Labels

* **Label Order**: how `Label` are ordered in the `Label` dropdown and the *Shapes* panel (*Default*, *Alphabetical*, or *Reverse Alphabetical*).
* **Display Shape Labels**: show or hide the `Label` name next to each `Shape` on the `Asset`.

### E. Player

On a video `DatasetVersion`, an additional *Player* section configures the video player used to annotate:

* **Annotation Default Duration when created**: the default duration (in frames) given to a new `Annotation` when it is created.
* **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.
* **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* and *Navigation* sections.

<Image src="https://files.readme.io/ee38c265888532bf3cef4f43a564f41f71f30e5cb24cd11c67e44d33b953f6de-image.png" align="center" caption="Consult available shortcuts for Annotation tool" border={true} />

## 3. Personalize your shortcuts

Shortcuts can now be personalized on a per-user basis, from your *Profile* settings: click on your avatar, go to *Advanced > Shortcuts*, or access it directly at *Settings > Shortcuts*.

This page lists every action available on Picsellia with its current keystroke, and lets you filter them by *Context*:

* **Studio**: actions available in the *Annotation tool*.
* **Data grid**: actions available in the *Assets*, *Datalake*, or other list/grid views.
* **Global**: actions available anywhere in the product.

Some actions are also scoped to a specific *Version Type* (for instance, the *D* key draws a rectangle in *Object Detection* mode but a polygon in *Segmentation* mode) or to a specific condition, such as being inside an ongoing *Annotation Campaign*.

To personalize a shortcut, click on its row, then *Click to record a shortcut* and press the new key combination. Once changed, the *Source* column of the corresponding row switches from *Default* to *Custom*, so you can always tell at a glance which shortcuts you have overridden. A customized shortcut can be reset back to its *Default* value at any time.

<Callout icon="👍" theme="okay">
  ### Shortcuts are personal

  Custom shortcuts are tied to your own user account and apply wherever you use Picsellia; they don't affect other members of your `Organization`.
</Callout>

## 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                  |
| Accept / Reject `Annotation`    | Cmd/Ctrl + Shift + Enter / Cmd/Ctrl + Shift + Delete |
| Change active `Label`           | 0-9                                                  |

### 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                         |

<Callout icon="📘" theme="info">
  ### Version Type-specific keys

  Several 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](https://documentation.picsellia.com/docs/dataset-annotation-shape-creation), _Multi_ cannot be selected yet, so this mapping is not usable in practice for now.
</Callout>