You can control SumatraPDF with commands:

Find command:

Command IDs Keyboard shortcuts Command Palette

File #

Command IDs Keyboard shortcuts Command Palette
CmdClose Ctrl + W, Ctrl + F4 Close Document
CmdCloseCurrentDocument q Close Current Document
CmdCommandPalette Ctrl + K Command Palette
CmdCommandPaletteTOC Shift + F12 Command Palette: Table Of Contents
Jump to a table of contents entry of the current document, ver 3.7+
CmdCommandPaletteFavorites Command Palette: Favorites
Jump to a favorite, ver 3.7+
CmdDuplicateInNewWindow Shift + Ctrl + N Open Current Document In New Window
CmdDuplicateInNewTab Open Current Document In New Tab
ver 3.6+
CmdExit Ctrl + Q Exit Application
CmdMoveFrameFocus F6 Move Frame Focus
CmdNewWindow Ctrl + N Open New SumatraPDF Window
CmdOpenFile Ctrl + O Open File...
uses the Windows file picker or Navigate Files in Folder according to the `FilePicker` advanced setting (empty/os = Windows, sumatrapdf = in-app), ver 3.7+
CmdOpenFileNoHistory Open File Without History...
same picker as Open File, but the document is not added to File History or Windows Recent Documents (fixes #6121), ver 3.7+
CmdOpenFileWithOSFilePicker Open File With Windows File Picker...
always the standard Windows multi-select file open dialog, ver 3.7+
CmdToggleFilePicker SumatraPDF File Picker
checkbox under File and Settings; toggles `FilePicker` empty/os ↔ sumatrapdf, ver 3.7+
CmdToggleBoolSetting Toggle Boolean Setting
in the Command Palette, lists boolean advanced settings; Enter or a click toggles one and closes. Custom shortcuts: `CmdToggleBoolSetting ` (case-insensitive leaf or dotted path), e.g. `Fullscreen.ShowMenubar` (fixes #5912), ver 3.7+
CmdFixDefaultApp Fix Default App For Extension
`CmdFixDefaultApp .pdf` opens the OS dialog to set the default app for that extension; used by the home-page bottom bar when Sumatra is no longer the default, ver 3.7+
CmdOpenNextFileInFolder Shift + Ctrl + Right Open Next File In Folder
CmdNavigateFilesInFolder Shift + Ctrl + Up Navigate Files in Folder
directory browser for openable files in the current file's folder (stays open; Enter/double-click replaces the current tab, Ctrl+Enter/Ctrl+double-click switches to the tab already showing the file or opens a new tab, Alt+Up goes to the parent directory, Del moves the selected file to the recycle bin, F5 re-reads the directory); also used when `FilePicker = sumatrapdf`, ver 3.7+
CmdOpenPrevFileInFolder Shift + Ctrl + Left Open Previous File In Folder
CmdOpenSelectedDocument Open Selected Document
CmdPinSelectedDocument Pin Selected Document
CmdPrint Ctrl + P Print Document...
CmdProperties Ctrl + D Document Properties...
CmdReloadDocument r Reload Document
CmdRenameFile F2 Rename File...
CmdReopenLastClosedFile Shift + Ctrl + T Reopen Last Closed
CmdSaveAs Ctrl + S Save File As...
CmdToggleCursorPosition m Toggle Cursor Position
CmdShowInFolder Show File In Folder...
Explorer (selects the file), or Navigate Files in Folder when FilePicker = sumatrapdf, ver 3.7+
CmdToggleBookmarks F12 Toggle Bookmarks
CmdToggleTableOfContents Toggle Table Of Contents
ver 3.6+
CmdCollapseAll Collapse All
Bookmarks: collapse the outline; if there is only one top-level entry with children, expand it one level (Word-style TOC), ver 3.7+
CmdExpandAll Expand All
CmdExpandToCurrentPage Expand TOC to Current Page
In the Bookmarks (table of contents) sidebar, expand the tree down to the entry for the current page and select it, ver 3.7+
CmdTocExpandToLevel1 Bookmarks: Expand to Level 1
Collapse the Bookmarks tree so only top-level entries are visible (context menu), ver 3.7+
CmdTocExpandToLevel2 Bookmarks: Expand to Level 2
Expand top-level Bookmarks once (context menu), ver 3.7+
CmdTocExpandToLevel3 Bookmarks: Expand to Level 3
Expand Bookmarks two levels deep (context menu), ver 3.7+
CmdTocCollapseSameLevel Bookmarks: Collapse Same Level
Collapse all Bookmarks siblings of the selected/clicked entry (same nesting level), ver 3.7+
CmdOpenEmbeddedPDF Open Embedded PDF
CmdSaveEmbeddedFile Save Embedded File...
CmdCreateShortcutToFile Create .lnk Shortcut
CmdSelectAll Ctrl + A Select All
CmdExtendSelectionCharLeft Extend Selection One Character Left
ver 3.7+, no default shortcut; grows or shrinks the existing text selection (see below)
CmdExtendSelectionCharRight Extend Selection One Character Right
ver 3.7+, no default shortcut; grows or shrinks the existing text selection (see below)
CmdExtendSelectionWordLeft Extend Selection One Word Left
ver 3.7+, no default shortcut; grows or shrinks the existing text selection (see below)
CmdExtendSelectionWordRight Extend Selection One Word Right
ver 3.7+, no default shortcut; grows or shrinks the existing text selection (see below)
CmdCopyComment Copy Comment
CmdShowAnnotationText Show Comment
opens a read-only card with the annotation's whole text; also on a left click on the annotation, ver 3.7+
CmdCopyImage Copy Image
CmdCopyLinkTarget Copy Link Target
CmdCopySelection Ctrl + C, Ctrl + Insert Copy Selection
in Edit PDF mode with an annotation selected, copies that annotation instead of text
CmdCopySelectionAsImage Copy Selection As Image
copy a rectangular selection as an image, ver 3.7+
CmdSaveSelectionAsImage Save As Image...
save a rectangular (Ctrl+drag) selection as PNG, JPEG or BMP at a chosen DPI, independent of the current zoom, ver 3.7+ (fixes #6127)
CmdSearchGoogleLens Search with Google Lens
opens the selection, image under the cursor, or current page in Google Lens, ver 3.7+
CmdSearchGoogleLensPage Search Page with Google Lens
current page (or the page under the cursor from the context menu), ver 3.7+
CmdSearchGoogleLensImage Search Image with Google Lens
image under the cursor, ver 3.7+
CmdCopyFilePath Copy File Path
ver 3.5+
CmdDeleteFile Delete Currently Opened File
ver 3.6+
CmdDeleteFileAndOpenNext Delete File And Open Next
moves the current file to the Recycle Bin after the next file opens successfully, ver 3.7+
CmdShowGeneratedHTML Show Generated HTML
available for Markdown files; saves the generated HTML to a temporary .html file and opens it in Notepad, ver 3.7+
Command IDs Keyboard shortcuts Command Palette
CmdFindFirst Ctrl + F Find
CmdFindToggleMatchCase Find: Toggle Match Case
CmdFindToggleMatchWholeWord Find: Toggle Match Whole Word
CmdFindNext F3 Find Next
CmdFindNextSel Ctrl + F3 Find Next Selection
CmdFindPrev Shift + F3 Find Previous
CmdFindPrevSel Shift + Ctrl + F3 Find Previous Selection

Viewing #

Command IDs Keyboard shortcuts Command Palette
CmdBookView Ctrl + 8, Ctrl + Numpad 8 Book View
CmdFacingView Ctrl + 7, Ctrl + Numpad 7 Facing View
CmdInvertColors Shift + I Invert Colors
was `i` before 3.6
CmdRotateLeft [, Shift + Ctrl + Subtract Rotate Left
CmdRotateRight ], Shift + Ctrl + Add Rotate Right
CmdSinglePageView Ctrl + 6, Ctrl + Numpad 6 Single Page View
CmdToggleContinuousView c Toggle Continuous View
CmdSelectTextViaKeyboard F7 Select Text With Keyboard
ver 3.7+, caret browsing: puts a text caret in the page which the arrow keys move; Shift + arrows extend the selection, v toggles visual mode (arrows select without Shift), Home/End go to the line ends, Ctrl + Home/End to the document ends, Ctrl + arrows move by word, Ctrl + C or y copies, Esc or F7 leaves the mode. Not available for documents with no extractable text (fixes #4684, #4116)
CmdToggleKeyboardLinkFollowing Shift + F Follow Link With Keyboard
ver 3.7+, labels visible links with Vimium-style letter hints; type a hint to follow its link, Esc or Shift + F again leaves the mode. Multi-letter hints are used when needed. Not available for comic books, image folders and images (fixes #2629)
CmdToggleFullscreen f, Shift + Ctrl + L, F11 Toggle Fullscreen
CmdToggleMangaMode Toggle Manga Mode
Right-to-left facing/book layout for fixed-page documents; before 3.7 this was limited to comic books
CmdToggleUniformPageWidth Toggle Uniform Page Width
At percentage zoom levels, scales every page to the width page 1 has at that zoom; remembered per document (fixes #5512)
CmdToggleTrimEmptyMargins Toggle Trim Empty Margins
Trims empty margins around page content from display on demand, ver 3.7+
CmdToggleMenuBar F9 Toggle Menu Bar
CmdTogglePageInfo i Show / Hide Current Page Number
was Shift + i before 3.6
CmdTogglePageBoxes Toggle Page Boxes
ver 3.7+, outlines the PDF MediaBox, CropBox, BleedBox, TrimBox and ArtBox on each page (only boxes that page actually has) and labels them. Palette and Debug menu. No default shortcut (fixes #814)
CmdChangeScrollbar Change Scrollbar
Opens dialog to choose scrollbar mode (windows/smart/overlay/hidden)
CmdChangeBackgroundColor Change Background Color
Opens color picker to change document background color
CmdChangeEbookSettings Change eBook Settings
ver 3.7+, opens a dialog for the font, size, line spacing and CSS of a reflowable document (EPUB, MOBI, FB2, ...), for that document only or for all ebooks. Not shown for fixed-page documents. See Customize-eBook-UI.md
CmdToggleToolbar F8 Toggle Toolbar
CmdAIChatWithClaudeCode AI Chat with document using Claude Code
Toggle Claude Code chat sidebar, ver 3.7+. See AI-Chat-with-document.md
CmdAIChatWithGrokBuild AI Chat with document using Grok Build
Toggle Grok Build chat sidebar, ver 3.7+. See AI-Chat-with-document.md#grok-build
CmdAIChatWithOpenAICodex AI Chat with document using OpenAI Codex
Toggle OpenAI Codex chat sidebar, ver 3.7+. See AI-Chat-with-document.md#openai-codex
CmdAIChatWithAntiGravity AI Chat with document using Antigravity
Toggle Antigravity chat sidebar, ver 3.7+. See AI-Chat-with-document.md#antigravity
CmdTranslateSelectionWithAntiGravity Translate Selection with Antigravity
Translate selected text with Antigravity CLI, ver 3.7+
CmdChangeTheme Change Theme...
ver 3.7+, opens a dialog to pick a UI theme (including **Follow Windows**, which automatically tracks Windows light/dark app mode) and optionally how document colors follow the theme (`DocumentColorsFollowTheme`)
CmdNavigateThumbnail Navigate Thumbnails
opens a thumbnail grid for the current document; arrow keys and the mouse select a page, Enter or double-click opens it, and Esc closes the grid
CmdToggleLightDarkTheme Toggle Light/Dark Theme
ver 3.7+, switches between the last used light and dark themes (see `LastLightTheme` / `LastDarkTheme` advanced settings)
CmdToggleEngineeringDrawingEnhance Toggle Engineering Drawing Enhancement
ver 3.7+, toggles CAD/engineering-drawing line enhancement for the current PDF (see [CAD / Engineering Drawings](CAD-Engineering-Drawings.md))
CmdSetDocumentColorsFollowTheme Set Document Colors Follow Theme
ver 3.7+, opens a dialog to pick how MuPDF-rendered documents follow the UI theme (`DocumentColorsFollowTheme`: off, smart, legacy)
CmdTogglePreservePdfImages Toggle Preserve PDF Image Colors in Dark Mode
ver 3.7+, session-only toggle of image preservation on inverted pages
CmdToggleLinks Toggle Show Links
Toggle drawing blue rectangle around links, ver 3.6+
CmdToggleHighlightFormFields Toggle Highlight Form Fields
ver 3.7+, toggles pale-blue highlight of empty fillable PDF form fields (`HighlightFormFields`; default on) (fixes #5966)
CmdToggleTransparencyGrid Toggle Transparency Grid
ver 3.7+, checkerboard under the page so transparent PDFs (white art on a hole) are visible, like Acrobat's Transparency Grid. Session-only, not saved (fixes #1809)
CmdTogglePageGrid Toggle Page Grid
ver 3.7+, dotted major/minor graph paper on PDF, EPUB, and other paginated document pages; not comics. Session-only visibility; spacing, origin, color and style are `FixedPageUI.PageGrid` (fixes #4398)
CmdConfigurePageGrid Configure Page Grid...
ver 3.7+, dialog to set page-grid units, spacing, subdivisions, origin, color and line style (dots / dotted / solid), like PDF-XChange Measurement. Reset to defaults restores the shipped appearance settings; Show Grid is the session toggle
CmdToggleDisableLinks Toggle Disable Links
ver 3.7+, palette-only; toggles `DisableLinks` so clicks, hover and keyboard following ignore document links (fixes #5939)
CmdToggleHoverPreview Toggle Citation Hover Preview
ver 3.7+, palette-only; toggles the citation/reference hover popup (`CitationHoverDelay`: 300 ms when on, -1 when off)

Tabs #

Command IDs Keyboard shortcuts Command Palette
CmdCloseAllTabs Close All Tabs
ver 3.6+
CmdCloseTabsToTheLeft Close Tabs To The Left
ver 3.6+
CmdCloseTabsToTheRight Close Tabs To The Right
ver 3.6+
CmdCloseOtherTabs Close Other Tabs
ver 3.6+
CmdNextTab Ctrl + PageUp Next Tab
CmdPrevTab Ctrl + PageDown Previous Tab
CmdMoveTabRight Ctrl + Shift + PageUp Move Tab Right
ver 3.6+
CmdMoveTabLeft Ctrl + Shift + PageDown Move Tab Left
ver 3.6+
CmdNextTabSmart Ctrl + Tab Smart tab Switch
ver 3.6+
CmdPrevTabSmart Ctrl + Shift + Tab Smart tab Switch
ver 3.6+
CmdTabGroupSave Save Tab Group
ver 3.7+
CmdTabGroupRestore Restore Tab Group
ver 3.7+
Command IDs Keyboard shortcuts Command Palette
CmdScrollUp k, Up Scroll Up
CmdScrollDown j, Down Scroll Down
CmdScrollLeft h, Left Scroll Left
CmdScrollRight l, Right Scroll Right
CmdScrollUpHalfPage Shift + Up Scroll Up By Half Page
CmdScrollDownHalfPage Shift + Down Scroll Down By Half Page
CmdStartAutoScroll Start Auto-Scroll
Start (or stop) middle-click-style auto-scroll anchored at the cursor, without needing a middle mouse button; move the cursor away from the anchor to scroll. Invoke again (or middle-click) to stop, ver 3.7+
CmdScrollUpPage Ctrl + Up, PageUp, Shift + Return, Shift + Space Scroll Up By Page
CmdScrollDownPage Ctrl + Down, PageDown, Return, Space Scroll Down By Page
CmdScrollLeftPage Shift + Left Scroll Left By Page
CmdScrollRightPage Shift + Right Scroll Right By Page
CmdGoToFirstPage Ctrl + Home, Home First Page
CmdGoToLastPage Ctrl + End, End Last Page
CmdGoToPrevPage p Previous Page
CmdGoToNextPage n Next Page
CmdGoToPage g, Ctrl + G Go to Page...
CmdNavigateBack Alt + Left, Backspace Navigate Back
CmdNavigateForward Alt + Right, Shift + Backspace Navigate Forward

Favorites #

Command IDs Keyboard shortcuts Command Palette
CmdFavoriteAdd Ctrl + B Add Favorite
CmdFavoriteDel Delete Favorite
CmdFavoriteToggle Toggle Favorites
CmdFavoriteShowInTab Show Favorites in Tab
Full-window Favorites tab (independent of sidebar), ver 3.7+
CmdToggleFavoritesSort Sort Favorites By Name
Toggle alphabetical order within each file (also Favorites tree context menu checkbox); maps to `SortFavoritesByName`, ver 3.7+
CmdGoToNextFavorite Go to Next Favorite
CmdGoToPrevFavorite Go to Previous Favorite

Presentation #

Command IDs Keyboard shortcuts Command Palette
CmdTogglePresentationMode Ctrl + L, Shift + F11, F5 View: Presentation Mode
CmdPresentationBlackBackground . Presentation Black Background
CmdPresentationWhiteBackground w Presentation White Background
CmdToggleLaserPointer Toggle Laser Pointer
ver 3.7+, replaces the mouse cursor over the document with a glowing red laser dot for pointing things out. No default shortcut, assign your own. Stays visible in presentation mode (the cursor doesn't auto-hide while it's on)

Annotations #

Command IDs Keyboard shortcuts Command Palette
CmdInsertImage Insert Image...
Pick an image and stamp it onto the current page as a stamp annotation - a signature, say (fixes #1744), ver 3.7+
CmdCreateAnnotCaret Create Caret Annotation
CmdCreateAnnotCircle Create Circle Annotation
CmdFindAnnotation Find Annotation
opens the floating annotation list, where you can filter the document's annotations and jump to one, ver 3.7+
CmdCreateAnnotFileAttachment Create File Attachment Annotation
click to place, like Stamp/Caret; Esc cancels, ver 3.7+
CmdCreateAnnotFreeText Create Free Text Annotation
CmdCreateAnnotHighlight a, A Create Highlight Annotation
CmdAnnotationHighlightBrush Highlight with Brush
a freehand highlighter: drag to paint a marker stroke anywhere on the page, no text selection needed. Release finishes, Esc cancels. Saved as an ink annotation in HighlightColor, ver 3.7+
CmdCreateAnnotInk Create Ink Annotation
drag to paint; release commits the stroke and leaves the tool on. Esc or closing the hint leaves the tool, ver 3.7+
CmdCreateAnnotLine Create Line Annotation
CmdCreateAnnotLink Create Link Annotation
CmdCreateAnnotPolygon Create Polygon Annotation
CmdCreateAnnotPolyLine Create Poly Line Annotation
CmdCreateAnnotPopup Create Popup Annotation
CmdCreateAnnotRedact Create Redact Annotation
marks selected text, or a dragged rectangle, for removal; content is not deleted until Apply Redactions, ver 3.7+
CmdApplyRedactions Apply Redactions
permanently deletes content marked with the Redact tool, after a confirmation; save a copy afterwards, ver 3.7+
CmdCreateAnnotSquare Create Square Annotation
CmdCreateAnnotSquiggly Create Squiggly Annotation
CmdCreateAnnotStamp Create Stamp Annotation
CmdCreateAnnotImageFromClipboard Create Image Annotation From Clipboard
CmdCreateAnnotStrikeOut Create Strike Out Annotation
CmdCreateAnnotText Create Text Annotation
CmdCreateAnnotUnderline u, U Create Underline Annotation
CmdUndo Ctrl + Z Undo
ver 3.7+, takes back the last change to the PDF (annotations, form fields, applied redactions). One gesture is one step: creating, pasting or resizing an annotation comes back in a single Undo. Disabled when there is nothing to undo; in a text box Ctrl + Z is the text box's undo
CmdRedo Shift + Ctrl + Z Redo
ver 3.7+, re-applies the change Undo took back. Disabled when there is nothing to redo
CmdCutAnnotation Ctrl + X Cut Annotation
ver 3.7+, copies the annotation under the cursor (or the selected one) and deletes it when the copy is pasted; in a text box Ctrl + X is the text box's cut
CmdCopyAnnotation Ctrl + C Copy Annotation
ver 3.7+, copies the selected annotation in Edit PDF mode; Ctrl + C is CmdCopySelection and copies the annotation when one is selected. Only annotations that can be moved can be copied, so text markup (highlight, underline, squiggly, strike-out) and file attachments are excluded
CmdPasteAnnotation Ctrl + V Paste Annotation
ver 3.7+, pastes the copied annotation with its top-left at the mouse and deletes the original if it was cut; Ctrl + V is CmdPasteClipboardImage and pastes the annotation when Edit PDF is on and one has been copied
CmdDeleteAnnotation Delete Delete Annotation
CmdSaveAnnotations Shift + Ctrl + S Save Annotations to existing PDF
CmdSaveAnnotationsNewFile Save Annotations to new PDF
ver 3.6+
CmdSignDocument Sign Document...
digitally sign a PDF with a certificate from the Windows store or a .pfx / .p12 file; choose which name/date/labels to draw and optionally a PNG/JPEG; a new signature is placed by clicking or dragging on the page, ver 3.7+
CmdDiscardChanges Discard Changes
reloads the document from disk, discarding unsaved annotations and form changes; also on the tab context menu when there are unsaved changes, ver 3.7+ (renamed from `CmdDiscardAnnotations`)
CmdShowAnnotations Show Annotations
ver 3.6+, for current document
CmdHideAnnotations Hide Annotations
ver 3.6+, for current document
CmdToggleShowAnnotations Toggle Showing Annotations
ver 3.6+, for current document
CmdToggleEditPDF Toggle Edit PDF
shows or hides Edit PDF mode (the annotation-tools row), ver 3.7+ (renamed from `CmdTogglePdfAnnotationsToolbar`)

Zoom #

Command IDs Keyboard shortcuts Command Palette
CmdToggleZoom z Toggle Zoom
CmdZoomActualSize Ctrl + 1, Ctrl + Numpad 1 Zoom: Actual Size
CmdZoomCustom Ctrl + Y Zoom: Custom...
CmdZoomFitContent Ctrl + 3, Ctrl + Numpad 3 Zoom: Fit Content
CmdZoomToSelection Ctrl + 4, Ctrl + Numpad 4 Zoom: To Selection
ver 3.7+, zooms so the current selection (Ctrl + drag rectangle or selected text) fills the window and centers it; the selection is kept so it can still be copied, and Navigate Back (Alt + Left) returns to the view it was zoomed from. Also in the Zoom menu and the right-click menu (fixes #1699)
CmdZoomShrinkToFit Zoom: Shrink To Fit
Shows at 100% if page is smaller than view area, otherwise fits page
CmdZoomFitPage Ctrl + 0, Ctrl + Numpad 0 Zoom: Fit Page
CmdZoomFitPageAndSinglePage Zoom: Fit Page and Single Page
CmdZoomFitWidth Ctrl + 2, Ctrl + Numpad 2 Zoom: Fit Width
CmdZoomFitHeight Zoom: Fit Height
Scale so the page fills the window height (may scroll horizontally); useful for landscape pages on portrait screens (fixes #1714), ver 3.7+
CmdZoomFitByOrientation Zoom: Fit Page or Width by Orientation
Fit width when the view is wider than tall (landscape), fit page otherwise (portrait); re-evaluated as the window/screen is resized or rotated
CmdZoomFitWidthAndContinuous Zoom: Fit Width And Continuous
CmdZoomIn Ctrl + Add Zoom In
CmdZoomOut Ctrl + Subtract Zoom Out
CmdZoom100 Zoom: 100%
CmdZoom12_5 Zoom: 12.5%
CmdZoom125 Zoom: 125%
CmdZoom150 Zoom: 150%
CmdZoom1600 Zoom: 1600%
CmdZoom200 Zoom: 200%
CmdZoom25 Zoom: 25%
CmdZoom3200 Zoom: 3200%
CmdZoom400 Zoom: 400%
CmdZoom50 Zoom: 50%
CmdZoom6400 Zoom: 6400%
CmdZoom8_33 Zoom: 8.33%
CmdZoom800 Zoom: 800%

File information / conversion #

Command IDs Keyboard shortcuts Command Palette
CmdPdShowInfo Show PDF Info
shows information about currently opened PDF file
CmdDocumentShowOutline Show Document Outline
shows the outline (table of contents) of currently opened document
CmdPdfBake Bake PDF File
bakes interactive form and annotation content into static graphics; saves to a new PDF file and opens it
CmdDocumentExtractText Extract Text From Document
extract text from document pages to a .txt file, with configurable page ranges, ver 3.7+

External app #

Command IDs Keyboard shortcuts Command Palette
CmdOpenWithExplorer Open Directory In Explorer
ver 3.5+
CmdOpenWithDirectoryOpus Open Directory In Directory Opus
ver 3.5+
CmdOpenWithTotalCommander Open Directory In Total Commander
ver 3.5+
CmdOpenWithDoubleCommander Open Directory In Double Commander
ver 3.5+
CmdOpenWithAcrobat Open in Adobe Acrobat
CmdOpenWithFoxIt Open in Foxit Reader
CmdOpenWithFoxItPhantom Open in Foxit Phantom
CmdOpenWithHtmlHelp Open in Microsoft HTML Help
CmdOpenWithPdfDjvuBookmarker Open in Pdf&Djvu Bookmarker
CmdOpenWithPdfXchange Open in PDF-XChange
CmdOpenWithXpsViewer Open in Microsoft Xps Viewer
CmdTranslateSelection Translate Selection...
ver 3.7+, opens a dialog to translate the selected text (edit text, pick languages and engine); used from the selection context menu and command palette
CmdTranslateSelectionWithDeepL Translate Selection With DeepL
CmdTranslateSelectionWithGoogle Translate Selection with Google
CmdTranslateSelectionWithGrokBuild Translate Selection with Grok Build
ver 3.7+, requires the Grok Build CLI
CmdTranslateSelectionWithClaudeCode Translate Selection with Claude Code
ver 3.7+, requires the Claude Code CLI
CmdTranslateSelectionWithOpenAICodex Translate Selection with OpenAI Codex
ver 3.7+, requires the OpenAI Codex CLI
CmdSearchSelectionWithBing Search Selection with Bing
CmdSearchSelectionWithGoogle Search Selection with Google
CmdSearchSelectionWithWikipedia Search Selection with Wikipedia
ver 3.6+
CmdSearchSelectionWithGoogleScholar Search Selection with Google Scholar
ver 3.6+
CmdSendByEmail Send Document By Email...
CmdInvokeInverseSearch Invoke Inverse Search
ver 3.6+

System #

Command IDs Keyboard shortcuts Command Palette
CmdAdvancedOptions Advanced Options...
Opens the settings file in a text editor
CmdAdvancedSettings Advanced Settings...
ver 3.7+, opens a dialog for viewing and editing the advanced settings: filter by name, click a setting to toggle / pick / edit its value, then Save
CmdChangeLanguage Change Language...
CmdCheckUpdate Check For Updates
CmdClearHistory Clear History
Clears history of opened files (for recently opened list in home page)
CmdRemoveDeletedFilesFromHistory Remove Deleted Files From History
ver 3.7+, removes from history entries for files that no longer exist on disk
CmdDeleteCachedFiles Delete Cached Files
ver 3.7+, deletes local copies of comic book archives cached under cbx-cache when opened from a network drive
CmdContributeTranslation Contribute Translation
CmdForgetSelectedDocument Remove Selected Document From History
CmdListPrinters List Printers
ver 3.7+
CmdOptions Options...
CmdSetInverseSearch Set Inverse Search Command Line
ver 3.7+, opens a dialog to set the SyncTeX inverse-search command and enables TeX enhancements
CmdScreenshot Take Screenshot
ver 3.7+, can be registered as a global hotkey via Shortcuts entry (e.g. Key = Global PrtSc) or through the Settings menu
CmdCropImage Crop Image
ver 3.7+
CmdResizeImage Resize Image
ver 3.7+
CmdSaveImage Save Image
Save image from context menu, ver 3.7+
CmdConvertImageToPdf Convert Page To PDF
Save the image under the cursor (or the current image document page) as a new PDF via the image editor, ver 3.7+
CmdConvertToPDF Convert To PDF
Convert a comic book, image folder, or single image to a multi-page PDF (dialog picks a unique .pdf path), ver 3.7+ (fixes #4118, #5532). Docs: Convert-to-PDF.md
CmdConvertPdfToImages Convert PDF to Images...
Render PDF pages to PNG, JPEG or BMP (format drop-down updates the extension). Destination path is a template: is replaced by the page number. Pages: current, all, or a custom range. PNGs are optimized in the background, ver 3.7+ (fixes #5991). Docs: Convert-PDF-to-images.md
CmdPasteClipboardImage Ctrl + V Paste Image From Clipboard
Paste image from clipboard and open it, ver 3.7+. In Edit PDF mode, pastes a copied annotation at the mouse instead
CmdShowErrors Show Errors
Show mupdf warnings/errors in right-click context menu, ver 3.7+
CmdShowLog Show Logs

Help #

Command IDs Keyboard shortcuts Command Palette
CmdHelpOpenManual F1 Help: Manual
CmdHelpOpenKeyboardShortcuts Help: Keyboard Shortcuts
CmdToggleKeyboardHelp ? Show Keyboard Shortcuts
Overlay listing the most useful commands by section, each row showing the key it is currently bound to. Press again (or Esc) to close it, ver 3.7+
CmdHelpAbout Help: About SumatraPDF
CmdHelpOpenManualOnWebsite Help: Manual On Website
CmdHelpVisitWebsite Help: SumatraPDF Website

Misc #

Command IDs Keyboard shortcuts Command Palette
CmdToggleInverseSearch Toggle Inverse Search
temporarily disable TeX inverse search on left mouse click, ver 3.6+
CmdToggleWindowsPreviewer Register / Un-register Windows Previewer
Only available when SumatraPDF is installed. Registers or un-registers the PDF preview handler for Windows Explorer preview pane, ver 3.7+
CmdToggleWindowsSearchFilter Register / Un-register Windows Search Filter
Only available when SumatraPDF is installed. Registers or un-registers the PDF search filter for Windows Search indexing, ver 3.7+
CmdSetTabColor Set Tab Color
Set a custom color for the tab of the current document, available from tab context menu, ver 3.7+
CmdPdfCompress Compress PDF
Compress a PDF file using aggressive garbage collection and optimization, ver 3.7+
CmdPdfDecompress Decompress PDF
Decompress a PDF file for easier inspection, ver 3.7+
CmdPdfDeletePages Delete Pages From PDF
Delete pages from a PDF file using page ranges like 1,3-8,13-N where N is the last page, ver 3.7+
CmdPdfExtractPages Extract Pages From PDF
Extract pages from a PDF file using page ranges like 1,3-8,13-N where N is the last page, ver 3.7+
CmdPdfEncrypt Encrypt PDF
Encrypt a PDF file with a password using AES-256 encryption, ver 3.7+
CmdPdfDecrypt Decrypt PDF
Decrypt an encrypted PDF file, removing password protection, ver 3.7+
CmdSetScreenshotHotkey Set Screenshot Hotkey
Open dialog to set or remove a global hotkey for taking screenshots, ver 3.7+
CmdReadAloud Read Aloud
Read selected text (or from the viewport if no selection) through the end of the document using Windows text-to-speech. Invoking again pauses reading. Voice is chosen in the Read Aloud Voice submenu and remembered in ReadAloudVoiceId, ver 3.7+
CmdPauseReadAloud Pause Reading
Pause reading text aloud; resume with CmdContinueReadAloud, ver 3.7+
CmdContinueReadAloud Continue Reading
Continue reading text aloud from where it was paused, ver 3.7+
CmdStopReadAloud Stop Reading
Stop reading text aloud and clear the resume position. Always in the Read Aloud menu (disabled when nothing is being read) and in the command palette while a session is active, even when the playback bar is not visible, ver 3.7+
CmdReadAloudFromTopPage Start Reading From Top
Read from the first visible text in the viewport through the end of the document, ver 3.7+
CmdReadAloudSelection Start Reading Selection
Read the current text selection aloud, ver 3.7+
CmdToggleToolbarShowReadAloud Read Aloud: Show In Toolbar
Show or hide the Read Aloud buttons in the toolbar; remembered in the `ToolbarShowReadAloud` setting, ver 3.7+

Debug #

Command IDs Keyboard shortcuts Command Palette
CmdDebugCrashMe Debug: Crash Me
CmdDebugDownloadSymbols Debug: Download Symbols
CmdDebugShowNotif Debug: Show Notification
CmdDebugStartStressTest Debug: Start Stress Test
CmdDebugTestApp Debug: Test App
CmdDebugTogglePredictiveRender Debug: Toggle Predictive Rendering
CmdDebugToggleRenderInfo Debug: Toggle Render Queue Info
CmdDebugToggleCacheInfo Debug: Toggle Cache Info
CmdDebugToggleRtl Debug: Toggle Rtl
CmdToggleImages Toggle Show Images
Outline the images on the page, like the link outlines. A debug aid: it lasts for the session and is not saved in the settings, ver 3.7+
CmdDebugShowFitContentArea Debug: Show Fit Content Area
outlines in red the area Fit Content zoom would fit to (whole page if no content box was detected), without changing the zoom, ver 3.7+
CmdNone Do nothing

Deprecated or internal #

Command IDs Keyboard shortcuts Command Palette
CmdInstallPrereleaseUpdate internal
used by the pre-release update notification link (Update); not for user shortcuts or DDE
CmdTogglePdfPreviewLogging internal
toggles PDF shell-preview logging for debugging the Windows preview handler; not for normal use
CmdDebugCorruptMemory don't use
CmdOpenWithKnownExternalViewerFirst don't use
CmdOpenWithKnownExternalViewerLast don't use
CmdSelectionHandler use SelectionHandlers advanced setting instead
CmdSetTheme don't use
CmdViewWithExternalViewer don't use
CmdSaveAttachment don't use
CmdOpenAttachment don't use
CmdExec internal
runs an external program with optional filter; used internally (e.g. selection handlers), not for normal shortcuts or DDE
CmdDebugToggleDpiOverride internal
debug builds only: cycles a pretend DPI (125, 150, 75, off) to check how the UI reacts to a DPI change; does nothing in a release build
CmdFindMatch is an old name for CmdFindToggleMatchCase. It is not a generated command ID, but SumatraPDF still accepts it in old shortcut settings for compatibility.
CmdTogglePdfAnnotationsToolbar is an old name for CmdToggleEditPDF. SumatraPDF still accepts it in old shortcut and ToolbarCustomLayout settings.

Commands with arguments #

Ver 3.6+: some commands accept arguments that provide more options when creating custom keyboard shortcuts.
For example:
Shortcuts [
    [
        Cmd = CmdCreateAnnotHighlight #00ff00
        Key = a
    ]
]
By default, a invokes CmdCreateAnnotHighlight with the default yellow color.
You can override the a shortcut to create a green (#00ff00) highlight annotation.
You can create multiple keyboard shortcuts for multiple colors.
Arguments can be strings, numbers, Booleans, or colors (#rrggbb or #aarrggbb format).
Arguments have names. For example, CmdCreateAnnotHighlight has a color argument of type color and an optional copytoclipboard Boolean argument.
The format for providing arguments is CmdCreateAnnotHighlight color: #fafafa copytoclipboard: true.
For Boolean arguments, using the name alone is the same as setting the value to true, i.e. copytoclipboard is the same as copytoclipboard: true.
For default arguments, you can skip the name. For example, color is the default CmdCreateAnnotHighlight argument, so CmdCreateAnnotHighlight #fafafa is the same as CmdCreateAnnotHighlight color: #fafafa.
You can combine those rules: CmdCreateAnnotHighlight #fafafa copytoclipboard is the same as CmdCreateAnnotHighlight color: #fafafa copytoclipboard: true.

CmdExtendSelectionCharLeft and other CmdExtendSelection* #

Ver 3.7+
CmdExtendSelectionCharLeft, CmdExtendSelectionCharRight, CmdExtendSelectionWordLeft, and CmdExtendSelectionWordRight move the free end of the current text selection by one character or one word, the way Shift + Left/Right and Ctrl + Shift + Left/Right do in a text editor. Moving toward the selection’s anchor shrinks it, moving away grows it, and the selection continues across page boundaries.
They have no default shortcut because the obvious keys are already taken (Ctrl + Shift + Left/Right navigate between files), so assign your own:
Shortcuts [
    [
        Cmd = CmdExtendSelectionWordRight
        Key = Ctrl + Shift + Right
    ]
    [
        Cmd = CmdExtendSelectionWordLeft
        Key = Ctrl + Shift + Left
    ]
]
The selection can come from anywhere: dragging with the mouse, double-clicking a word, pressing Ctrl + A, or using keyboard selection (F7). While F7 keyboard selection is active, these commands move the caret, so it stays at the end of the selection. Without a selection, they do nothing, and they’re not available for documents with no extractable text.

CmdScrollUp, CmdScrollDown #

Ver 3.6+
Arguments:
  • n : default, integer, how many lines to scroll up or down (default: 1)
Use case: if you want to speed up scrolling with the j and k keys, you can reassign them:
Shortcuts [
    [
        Cmd = CmdScrollDown 5
        Key = j
    ]
    [
        Cmd = CmdScrollUp n: 5
        Key = k
    ]
]

CmdGoToNextPage, CmdGoToPrevPage #

Ver 3.6+
Arguments:
  • n : default, integer, how many pages to advance by (default: 1)
Use case: if you want to go forward or back by more than one page.

CmdCreateAnnotHighlight and other CmdCreateAnnot* #

Arguments:
  • color : default, color
  • openedit : Boolean, false if not given. Opens the Contents editor on the property row after creating the annotation (the old annotations window is gone). Creating an annotation always turns on Edit PDF mode.
  • copytoclipboard : Boolean, false if not given. For highlight/underline/squiggly/strikeout annotations, copies the selection (the annotation’s text) to the clipboard. This used to be the default behavior for built-in keyboard shortcuts such as a, but now it has to be chosen explicitly.
  • setcontent : Boolean, false if not given. For highlight/underline/squiggly/strikeout annotations, sets the annotation’s content to the selection (the annotation’s text)
Use cases:
  • change default color for annotations
  • create multiple shortcuts for different colors
Example: change a to create a green highlight annotation:
Shortcuts [
    [
        Cmd = CmdCreateAnnotHighlight #00ff00
        Key = a
    ]
]

Other CmdCreateAnnot* arguments #

Ver 3.6+
Arguments for CmdCreateAnnotHighlight plus:
  • color : default, color of text and border, black if not given
  • bgcolor : background color of annotation, fully transparent if not given
  • textsize : size of annotation text, 12 if not given
  • borderwidth : border width, 1 if not given
  • alignment : ver 3.7+, how free text is aligned in its box: left, center, or right. Left if not given
  • opacity : opacity of annotation, 0 = fully transparent (i.e. invisible), 100 = fully opaque (default if not given)
  • interiorcolor : interior color for circle, square, etc. annotations, fully transparent if not given

CmdToggleBoolSetting #

Ver 3.7+
Arguments:
  • name : default, string — name of a boolean advanced setting (case-insensitive leaf name or dotted path, e.g. Fullscreen.ShowMenubar)
Toggles that setting between true and false. Useful for custom shortcuts or toolbar buttons. Unknown setting names show a warning when the shortcut is defined and when the command runs.
Without a name argument, the Command Palette lists every non-internal boolean setting (= prefix). Enter or a click toggles the selected setting and closes the palette.
Example: toggle fullscreen menubar with t:
Shortcuts [
	[
		Cmd = CmdToggleBoolSetting Fullscreen.ShowMenubar
		Key = t
		Name = Toggle Fullscreen Menubar
	]
]
Add ToolbarText to the same entry to also get a toolbar button for it. Example: turn the reading mode of MouseWheelTurnsPage on and off with w or from the toolbar:
Shortcuts [
	[
		Cmd = CmdToggleBoolSetting MouseWheelTurnsPage
		Key = w
		Name = Wheel Turns Page
		ToolbarText = Wheel Turns Page
	]
]
The same works for any other boolean advanced setting, e.g. CmdToggleBoolSetting RememberViewOffsetOnPageTurn or CmdToggleBoolSetting ClickEdgeToTurnPage.

CmdZoomCustom #

Ver 3.6+
Arguments:
  • level : default, string or integer, zoom level
level can be:
  • a number describing the zoom level as a percentage, e.g.:
    • 50 or 50% means 50% zoom
    • 125 means 125% zoom
  • a virtual zoom level:
    • actual size (100% zoom level)
    • fit page
    • fit width
    • fit content
Example:
Shortcuts [
    [
        Cmd = CmdZoomCustom 50%
        Key = z
    ]
]

CmdCommandPalette #

Ver 3.6+
Argument:
  • mode : default, optional string. Values:
    • @ for open files (tabs)
    • # for history of files
    • > for commands
    • & for page thumbnails
    • % for table of contents (CmdCommandPaletteTOC, Shift + F12)
    • $ for favorites (CmdCommandPaletteFavorites)
    • * for annotations in the current PDF
    • = for boolean advanced settings (CmdToggleBoolSetting)
Without an argument it defaults to >.
To bind a keyboard shortcut to a palette mode, prefer the dedicated commands (CmdCommandPaletteTOC, CmdCommandPaletteFavorites) over CmdCommandPalette with a mode argument. A literal $ in settings must be written as $$ (see customize keyboard shortcuts).
Example:
Shortcuts [
    [
        Cmd = CmdCommandPalette #
        Key = Ctrl + h
    ]
    [
        Cmd = CmdCommandPaletteFavorites
        Key = b
    ]
]

Toggle commands (force an on/off state) #

Ver 3.7+
These toggle commands accept an optional state boolean argument that forces an explicit state instead of flipping the current one. This is useful for automation (e.g. via DDE) where you want to set a known state rather than toggle blindly:
  • CmdToggleFullscreen
  • CmdTogglePresentationMode
  • CmdToggleToolbar
  • CmdToggleMenuBar
  • CmdToggleContinuousView
  • CmdToggleTableOfContents, CmdToggleBookmarks
  • CmdToggleDisableLinks
Arguments:
  • state : default, boolean. on/true/1/yes forces the feature on, off/false/0/no forces it off. If the document is already in the requested state, nothing happens. If omitted, the command toggles (the original behavior).
Examples (DDE):
[CmdToggleFullscreen on]
[CmdToggleToolbar off]
[CmdToggleContinuousView state: on]

Debugging #

If a custom shortcut defined in Shortcuts doesn’t work, it could be caused by an invalid command name or invalid command arguments.
We log information about unsuccessful shortcut parsing, so check the logs if things don’t work as expected.