SumatraPDF has many advanced settings to customize look and behavior.
To open advanced settings file:
  • menu Settings / Advanced options...
  • or with Command Palette: Ctrl + K, type adv to narrow down to command, press Enter to select Advanced Options... command
This opens a settings text file in default .txt editor. Make changes and save the file.
To reset to default settings, delete settings file. SumatraPDF will re-create it with default values.
Most settings take effect immediately after saving the settings file. Some settings (e.g. UseTabs) require closing and re-starting SumatraPDF.
Documentation for all settings is at https://www.sumatrapdfreader.org/settings/settings
Here are some things you can customize:
  • keyboard shortcuts
  • width of tab with Tab Width
  • window background color with FixedPageUI.BackgroundColor
  • color used to highlight text with FixedPageUI.SelectionColor
  • control scrollbar mode with FixedPageUI.Scrollbars (values: windows, smart, overlay, hidden)
Advanced settings file also stores the history and state of opened files so that we can e.g. re-open on the page

Settings #

Below is an explanation of what the different settings mean and what their default values are.
If you add or remove lines with square brackets, make sure to always add/remove square brackets in pairs! Else you risk losing all the data following them.
; default layout of pages. valid values: automatic, single page, facing, book
; view, continuous, continuous facing, continuous book view
DefaultDisplayMode = automatic

; default zoom. valid values: fit page, fit width, fit height, fit content or
; percent like 100%
DefaultZoom = fit page

; if true, JavaScript in PDF documents is disabled (e.g. form-field calculations
; won't run) (introduced in version 3.7)
DisableJavaScript = false

; if true, a PDF may load an image stored in a separate file referenced by name
; (an external image stream); the file must sit next to the PDF. Off by default
; for security (matches Acrobat) (introduced in version 3.7)
AllowExternalImages = false

; if true, show the SyncTeX inverse search command line in Settings -> Options,
; so a double-click in the document can jump to the matching line in a LaTeX
; editor
EnableTeXEnhancements = false

; if true, Esc key closes SumatraPDF
EscToExit = false

; if true, show the full path to the document in the title bar (introduced in
; version 3.0)
FullPathInTitle = false

; pattern used to launch the LaTeX editor when doing inverse search
InverseSearchCmdLine =

; if true, restoring a session delays loading each document until its tab is
; selected (introduced in version 3.6)
LazyLoading = false

; background color of the area around the document, traditionally yellow. Only
; applies to the Light theme; the default #80fff200 is a marker meaning "use the
; theme's color", so setting any other value also colorizes the toolbar and
; sidebars
MainWindowBackground = #80fff200

; if true, doesn't open Home tab
NoHomeTab = false

; if true, the home page lists documents by how often they've been opened (the
; pre-3.6 behavior); if false, the most recently opened come first
HomePageSortByFrequentlyRead = false

; valid values: thumbnails, list (introduced in version 3.7)
HomePageViewMode = thumbnails

; if true, a document will be reloaded automatically whenever it's changed
; (currently doesn't work for documents shown in the ebook UI) (introduced in
; version 2.5)
ReloadModifiedDocuments = true

; if true, remember which documents were opened and their display settings
RememberOpenedFiles = true

; if true, store display settings for each document separately (i.e. everything
; after UseDefaultState in FileStates)
RememberStatePerDocument = true

; if true and SessionData isn't empty, that session will be restored at startup
RestoreSession = true

; if true, open documents in the already running SumatraPDF instead of starting
; a new one
ReuseInstance = true

; if true, show the menu bar (F9 toggles it; the choice is remembered across
; sessions) (introduced in version 2.5)
ShowMenubar = true

; if true, show the menu bar when using tabs (useTabs = true) (introduced in
; version 3.7)
ShowMenubarWithTabs = false

; if true, show tips on the home page (introduced in version 3.7)
ShowTips = true

; up to 13 custom colors for the background color picker, separated by space
; (e.g. '#ff0000 #00ff00 #0000ff') (introduced in version 3.7)
CustomColors =

