# Keyboard shortcuts (/vela-pro/customization/shortcuts)



This reference lists every default keyboard shortcut and pointer modifier in a Vela Pro workspace by functional area, followed by how to rebind keys, disable shortcut groups, and register custom shortcuts.

Throughout these tables, `Ctrl/⌘` denotes `Ctrl` on Windows and Linux and `⌘` on macOS, where `Alt` corresponds to `Option`. Workspace shortcuts fire while keyboard focus is inside the workspace container, which happens automatically once a user clicks a chart. Set `autofocus: true` on `new VelaWorkspace()` if shortcuts should work immediately on page load before the first click.

## Chart and workspace [#chart-and-workspace]

Pressing `?` opens the keyboard shortcuts dialog from Vela's open-source core, which lists every registered binding ID from the tables below alongside mouse gestures in the active locale.

| Shortcut                       | Action                                                       | Binding ID                        |
| ------------------------------ | ------------------------------------------------------------ | --------------------------------- |
| Letter key or `0`              | Opens symbol search pre-filled with the typed character      |                                   |
| Digit `1` to `9`               | Opens quick timeframe entry (such as `15`, `4H`, `D`)        |                                   |
| `/`                            | Opens the indicator menu                                     | `indicators.open`                 |
| `?`                            | Opens the keyboard shortcuts dialog                          | `help.shortcuts`                  |
| `Ctrl/⌘+Z`                     | Undo                                                         | `history.undo`                    |
| `Ctrl/⌘+Y` or `Ctrl/⌘+Shift+Z` | Redo                                                         | `history.redo`                    |
| `Ctrl/⌘+↑`, `Ctrl/⌘+↓`         | Zoom in or zoom out                                          | `view.zoom-in`, `view.zoom-out`   |
| `Ctrl/⌘+←`, `Ctrl/⌘+→`         | Pan backward toward history or forward toward the latest bar | `view.pan-left`, `view.pan-right` |
| `Alt+R`                        | Reset chart view                                             | `chart.reset-view`                |
| `Alt+L`                        | Toggle logarithmic price scale                               | `chart.toggle-log`                |
| `Alt+P`                        | Toggle percentage price scale                                | `chart.toggle-percent`            |
| `Ctrl/⌘+Alt+S`                 | Download a screenshot of the workspace layout                | `chart.screenshot`                |
| `←`, `→`                       | Move the crosshair by one bar                                |                                   |
| `Shift+←`, `Shift+→`           | Pan by ten bars                                              |                                   |
| `Alt+Shift+→`                  | Scroll back to the newest bars                               |                                   |
| `+`, `-`                       | Zoom in or zoom out by one step                              |                                   |
| `Home`, `End`                  | Move the crosshair to the first or last loaded bar           |                                   |
| `Esc`                          | Clear the crosshair                                          |                                   |
| `Shift` + scroll               | Pan horizontally through history instead of zooming          |                                   |
| `Shift` + click                | Start the measure ruler at the pointer position              |                                   |

## Drawing tools [#drawing-tools]

Drawing shortcuts act on the currently selected drawing (or on the hovered drawing when deleting) and are inactive whenever a text input has focus.

| Shortcut                           | Action                                                                      | Binding ID              |
| ---------------------------------- | --------------------------------------------------------------------------- | ----------------------- |
| `Alt+T`                            | Activate the trend line tool                                                | `drawings.trendline`    |
| `Alt+H`                            | Place a horizontal line at the cursor price                                 | `drawings.hline-cursor` |
| `Alt+V`                            | Place a vertical line at the cursor timestamp                               | `drawings.vline-cursor` |
| `Ctrl/⌘+C`, `Ctrl/⌘+V`, `Ctrl/⌘+D` | Copy, paste, or duplicate the selected drawing                              |                         |
| `Delete` or `Backspace`            | Delete the selected or hovered drawing                                      |                         |
| Arrow keys, `Shift` + arrow keys   | Nudge the selected drawing by 1 px, or by 10 px with `Shift`                |                         |
| `Esc`                              | Cancel an active drawing placement or ruler, or clear the current selection |                         |
| Middle-click                       | Delete the drawing directly under the pointer                               |                         |

## Radial tool wheel [#radial-tool-wheel]

