Photopea reference · Chapter 12

Keyboard shortcuts

Every shortcut that matters, grouped by the way you actually work, with the browser-specific differences called out and the one gap — no remapping — that affects non-US keyboards.

Independent referenceUpdated 4 November 202613 min readReviewed by the photoedit.in editorial team

Chapter 12 · Keyboard shortcuts

Photopea's shortcut map is deliberately close to Photoshop's, which is the single biggest reason Photoshop users feel at home within an hour. The differences are concentrated in the places where a browser cannot behave like a desktop application: file operations, print, and anything that would normally open a native dialog. This chapter is the verified map, grouped the way you actually reach for keys rather than alphabetically.

How to read this chapter

Modifier keys are written for Windows and Linux. On macOS, substitute Cmd for Ctrl and Option for Alt throughout, with the exceptions noted at the end. Keys are shown as they appear in the in-app shortcut list, which is reachable from Help > Keyboard Shortcuts.

File and document

ActionShortcutNotes
New documentCtrl+NOpens the new-document dialog with presets
OpenCtrl+ONative file picker, or the storage browser
Open as smart objectCtrl+Shift+OPlaces the file as a smart object in the current document
SaveCtrl+SWrites back to the same file in Chromium; downloads elsewhere
Save asCtrl+Shift+SFull format and location choice
Export asCtrl+Shift+ESave-for-web style dialog
Close documentCtrl+WCloses the tab, not the browser window
Place embeddedFile menuNo default shortcut; assignable through the menu

The one shortcut that behaves differently from Photoshop is Ctrl+S. In Chromium with the File System Access API it writes back to the file you opened, exactly as you expect. In Firefox and Safari it triggers a download, because the browser will not let a page write to disk silently. Photopea cannot work around that, so the behaviour follows the browser rather than the application.

Edit and history

ActionShortcutNotes
UndoCtrl+ZHistory-based, not a fixed step count
RedoCtrl+Shift+ZCtrl+Y also works
Step backwardCtrl+Alt+ZMoves one history state back without discarding the future
Step forwardCtrl+Shift+Alt+ZThe counterpart
CutCtrl+XApplies to the selection or the active layer
CopyCtrl+CMerged copy with Ctrl+Shift+C
PasteCtrl+VPastes as a new layer
Paste in placeCtrl+Shift+VKeeps the original position
Free transformCtrl+TScale, rotate, skew, distort, perspective
Fill with foregroundAlt+BackspaceRespects the selection
Fill with backgroundCtrl+BackspaceRespects the selection
PreferencesCtrl+KTheme, language, performance, cursor

History in Photopea is a linear state list with a configurable depth, not a non-linear document history. Ctrl+Alt+Z steps backward while preserving the ability to step forward, which is the behaviour Photoshop users expect from the History panel. There is no history brush, so you cannot paint from a past state; chapter 6 covers that gap.

Image and canvas

ActionShortcutNotes
Image sizeCtrl+Alt+IPixel dimensions and resolution
Canvas sizeCtrl+Alt+CChanges the canvas without scaling content
Auto toneCtrl+Shift+LLevels-based automatic contrast
Auto contrastCtrl+Alt+Shift+LContrast only, no colour shift
Auto colourCtrl+Shift+BNeutralises colour casts
LevelsCtrl+LAdjustment dialog
CurvesCtrl+MAdjustment dialog
Hue/saturationCtrl+UAdjustment dialog
Colour balanceCtrl+BAdjustment dialog
DesaturateCtrl+Shift+UDestructive, unlike a Black & White adjustment layer
InvertCtrl+IDestructive
CropCTool, not a dialog; Enter commits

Layers

