Keyboard shortcuts
Reference for built-in workspace, drawing, editor, replay, trading, and alert keyboard shortcuts, plus how to rebind, disable, or register 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
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 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
| 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
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
| 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 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
| Shortcut | Action |
|---|---|
Alt+A | Opens the Create Alert dialog pre-filled with the active symbol's last price |
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
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 |
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. To remove the Alt+A badge from the side rail's Alerts button, call describeRailEntry('vela-pro.alerts', { shortcut: '' }) after enableVelaPro().
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:
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
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:
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 for the rest of the editor handle API.
Related
- Interface layout
- Drawing tools for favorite tools and the radial wheel
- Keyboard in the core documentation