| Shortcut            | Action                                                                                                                   |
| ------------------- | ------------------------------------------------------------------------------------------------------------------------ |
| Hold `Alt`          | Opens the radial picker of favorite drawing tools after 200 ms; move the pointer over a tool and release `Alt` to arm it |
| Click the wheel hub | Toggles the ring between favorite drawing tools and favorite timeframes                                                  |

Tapping `Alt` briefly without holding does not open the wheel, and pressing a chord key such as `T` while `Alt` is held cancels the wheel and executes `Alt+T` instead.

## Pine code editor [#pine-code-editor]

Editor shortcuts apply while keyboard focus is inside the Pine code editor panel.

| Shortcut             | Action                                                                                                        |
| -------------------- | ------------------------------------------------------------------------------------------------------------- |
| `Ctrl/⌘+Enter`       | Compiles and runs the script (adds a new indicator when unbound, or updates the bound indicator in place)     |
| `Ctrl/⌘+K`, then `I` | Replaces the buffer with the starter script template                                                          |
| `Ctrl/⌘+Z`           | Undo (also restores the previous document in a single step after starting a new script or opening a favorite) |
| `F1`                 | Opens the editor command palette                                                                              |

## Bar replay [#bar-replay]

| Shortcut  | Action                                                                    |
| --------- | ------------------------------------------------------------------------- |
| `Space`   | Plays or pauses an active bar replay                                      |
| `Shift+→` | Advances an active bar replay by one step                                 |
| `Esc`     | Cancels interactive start-bar selection or an in-progress historical load |

## Trading [#trading]

Trading shortcuts are registered when the `@luxalgo/vela-pro-trading` module is installed.

| Shortcut               | Action                                                                          |
| ---------------------- | ------------------------------------------------------------------------------- |
| `Shift+B`              | Places or drafts a market buy order on the active chart's symbol                |
| `Shift+S`              | Places or drafts a market sell order on the active chart's symbol               |
| `Shift+1` to `Shift+9` | Populates the order ticket using the corresponding preset (first through ninth) |

When one-click trading is enabled, `Shift+B` and `Shift+S` submit market orders immediately; otherwise, they populate a draft order for user review. On pages with multiple workspaces, trading shortcuts route first to the workspace containing keyboard focus, then to the workspace under the pointer, then to the most recently used workspace, and finally to the first mounted workspace.

## Alerts [#alerts]

| Shortcut | Action                                                                       |
| -------- | ---------------------------------------------------------------------------- |
| `Alt+A`  | Opens the Create Alert dialog pre-filled with the active symbol's last price |

## Menus and panels [#menus-and-panels]

| Surface                  | Shortcut                 | Action                                                                          |
| ------------------------ | ------------------------ | ------------------------------------------------------------------------------- |
| Indicator menu           | `↑`, `↓`                 | Moves selection up or down the results list                                     |
| Indicator menu           | `Enter`, `Shift+Enter`   | Adds the highlighted indicator to the chart (`Shift+Enter` keeps the menu open) |
| Indicator menu           | `F`                      | Toggles favorite status on the highlighted indicator                            |
| Indicator menu           | `/`                      | Moves focus to the search input                                                 |
| Indicator menu           | `Esc`                    | Clears the search query if non-empty, or closes the menu                        |
| Watchlist (when focused) | `↑`, `↓`                 | Selects the previous or next symbol in the list on the active chart             |
| Watchlist (when focused) | `Delete` or `Backspace`  | Removes the active symbol from the watchlist                                    |
| Footprint chart          | Hold `Shift` over a cell | Displays a magnified readout tooltip for the bar under the pointer              |

## Configuring and disabling shortcuts [#configuring-and-disabling-shortcuts]

Shortcuts with a binding ID belong to the core `workspace.keymap` registry and can be rebound or unregistered at runtime. Vela Pro feature and module shortcuts are configured through their respective options in `enableVelaPro()`.

| Shortcut group                                | Configuration API                                                                                             |
| --------------------------------------------- | ------------------------------------------------------------------------------------------------------------- |
| Bindings with a Binding ID                    | `workspace.keymap.rebind(id, keys)` updates the key chord, and `workspace.keymap.unregister(id)` removes it   |
| Single-key symbol search (`A`-`Z`, `0`)       | Pass `symbolMenuFromKey: false` to `VelaWorkspace` (digits `1`-`9` continue to open quick timeframe entry)    |
| Radial tool wheel (`Alt` hold)                | Configure `radialWheel: { triggerKey, holdMs }` to change the key or hold delay, or pass `radialWheel: false` |
| Bar replay (`Space`, `Shift+→`)               | Pass `replay: { keys: false }` to `enableVelaPro()`                                                           |
| Create Alert (`Alt+A`)                        | Pass `alerts: { shortcut: false }` to `enableVelaPro()`                                                       |
| Trading (`Shift+B`, `Shift+S`, `Shift+1`-`9`) | Pass `trading({ shortcuts: false })` inside `plugins`                                                         |