ActionShortcutNotes
New layerCtrl+Shift+NDialog; Ctrl+Shift+Alt+N creates without a dialog
Duplicate layerCtrl+JDuplicates the active layer or the selection
Layer via copyCtrl+JWith a selection active, copies it to a new layer
Merge downCtrl+EMerges the active layer into the one below
Merge visibleCtrl+Shift+ECreates a merged layer from all visible layers
Flatten imageCtrl+Shift+FDiscards hidden layers
Group layersCtrl+GGroups the selected layers
UngroupCtrl+Shift+GDissolves the group
Bring forwardCtrl+]One step up the stack
Send backwardCtrl+[One step down the stack
Bring to frontCtrl+Shift+]Top of the stack
Send to backCtrl+Shift+[Bottom of the stack
Create clipping maskCtrl+Alt+GClips the active layer to the one below
Merge all visible to a new documentLayer menuNo default shortcut

Layer selection has a set of modifier behaviours that are worth memorising because they are the difference between slow and fast compositing. Alt+click on the eye icon isolates a layer, hiding all others. Alt+click on a mask thumbnail enters mask editing. Shift+click on a mask thumbnail toggles the mask on and off. Ctrl+click on a layer thumbnail loads its transparency as a selection, which is the single most-used shortcut in retouching.

Selections

ActionShortcutNotes
Select allCtrl+AWhole canvas
DeselectCtrl+DClears the selection
ReselectCtrl+Shift+DRestores the last selection
InverseCtrl+Shift+IInverts the active selection
FeatherShift+F6Softens the selection edge
Refine edgeCtrl+Alt+REdge detection and output to mask
Quick maskQToggles the mask overlay
Add to selectionShift+dragUnion
Subtract from selectionAlt+dragDifference
Intersect selectionShift+Alt+dragIntersection
Constrain marquee to square or circleShift+dragApplies to rectangular and elliptical marquees
Draw from centreAlt+dragApplies to marquees and shape tools

View, zoom and navigation

ActionShortcutNotes
Zoom inCtrl++Steps up the zoom ladder
Zoom outCtrl+-Steps down
Fit on screenCtrl+0Fits the whole canvas
Actual pixels (100%)Ctrl+1One image pixel per screen pixel
Zoom toolZClick to zoom in, Alt+click to zoom out
Hand toolHPan; hold Space for temporary hand from any tool
Scrubby zoomZ+dragDrag left and right to zoom continuously
Toggle rulersCtrl+RHorizontal and vertical rulers
Toggle gridCtrl+'Configurable spacing
Toggle guidesCtrl+;Show or hide guides
SnapCtrl+Shift+;Snap to guides, grid and layers
Rotate viewRRotate canvas for drawing comfort; Esc resets
Toggle panelsTabHides all panels; Shift+Tab hides only the right dock
Full screenFCycles the browser full-screen state

The Space-to-pan behaviour is the one shortcut that separates fluent users from struggling ones. Holding space temporarily swaps any tool for the hand, releasing it returns you to what you were doing. It works while a selection is in progress and while a transform is active, which is when you most need it.

Tools

KeyToolKeyTool
VMoveBBrush
MMarquee (rectangular / elliptical)NPencil / line
LLasso (freehand / polygonal / magnetic)SClone stamp
WQuick selection / magic wandJSpot healing / healing brush / patch
ODodge / burn / spongeEEraser
GGradient / paint bucketTType (horizontal / vertical)
PPen (pen / freeform / curvature)UShape (rectangle / ellipse / polygon / line / custom)
APath selection / direct selectionIEyedropper / colour sampler / measure
CCrop / sliceYHistory brush (not available — see chapter 6)
XSwap foreground and backgroundDDefault black and white colours

Tools with variants are grouped under one key. Pressing the same key repeatedly cycles through the group, which is how Photoshop users reach the elliptical marquee from M or the magnetic lasso from L. Holding Shift while pressing the key cycles backwards through the group.

Brush size and hardness have their own pair of keys, and they are the ones you will use most. [ decreases brush size, ] increases it. Shift+[ decreases hardness, Shift+] increases it. For opacity, the number keys set it directly: 1 is 10%, 5 is 50%, 0 is 100%, and pressing two digits quickly sets an exact value, so 35 gives 35%.

Text and vector

ActionShortcutNotes
Commit text or transformEnterAlso commits a crop
Cancel text or transformEscReverts to the previous state
Increase / decrease font sizeCtrl+Shift+. / ,Steps through the size list
Increase / decrease trackingAlt+Right / LeftWith text selected
Increase / decrease leadingAlt+Up / DownWith text selected
Toggle path selectionABetween path and direct selection
Convert path to selectionCtrl+EnterWith a path active
Add anchor pointPen tool click on segmentNo modifier needed
Remove anchor pointPen tool click on anchorNo modifier needed
Convert anchor to corner / smoothAlt+click anchorToggles the knot type

Customisation, and the gap that matters

Photopea does not expose a shortcut editor in the way Photoshop does. You cannot remap a key through a preferences panel, and you cannot save a custom shortcut set. The in-app list under Help > Keyboard Shortcuts is documentation, not configuration.

QWERTZ and non-US layouts

Because shortcuts are bound to physical key positions rather than to characters, a German QWERTZ keyboard reaches Z where a US layout has Y, which swaps undo and redo in ways that are disorienting. There is no built-in remapping to fix it. The practical workaround is to switch the browser's input language to a US layout while editing, or to use a keyboard with a hardware layout switch. This is a real limitation for a large share of European users and it is not documented prominently.

The absence of remapping is the one place where Photopea's shortcut story is weaker than a desktop editor's. Everything else — the tool keys, the modifier behaviours, the brush resizing, the number-key opacity — matches Photoshop closely enough that muscle memory transfers. If you are coming from GIMP, the mapping is different enough that you will spend a week retraining, because GIMP uses Ctrl+Z for undo but assigns tools to different letters.

A minimal set to learn first

If you learn only ten shortcuts, learn these, because they cover the majority of the keystrokes in a normal retouching session: V to move, B to brush, M to marquee, L to lasso, Ctrl+J to duplicate, Ctrl+T to transform, Ctrl+D to deselect, Ctrl+Z to undo, [ and ] to resize the brush, and Space to pan. Everything else is refinement.

Chapter 19 turns to the limitations, which is where the decision about whether Photopea fits your work actually gets made.