; legacy bool for toolbar; if Toolbar is empty, derived as show/hide (internal;
; use Toolbar instead)
ShowToolbar = true

; toolbar mode: show (pinned), hide (no toolbar), overlay (toolbar floats over
; the page, sized to its natural width and centered, only shown when the mouse
; is near it). if empty, derived from ShowToolbar (introduced in version 3.7)
Toolbar =

; where the toolbar is placed: top or bottom (applies to both show and overlay
; modes) (introduced in version 3.7)
ToolbarPosition = top

; if true, the find UI is a floating, movable window with a results list instead
; of the compact toolbar overlay (introduced in version 3.7)
SearchUIFloating = false

; if true, show the Favorites sidebar
ShowFavorites = false

; if true, favorites within each file are sorted alphabetically by name (or page
; label); if false (the default), they are sorted by page number (introduced in
; version 3.7)
SortFavoritesByName = false

; if true, show the table of contents (Bookmarks) sidebar when the document has
; one
ShowToc = true

; if true, draw a blue border around links in the document (introduced in
; version 3.6)
ShowLinks = false

; if true, draw a focus ring around the document when it has keyboard focus (Tab
; to the page area) (introduced in version 3.7)
ShowDocumentFocusIndicator = false

; if true, show a tip when hovering an annotation (e.g. "Highlight annotation.
; Ctrl+click to edit.") (introduced in version 3.7)
ShowAnnotationNotification = true

; if true, show page numbers (labels) right-aligned on bookmark /
; table-of-contents entries (introduced in version 3.7)
ShowTocPageNumbers = true

; if true, show a list of frequently read documents when no document is loaded
ShowStartPage = true

; width of the favorites / bookmarks sidebar in screen pixels, as last resized
; (0 means the default)
SidebarDx = 0

; scrollbar mode: windows (standard Windows scrollbar), smart (overlay scrollbar
; with auto-hide), overlay (always visible overlay scrollbar), hidden (no
; scrollbars) (introduced in version 3.7)
Scrollbars = windows

; if true, show a scrollbar in single page mode as well (introduced in version
; 3.6)
ScrollbarInSinglePage = false

; if true, smooth mouse-wheel scrolling (exponential chase of the target;
; continuous wheel input stays fluid) (introduced in version 3.6)
SmoothScroll = true

; if true, continuous view has extra scroll room after the last page so you can
; scroll the end of the document to the top of the window (introduced in version
; 3.7)
PaddingAfterLastPage = false

; how long an internal-document link has to be hovered, in milliseconds, before
; a popup rendering the destination region (citation entry, figure, footnote)
; appears. -1 (the default) disables the popup; set a positive value like 300 to
; enable it (introduced in version 3.7)
CitationHoverDelay = -1

; voice id for Read Aloud text-to-speech; empty or unset means system default.
; Voice ids match those used internally by the Read Aloud Voice menu (WinRT
; voice id or SAPI token id) (introduced in version 3.7)
ReadAloudVoiceId =

; playback speed multiplier for Read Aloud text-to-speech (0.5 .. 3.0), 1 is
; normal speed; can also be changed from the Read Aloud playback bar (introduced
; in version 3.7)
ReadAloudSpeed = 1

; if true, mouse wheel scrolling is faster when mouse is over a scrollbar
; (introduced in version 3.6)
FastScrollOverScrollbar = false

; if true, prevents the screen from turning off when in fullscreen or
; presentation mode
PreventSleepInFullscreen = true

; maximum width of a single tab, in pixels at 100% display scaling (at least 60)
TabWidth = 300

; valid themes: Light, Dark, Light Warm, Dark from 3.5, Charcoal, Solarized
; Light, Solarized Dark, Dracula, Nebula, Greeny, Choco, Purpy, One Dark,
; Monokai, Nord, GitHub Dark, Catppuccin Mocha, Tokyo Night, Gruvbox, Night Owl,
; Ayu, Palenight, System (introduced in version 3.5)
Theme = 

; the light theme the light/dark toggle and the System theme switch to
; (introduced in version 3.7)
LastLightTheme = 

; the dark theme the light/dark toggle and the System theme switch to
; (introduced in version 3.7)
LastDarkTheme = 

; how MuPDF-rendered documents (PDF, XPS, DjVu, EPUB, MOBI, FB2, CBZ, images,
; etc.) use UI / FixedPageUI colors for the page. Values: off (document's own
; colors; default); smart (recolor text and page background, keep photos/images
; as-is — best for dark reading); legacy (also recolor images; pre-3.7
; invert-style). Does not change menus/toolbars — use Theme for UI chrome.
; Settings / Theme and the CmdSetDocumentColorsFollowTheme command set all three
; values. Shift+I (Invert Colors) is separate: it swaps the page colors for the
; session whatever this is set to (introduced in version 3.7)
DocumentColorsFollowTheme = off

; if both the favorites and the bookmarks part of the sidebar are visible, this
; is the height of the bookmarks (table of contents) part, in screen pixels
TocDy = 0

; if true, the toolbar has a Read Aloud button (with a drop-down for voice,
; speed and what to read). Read Aloud is still reachable from the Read Aloud
; menu when this is false (introduced in version 3.7)
ToolbarShowReadAloud = false

; size of the toolbar icons in pixels at 100% display scaling (8-64); the
; toolbar itself is a few pixels taller (introduced in version 3.4)
ToolbarSize = 18

; font name for bookmarks and favorites tree views. automatic means Windows
; default
TreeFontName = automatic

; font size for bookmarks and favorites tree views, in pixels; 0 means the
; Windows default. Not scaled by the display scaling (introduced in version 3.3)
TreeFontSize = 0

; overrides the font size used for menus, toolbar and dialogs, in pixels; 0
; means the Windows default. Not scaled by the display scaling (introduced in
; version 3.6)
UIFontSize = 0

; if true, render MuPDF-based documents (PDF, XPS, DjVu, EPUB etc.) without
; anti-aliasing, giving sharper but jagged edges (introduced in version 3.6)
DisableAntiAlias = false

; CAD/engineering PDF line rendering: off, auto (enhance if a CAD drawing is
; detected) or on (introduced in version 3.7)
EngineeringDrawingEnhance = auto

; if true, disables auto-linking of URLs and email addresses found in PDF text
; (introduced in version 3.7)
DisableAutoLinks = false

; if true, use the Windows system colors for the document background and text.
; Overrides other color settings
UseSysColors = false

; if true, documents are opened in tabs instead of new windows (introduced in
; version 3.0)
UseTabs = true

; if true, a small floating toolbar with selection actions (copy, read aloud,
; highlight etc.) pops up after selecting text. Set to false to disable it
; (introduced in version 3.7)
SelectionToolbar = true

; if true, Ctrl+Tab and Ctrl+Shift+Tab show the tab switcher in most recently
; used order instead of tab-strip order (introduced in version 3.7)
TabsMru = false

; sequence of zoom levels when zooming in/out; all values must lie between 8.33
; and 6400
ZoomLevels = 

; how much a single zoom in / zoom out step changes the zoom, as a percentage of
; the current zoom level. If 0 or negative, zooming steps through ZoomLevels
; instead
ZoomIncrement = 0

; customization options for PDF, XPS, DjVu and PostScript UI
FixedPageUI [
    ; color used instead of black for the document's text
    TextColor = #000000

    ; color used instead of white for the document's page background
    BackgroundColor = #ffffff

    ; color value for the text selection rectangle (also used to highlight found
    ; text). Use an #aarrggbb value to control opacity: a smaller alpha (e.g.
    ; #40ffff00) makes the selection more transparent so the selected text stays
    ; crisp; #rrggbb uses the default opacity (introduced in version 2.4)
    SelectionColor = #ffff00

    ; top, right, bottom and left margin (in that order) between window and
    ; document
    WindowMargin = 2 4 2 4

    ; horizontal and vertical distance between two pages in facing and book view
    ; modes
    PageSpacing = 4 4

    ; experimental: instead of a single background color, fade through these
    ; colors from the top of the document to the bottom (stops are spread
    ; evenly, at most 3 colors). The shifting background is meant to give a
    ; subconscious sense of reading progress. Suggested values: #2828aa #28aa28
    ; #aa2828
    GradientColors =

    ; if given, sets the canvas background color for PDF files (introduced in
    ; version 3.7)
    WindowBgCol = 
]

; customization options for the ebook UI (EPUB, MOBI, FB2, PDB and plain text)
EBookUI [
    ; font size in points; 0 means the default (8.0)
    FontSize = 0

    ; width of the page the ebook is laid out into, in points (not screen
    ; pixels); 0 means the default (420)
    LayoutDx = 0

    ; height of the page the ebook is laid out into, in points (not screen
    ; pixels); 0 means the default (595)
    LayoutDy = 0

    ; if true, the CSS in the ebook is ignored and only CustomCSS applies
    IgnoreDocumentCSS = false

    ; additional CSS applied to ebooks; set IgnoreDocumentCSS = true if the
    ; document's own CSS overrides it
    CustomCSS =

    ; if given, sets the canvas background color for ebook documents (epub, mobi
    ; etc.) (introduced in version 3.7)
    WindowBgCol = 
]

; customization options for Comic Book UI
ComicBookUI [
    ; top, right, bottom and left margin (in that order) between window and
    ; document
    WindowMargin = 0 0 0 0

    ; horizontal and vertical distance between two pages in facing and book view
    ; modes
    PageSpacing = 4 4

    ; if true, default to displaying Comic Book files in manga mode (from right
    ; to left if showing 2 pages at a time)
    CbxMangaMode = false

    ; if given, sets the canvas background color for comic book files
    ; (introduced in version 3.7)
    WindowBgCol = 
]

; customization options for image files UI
ImageUI [
    ; if given, sets the canvas background color for image files (introduced in
    ; version 3.7)
    WindowBgCol = 

    ; default zoom for image files. valid values: fit page, fit width, fit
    ; height, fit content, shrink to fit or percent like 100% (introduced in
    ; version 3.7)
    DefaultZoom = shrink to fit
]

; customization options for CHM UI. If UseFixedPageUI is true, FixedPageUI
; settings apply instead
ChmUI [
    ; if true, the UI used for PDF documents will be used for CHM documents as
    ; well
    UseFixedPageUI = false
]

; customization options for Markdown UI. If UseFixedPageUI is true, MuPDF is
; used; otherwise WebView2 browser view is used when available
MarkdownUI [
    ; if true, use MuPDF (cmark-gfm) to render markdown; if false, use WebView2
    ; browser view when available
    UseFixedPageUI = false
]

; settings for the Claude Code chat sidebar (introduced in version 3.7)
ClaudeCode [
    ; Claude model alias for --model (e.g. sonnet, opus, haiku); uses opus if
    ; not in the model list
    Model = sonnet

    ; extra Claude model aliases for the dropdown, comma-separated; documented
    ; Claude Code aliases are always included
    Models = 

    ; Claude effort level: 0=Low, 1=Medium, 2=High, 3=Max
    Effort = 1

    ; if true, pass --dangerously-skip-permissions to Claude Code
    SkipPermissions = false

    ; background color of the Claude Code chat panel
    BgColor = #ffffff
]

; settings for the Grok Build chat sidebar (introduced in version 3.7)
GrokBuild [
    ; Grok model ID for --model (e.g. grok-4.5)
    Model = grok-4.5

    ; extra Grok model IDs for the dropdown, comma-separated; used in addition
    ; to models reported by Grok
    Models = 

    ; Grok effort level: 0=Low, 1=Medium, 2=High, 3=XHigh, 4=Max
    Effort = 1

    ; if true, pass --always-approve to Grok Build (auto-approve tool
    ; executions)
    AlwaysApprove = false

    ; background color of the Grok Build chat panel
    BgColor = #ffffff
]

; settings for the OpenAI Codex chat sidebar (introduced in version 3.7)
CodexBuild [
    ; Codex model ID for -m (e.g. gpt-5.5, gpt-5.4, o3)
    Model = gpt-5.5

    ; extra Codex model IDs for the dropdown, comma-separated; used in addition
    ; to models reported by Codex
    Models = 

    ; Codex sandbox mode: 0=read-only, 1=workspace-write, 2=danger-full-access
    Sandbox = 1

    ; if true, pass --dangerously-bypass-approvals-and-sandbox to Codex
    SkipSandbox = false

    ; background color of the OpenAI Codex chat panel
    BgColor = #ffffff
]

; width of the AI chat sidebar (0 = use default); shared by Claude Code, Grok
; Build, and OpenAI Codex (internal) (introduced in version 3.7)
AIChatSidebarDx = 0

; remembered destination language for selection translation; empty uses OS UI
; language (introduced in version 3.7)
TranslateToLang = 

; remembered source language for selection translation; empty means Auto
; (introduced in version 3.7)
TranslateFromLang = 

; remembered engine for Translate Selection: Google, DeepL, Grok Build, Claude
; Code or OpenAI Codex (introduced in version 3.7)
TranslateEngine = 

; default values for annotations in PDF documents (introduced in version 3.3)
Annotations [
    ; color of newly created highlight annotations
    HighlightColor = #ffff00

    ; color of newly created underline annotations
    UnderlineColor = #00ff00

    ; color of newly created squiggly underline annotations (introduced in
    ; version 3.5)
    SquigglyColor = #ff00ff

    ; color of newly created strike out annotations (introduced in version 3.5)
    StrikeOutColor = #ff0000

    ; text color of newly created free text annotations (introduced in version
    ; 3.5)
    FreeTextColor = 

    ; background color of newly created free text annotations (introduced in
    ; version 3.6)
    FreeTextBackgroundColor = 

    ; opacity of free text annotation in percent (0-100); 0 - fully transparent
    ; (invisible), 50 - half transparent, 100 - fully opaque (introduced in
    ; version 3.6)
    FreeTextOpacity = 100

    ; font size of free text annotations, in points (introduced in version 3.5)
    FreeTextSize = 12

    ; border width of free text annotations, in points (introduced in version
    ; 3.5)
    FreeTextBorderWidth = 1

    ; color of newly created text (sticky note) annotations
    TextIconColor = 

    ; icon shown for text (sticky note) annotations: comment, help, insert, key,
    ; new paragraph, note or paragraph. If not set, note is used
    TextIconType = 

    ; author recorded on newly created annotations. If not set, the Windows user
    ; name is used; set it to (none) to leave the author out entirely
    ; (introduced in version 3.4)
    DefaultAuthor = 
]

; list of additional external viewers for various file types. See docs for more information (https://www.sumatrapdfreader.org/docs/Customize-external-viewers)
ExternalViewers [
  [
    ; command line with which to call the external viewer, may contain %p for
    ; page number and "%1" for the file name (add quotation marks around paths
    ; containing spaces)
    CommandLine =

    ; name of the external viewer to be shown in the menu (implied by
    ; CommandLine if missing)
    Name =

    ; optional filter for which file types the menu item is to be shown;
    ; separate multiple entries using ';' and don't include any spaces (e.g.
    ; *.pdf;*.xps for all PDF and XPS documents)
    Filter =

    ; optional: keyboard shortcut e.g. Alt + 7 (introduced in version 3.6)
    Key =

    ; if given, shows in toolbar (introduced in version 3.7)
    ToolbarText =

    ; optional SVG icon for toolbar button; if both ToolbarSvgIcon and
    ; ToolbarText are set, the icon is used (introduced in version 3.7)
    ToolbarSvgIcon =
  ]
]

; customization options for how forward search results are shown (used from
; LaTeX editors)
ForwardSearch [
    ; if greater than 0, the forward search result is marked with a bar down the
    ; left side of the page instead of highlighting the matched text. The value
    ; is how far the bar sits from the left edge of the page, in document units
    HighlightOffset = 0

    ; width of that bar in document units (only used when HighlightOffset is
    ; greater than 0)
    HighlightWidth = 15

    ; color used for the forward search highlight
    HighlightColor = #6581ff

    ; if true, the highlight stays visible until the next mouse click instead of
    ; fading away after a few seconds
    HighlightPermanent = false
]

; these override the default settings in the Print dialog
PrinterDefaults [
    ; default value for scaling (shrink, fit, none)
    PrintScale = shrink

    ; default value for collate in the print dialog (default, collate,
    ; nocollate) (introduced in version 3.7)
    Collate = default
]

; options for fullscreen mode (introduced in version 3.7)
Fullscreen [
    ; legacy bool for fullscreen toolbar; if Fullscreen.Toolbar is empty,
    ; derived as show/hide (internal; use Fullscreen.Toolbar instead)
    ShowToolbar = false

    ; toolbar mode in fullscreen: show (pinned), hide (no toolbar), overlay
    ; (toolbar floats over the page, only shown when the mouse is near it). if
    ; empty, derived from Fullscreen.ShowToolbar (introduced in version 3.7)
    Toolbar =

    ; if true, show the menu bar in fullscreen mode
    ShowMenubar = false
]

; list of handlers for selected text, shown in context menu when text selection
; is active. See docs for more information (https://www.sumatrapdfreader.org/docs/Customize-search-translation-services)
SelectionHandlers [
  [
    ; url to invoke for the selection. ${selection} will be replaced with
    ; current selection and ${userlang} with language code for current UI (e.g.
    ; 'de' for German)
    URL =

    ; name shown in context menu
    Name =

    ; keyboard shortcut (introduced in version 3.6)
    Key =

    ; command line of a program to run instead of opening a URL. Use
    ; ${selectionfile} to pass the selection as a temporary utf-8 file, which
    ; has no length limit. If set, URL is ignored (introduced in version 3.7)
    Exe =

    ; how to send the selection. GET (default) puts it in the URL, which limits
    ; how much text fits. POST sends it in the request body with no length limit
    ; and shows the response. POST-VIA-BROWSER submits a form from your browser
    ; instead, so the service sees your normal browser session (cookies, logins)
    ; (introduced in version 3.7)
    Method = GET

    ; request body for POST / POST-VIA-BROWSER; the same ${selection},
    ; ${selectionjson} and ${userlang} substitutions apply. If unset, the body
    ; is the raw selection (introduced in version 3.7)
    Body =

    ; value of the Content-Type header for POST. Defaults to 'text/plain;
    ; charset=utf-8', which matches the default raw-selection body. Use
    ; 'application/json' or 'application/x-www-form-urlencoded' when Body is in
    ; that format. Ignored by POST-VIA-BROWSER, which always submits a form
    ; (introduced in version 3.7)
    ContentType =

    ; extra HTTP headers for POST, one per line as 'Name: value' (use \n to
    ; separate them in this file). Needed for services that authenticate with an
    ; api key, e.g. 'Authorization: Bearer sk-...'. Ignored by POST-VIA-BROWSER.
    ; Note that anything you put here is stored in plain text in this settings
    ; file (introduced in version 3.7)
    Headers =
  ]
]

; custom keyboard shortcuts
Shortcuts [
  [
    ; command to run, e.g. CmdOpenFile. See the list of commands (https://www.sumatrapdfreader.org/docs/Commands)
    Cmd = 

    ; keyboard shortcut (e.g. Ctrl-Alt-F)
    Key = 

    ; name shown in command palette (introduced in version 3.6)
    Name =

    ; if given, shows in toolbar (introduced in version 3.6)
    ToolbarText =

    ; optional SVG icon for toolbar button; if both ToolbarSvgIcon and
    ; ToolbarText are set, the icon is used (introduced in version 3.7)
    ToolbarSvgIcon =
  ]
]

; color themes (introduced in version 3.6)
Themes [
  [
    ; name of the theme, as shown in the Settings / Theme menu
    Name = 

    ; color of text in menus, toolbar, tabs and sidebars
    TextColor = 

    ; background color of the window around the document
    BackgroundColor = 

    ; background color of toolbar, tabs, sidebars and dialogs
    ControlBackgroundColor = 

    ; color of clickable links in the UI
    LinkColor = 

    ; color of disabled (grayed out) text; if empty, derived from the colors
    ; above (introduced in version 3.7)
    DisabledTextColor = 

    ; color of secondary / muted text like the page label; if empty, derived
    ; from the colors above (introduced in version 3.7)
    DarkerTextColor = 

    ; background color of a control the mouse is over; if empty, derived from
    ; the colors above (introduced in version 3.7)
    HotBackgroundColor = 

    ; color of control borders and separators; if empty, derived from the colors
    ; above (introduced in version 3.7)
    EdgeColor = 

    ; border color of a control the mouse is over; if empty, derived from the
    ; colors above (introduced in version 3.7)
    HotEdgeColor = 

    ; border color of a disabled control; if empty, derived from the colors
    ; above (introduced in version 3.7)
    DisabledEdgeColor = 

    ; background color of error messages; if empty, derived from the colors
    ; above (introduced in version 3.7)
    ErrorBackgroundColor = 

    ; background color of notification tips; if empty, derived from the colors
    ; above (introduced in version 3.7)
    NotificationBackgroundColor = 

    ; background color of a highlighted notification tip; if empty, derived from
    ; the colors above (introduced in version 3.7)
    NotificationHighlightColor = 

    ; text color of a highlighted notification tip; if empty, derived from the
    ; colors above (introduced in version 3.7)
    NotificationHighlightTextColor = 

    ; if true, apply the theme colors to Windows controls and window areas too
    ColorizeControls = false
  ]
]

; saved groups of tabs (introduced in version 3.7)
TabGroups [
  [
    ; name of the tab group, as shown when restoring it
    Name = 

    ; documents that belong to this tab group
    TabFiles [
      [
        ; path of the document
        Path = 
      ]
    ]
  ]
]

; actual resolution of the main screen in DPI, used to show documents at their
; physical size; if 0 or negative, the resolution reported by Windows is used
; (introduced in version 2.5)
CustomScreenDPI = 0

; a whitespace separated list of passwords to try when opening a password
; protected document (passwords containing spaces must be quoted) (introduced in
; version 2.4)
DefaultPasswords =

; ISO code (langs.html) of the current UI language
UiLanguage =

; SumatraPDF won't offer to update to this version again
VersionToSkip =

; default state of the window. 1 is normal, 2 is maximized, 3 is fullscreen, 4
; is minimized
WindowState = 1

; default position (x, y) and size (width, height) of the window
WindowPos = 0 0 0 0

; position/size of the floating find window (see SearchUIFloating)
SearchUIWindowPos = 0 0 0 0

; information about opened files (in most recently used order)
FileStates [
  [
    ; path of the document
    FilePath =

    ; pages of this document bookmarked in the Favorites menu
    Favorites [
      [
        ; name of this favorite as shown in the menu
        Name =

        ; number of the bookmarked page
        PageNo = 0

        ; label for this page (only present if logical and physical page numbers
        ; are not the same)
        PageLabel =

        ; session-only favorite; omitted when serializing array elements
        ; (introduced in version 3.7)
        IsTemporary = false
      ]
    ]

    ; if true, the document is "pinned" to the Frequently Read list, so that
    ; recently opened documents don't displace it
    IsPinned = false

    ; if true, the file is considered missing and won't be shown in any list
    IsMissing = false

    ; number of times this document has been opened recently
    OpenCount = 0

    ; data required to open a password protected document without having to ask
    ; for the password again
    DecryptionKey =

    ; if true, this document opens with the global defaults instead of the
    ; values below
    UseDefaultState = false

    ; layout of pages. valid values: automatic, single page, facing, book view,
    ; continuous, continuous facing, continuous book view
    DisplayMode = automatic

    ; how far this document has been scrolled (in x and y direction)
    ScrollPos = 0 0

    ; number of the last read page
    PageNo = 1

    ; zoom (in %) or one of those values: fit page, fit width, fit height, fit
    ; content
    Zoom = fit page

    ; how far pages have been rotated as a multiple of 90 degrees
    Rotation = 0

    ; state of the window. 1 is normal, 2 is maximized, 3 is fullscreen, 4 is
    ; minimized
    WindowState = 0

    ; default position (can be on any monitor)
    WindowPos = 0 0 0 0

    ; if true, show the table of contents (Bookmarks) sidebar when the document
    ; has one
    ShowToc = true

    ; width of the left sidebar (table of contents / favorites) in screen
    ; pixels, as last resized
    SidebarDx = 0

    ; if true, the document is displayed right-to-left in facing and book view
    ; modes (only used for comic book documents)
    DisplayR2L = false

    ; if given, overrides the background color for this document (introduced in
    ; version 3.7)
    BgCol = 

    ; if given, overrides the tab color for this document (introduced in version
    ; 3.7)
    TabCol = 

    ; data required to restore the last read page in the ebook UI
    ReparseIdx = 0

    ; data required to determine which parts of the table of contents have been
    ; expanded
    TocState =
  ]
]

; state of the last session, usage depends on RestoreSession (introduced in
; version 3.1)
SessionData [
  [
    ; data required for restoring the view state of a single tab
    TabStates [
      [
        ; path of the document
        FilePath =

        ; layout of pages in this tab. valid values: automatic, single page,
        ; facing, book view, continuous, continuous facing, continuous book view
        DisplayMode = automatic

        ; number of the last read page
        PageNo = 1

        ; zoom (in %) or one of those values: fit page, fit width, fit height,
        ; fit content
        Zoom = fit page

        ; how far pages have been rotated as a multiple of 90 degrees
        Rotation = 0

        ; how far this document has been scrolled (in x and y direction)
        ScrollPos = 0 0

        ; if true, the table of contents was shown when the document was closed
        ShowToc = true

        ; which table of contents items were expanded (see FileStates ->
        ; TocState)
        TocState =
      ]
    ]

    ; index of the currently selected tab (1-based)
    TabIndex = 1

    ; state of the window. 1 is normal, 2 is maximized, 3 is fullscreen, 4 is
    ; minimized
    WindowState = 0

    ; position of the window (can be on any monitor)
    WindowPos = 0 0 0 0

    ; width of the favorites / bookmarks sidebar in screen pixels (0 if it
    ; wasn't shown)
    SidebarDx = 0
  ]
]

; data required for reloading documents after an auto-update (introduced in
; version 3.0)
ReopenOnce =

; data required to determine when SumatraPDF last checked for updates
TimeOfLastUpdateCheck = 0 0

; value required to determine recency for the OpenCount value in FileStates
OpenCountWeek = 0

; position of the document properties window
PropWinPos = 0 0

; if true, check once a day whether an update is available
CheckForUpdates = true

Syntax for color values #

The syntax for colors is: #rrggbb or #aarrggbb.
The components are hex values (ranging from 00 to FF) and stand for:
  • aa : alpha (transparency). ff is fully transparent, 0 is not transparent, and 7f is 50% transparent
  • rr : red component
  • gg : green component
  • bb : blue component
For example #ff0000 means red color. #7fff0000 is half-transparent red. You can use Sphere to pick a color.