```ts
import { VelaWorkspace } from '@luxalgo/vela/workspace';
import { BinanceProvider } from '@luxalgo/vela/providers/binance';
import { enableVelaPro } from '@luxalgo/vela-pro';
import { trading } from '@luxalgo/vela-pro-trading';

enableVelaPro({
    replay: { keys: false },
    alerts: { shortcut: false },
    radialWheel: { triggerKey: 'F2' },
    plugins: [trading({ shortcuts: false })],
});

const workspace = new VelaWorkspace('#chart', {
    layout: false,
    symbol: 'BTCUSDT',
    timeframe: '60',
    live: true,
    providers: { binance: () => new BinanceProvider() },
    symbolMenuFromKey: false,
});

workspace.keymap.rebind('chart.reset-view', 'alt+shift+r');
workspace.keymap.unregister('drawings.trendline');
```

Opt-in modules such as `trading()` are passed inside the `plugins` array of `enableVelaPro()`. The `radialWheel.triggerKey` option expects a standard `KeyboardEvent.key` value. Key chords passed to `workspace.keymap.rebind()` combine modifier names and a single key with `+`, where `mod` maps to `⌘` on macOS and `Ctrl` on Windows and Linux. Keymap overrides belong to an individual `VelaWorkspace` instance, so apply them whenever you create a workspace.

Tooltip cards store shortcut badges as static strings rather than reading `workspace.keymap` dynamically. After rebinding or removing a shortcut displayed on a topbar tooltip card (Indicators, Undo, Redo, or Download screenshot), update its badge text through [`richTooltips.cards`](/vela-pro/customization/interface#tooltip-cards). To remove the `Alt+A` badge from the side rail's Alerts button, call `describeRailEntry('vela-pro.alerts', { shortcut: '' })` after `enableVelaPro()`.

### Registering workspace shortcuts [#registering-workspace-shortcuts]

Call `workspace.keymap.register()` to bind a custom shortcut across the workspace. Registered shortcuts appear automatically in the `?` keyboard shortcuts dialog under the specified `category`:

```ts
import type { VelaWorkspace } from '@luxalgo/vela/workspace';

declare const workspace: VelaWorkspace;
declare function exportTrades(): void;

workspace.keymap.register({
    id: 'acme.export-trades',
    keys: 'mod+shift+e',
    label: 'Export trades',
    category: 'ACME',
    run: () => exportTrades(),
});
```

## Custom editor shortcuts [#custom-editor-shortcuts]

While focus is inside the Pine code editor, keyboard shortcuts are managed by the editor instance rather than `workspace.keymap`. Call `addAction()` on the handle returned by `codeEditor(workspace)` to bind a shortcut inside the editor and expose the command in the `F1` command palette:

```ts
import type { VelaWorkspace } from '@luxalgo/vela/workspace';
import { codeEditor } from '@luxalgo/vela-pro';

declare const workspace: VelaWorkspace;
declare function saveScript(source: string): Promise<void>;

const editor = codeEditor(workspace);
if (editor) {
    editor.addAction({
        id: 'acme.save',
        label: 'Save script',
        keys: 'mod+s',
        run: () => void saveScript(editor.getCode()),
    });
}
```

The `keys` property accepts `mod`, `ctrl`, `shift`, and `alt` modifiers followed by a letter, a digit, `f1` through `f12`, `enter`, `escape`, `tab`, `space`, `backspace`, `delete`, or an arrow name (`up`, `down`, `left`, `right`). `addAction()` returns a cleanup function that removes the command and keybinding. See [Pine code editor](/vela-pro/indicators/pine/code-editor) for the rest of the editor handle API.

## Related [#related]

* [Interface layout](/vela-pro/customization/interface)
* [Drawing tools](/vela-pro/charts/drawings/tools) for favorite tools and the radial wheel
* [Keyboard](/vela/user/workspace#keyboard) in the core documentation
