> For the complete documentation index, see [llms.txt](https://docs.protoboard.xyz/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.protoboard.xyz/editor/keyboard-shortcuts.md).

# Keyboard Shortcuts

All keyboard shortcuts for faster canvas editing, navigation, and board management, plus keyboard-only navigation of the Inspector and Parts Bin.

## Goal

Speed up your Protoboard workflow with keyboard shortcuts, or work entirely without a mouse using the Inspector's object tree.

***

## All shortcuts

On macOS, **Control** also works in place of **Cmd** for the shortcuts that use a modifier key.

| Action                                    | Windows / Linux                  | macOS                            |
| ----------------------------------------- | -------------------------------- | -------------------------------- |
| **Save board**                            | Ctrl+S                           | Cmd+S                            |
| **Undo**                                  | Ctrl+Z                           | Cmd+Z                            |
| **Redo**                                  | Ctrl+Shift+Z                     | Cmd+Shift+Z                      |
| **Redo** (alternate)                      | Ctrl+Y                           | Control+Y                        |
| **Copy selected parts**                   | Ctrl+C                           | Cmd+C                            |
| **Paste parts**                           | Ctrl+V                           | Cmd+V                            |
| **Delete selected** (canvas focused)      | Delete or Backspace              | Delete or Backspace              |
| **Add to selection**                      | Shift+click or Ctrl+click        | Shift+click or Cmd+click         |
| **Cancel placing a part**                 | Escape                           | Escape                           |
| **Pan the canvas** (canvas focused)       | Arrow keys                       | Arrow keys                       |
| **Pan farther** (canvas focused)          | Shift+Arrow keys                 | Shift+Arrow keys                 |
| **Pan with the mouse**                    | Hold Space and drag              | Hold Space and drag              |
| **Navigate the object tree**              | Up, Down, Home, End, Right, Left | Up, Down, Home, End, Right, Left |
| **Open an object from the tree**          | Enter                            | Enter                            |
| **Navigate concept images**               | Left / Right                     | Left / Right                     |
| **Close a dialog, menu, or image viewer** | Escape                           | Escape                           |
| **Move to notifications**                 | Alt+Shift+T                      | Option+Shift+T                   |
| **Move to other status messages**         | F8                               | F8                               |

***

## Shortcut categories

{% tabs %}
{% tab title="Board management" %}

| Action     | Windows / Linux | macOS |
| ---------- | --------------- | ----- |
| Save board | Ctrl+S          | Cmd+S |

Save frequently to protect your work. An asterisk (\*) after the board name in the header indicates unsaved changes.
{% endtab %}

{% tab title="Editing" %}

| Action                               | Windows / Linux           | macOS                    |
| ------------------------------------ | ------------------------- | ------------------------ |
| Undo                                 | Ctrl+Z                    | Cmd+Z                    |
| Redo                                 | Ctrl+Shift+Z              | Cmd+Shift+Z              |
| Redo (alternate)                     | Ctrl+Y                    | Control+Y                |
| Copy selected parts                  | Ctrl+C                    | Cmd+C                    |
| Paste parts                          | Ctrl+V                    | Cmd+V                    |
| Delete selected (canvas focused)     | Delete or Backspace       | Delete or Backspace      |
| Add to selection                     | Shift+click or Ctrl+click | Shift+click or Cmd+click |
| Cancel placing a part                | Escape                    | Escape                   |
| Commit a field edit in the Inspector | Enter                     | Enter                    |
| Cancel a field edit in the Inspector | Escape                    | Escape                   |

Undo and redo work for **all board operations**, including part placement, connection changes, and property edits. Copy and paste act on the canvas, so they work when the canvas has focus (or nothing else does).
{% endtab %}

{% tab title="Canvas navigation" %}

| Action                                   | Windows / Linux                               | macOS                                         |
| ---------------------------------------- | --------------------------------------------- | --------------------------------------------- |
| Pan (canvas focused)                     | Arrow keys                                    | Arrow keys                                    |
| Pan farther (canvas focused)             | Shift+Arrow keys                              | Shift+Arrow keys                              |
| Pan with the mouse                       | Hold Space and drag                           | Hold Space and drag                           |
| Zoom                                     | Scroll wheel or pinch                         | Scroll wheel or pinch                         |
| Select the focused part (canvas focused) | Enter or Space                                | Enter or Space                                |
| Move the selected part (canvas focused)  | Arrow keys, Shift+Arrow keys for larger steps | Arrow keys, Shift+Arrow keys for larger steps |
| Open the canvas menu                     | Shift+F10                                     | Shift+F10                                     |

To give the canvas keyboard focus, press **Tab** when the board opens and choose **Skip to canvas**. The **Zoom in**, **Zoom out**, **Frame all parts**, and **Frame selection** buttons in the canvas toolbar are reachable with Tab. The **Select mode** and **Pan mode** buttons switch between editing and pan-only dragging. The **Shortcuts and controls** button at the bottom of the canvas lists these keys in its **Keyboard** group.
{% endtab %}

{% tab title="Inspector and object tree" %}

| Action                                   | Keys        |
| ---------------------------------------- | ----------- |
| Move to the previous or next object      | Up / Down   |
| Jump to the first or last object         | Home / End  |
| Jump to an object by its first letter    | Letter keys |
| Expand a group or move into its members  | Right       |
| Collapse a group or return to its parent | Left        |
| Open the object in the Inspector         | Enter       |

Press **Tab** when a board opens and choose **Skip to inspector** to jump straight to the object tree. **Space** is reserved for canvas panning, so use **Enter** to open objects. The **Back to objects** button returns you to the tree. See [Accessibility](https://docs.protoboard.xyz/help/accessibility.md) for the full keyboard-only workflow.
{% endtab %}

{% tab title="Parts Bin" %}

| Action                             | Keys                                                                             |
| ---------------------------------- | -------------------------------------------------------------------------------- |
| Move between categories            | Up / Down                                                                        |
| Jump to the first or last category | Home / End                                                                       |
| Open a category                    | Right                                                                            |
| Return to the parent category      | Left                                                                             |
| Add a part to the board            | Tab to the part's **Add** button, then Enter                                     |
| Move past the part cards           | **Skip parts list** button                                                       |
| Load the next page of parts        | **Load more parts** button (automatic loading pauses while focus is in the list) |
| {% endtab %}                       |                                                                                  |

{% tab title="ProtoBot" %}

| Action                         | Keys                             |
| ------------------------------ | -------------------------------- |
| Send a message                 | Enter                            |
| Start a new line               | Shift+Enter                      |
| Send from the dashboard prompt | Enter, or Ctrl+Enter / Cmd+Enter |
| Choose a slash command         | Up / Down, then Tab or Enter     |
| {% endtab %}                   |                                  |

{% tab title="Concept images" %}

| Action                | Keys         |
| --------------------- | ------------ |
| Previous / next image | Left / Right |
| Close viewer          | Escape       |

These shortcuts are active when the **concept image viewer** is open in the Board Identity tab. To delete an image, use the labeled **Delete** button; there is no delete shortcut, so a stray key press never removes an image.
{% endtab %}
{% endtabs %}

***

## Tips

{% hint style="info" %}
**Shortcuts are disabled when typing.** When your cursor is in a text input, text area, or any editable field, keyboard shortcuts are turned off so they do not interfere with your typing. Tab out of the field (or click the canvas) to use shortcuts again. Delete and Backspace only remove board objects while the canvas has focus.

**Typing jumps to the chat box.** When nothing else has focus, typing a character moves focus to the ProtoBot chat box. To turn this off, open **More options** and clear **Typing moves focus to the chat box**.
{% endhint %}

{% hint style="success" %}
**Build the Ctrl+S habit.** Quick save is the single most important shortcut. Use it after every meaningful change: placing a part, configuring a harness, or completing a fix.
{% endhint %}

{% hint style="info" %}
**Need more contrast?** Press Tab once on any page and activate **High contrast mode** in the Accessibility shortcuts bar, or use the **More options** menu in the header. It also turns on automatically when your system's increased contrast setting is on. It strengthens text, borders, and focus indicators. See [Accessibility](https://docs.protoboard.xyz/help/accessibility.md).
{% endhint %}

***

## Related pages

* [Accessibility](https://docs.protoboard.xyz/help/accessibility.md): keyboard-only workflows, high contrast mode, and screen reader notes
* [Editor tour and canvas basics](https://docs.protoboard.xyz/editor/canvas-basics.md): canvas navigation and editing actions
* [Saving, drafts and recovery](https://docs.protoboard.xyz/organize/saving-and-drafts.md): saving and board management
* [Board Identity](https://docs.protoboard.xyz/editor/board-identity.md): concept image viewer navigation
