PayloadKit

BBEdit

com.barebones.bbedit

BBEdit settings

macOS

Configuration Keys (404)

Showing 404 of 404 keys

KeyTypeDescriptionDefaultRange
string—Default: —Range: —

Application Appearance

integerOffers you three choices to control BBEdit’s appearance.Default: 0Range: Use system appearance (0), Light (1), Dark (2)

Editor color scheme

stringAllows you to easily select any existing color scheme.Default: "BBEdit Light"Range: BBEdit Classic, BBEdit Dark, BBEdit Light, BBEdit Retro Dark, BBEdit Retro Light, Douce nuit 4, Dusk, Ponies, Seafoam, Toothpaste, Xcode Dark

Editor color scheme (dark mode)

stringAllows you to easily select any existing color scheme.Default: "BBEdit Dark"Range: BBEdit Classic, BBEdit Dark, BBEdit Light, BBEdit Retro Dark, BBEdit Retro Light, Douce nuit 4, Dusk, Ponies, Seafoam, Toothpaste, Xcode Dark

Status bar item size

integerControls whether the text and icons displayed in the navigation bar, the status bar, and in the sidebars of editing, project, and differences windows are of normal, large, or extra-large size.Default: 0Range: Normal (0), Large (1), Extra Large (2)

List display font size

realControls the size of the system font used to display text in browser list panes, including disk browsers, search results browsers, FTP/SFTP browsers, etc.Default: 11Range: 8, 9, 10, 11, 12, 13, 14, 15, 16, 17, 18, 19, 20, 21, 22, 23, 24

Application icon

integerAllows you to control which icon BBEdit presents in the Finder (if possible) and in the Dock (while the application is running).Default: 0Range: Default (0), Classic (1), Legacy (2), TextWrangler (3)

Navigation bar items: Text options

booleanDisplays the Text Options popover in the navigation bar.Default: trueRange: —

Navigation bar items: Sort items by name

booleanDisplays the Function popup menu in the navigation bar.Default: falseRange: —

Editing window: Line numbers

booleanDisplays line numbers along the left edge of the window.Default: trueRange: —

Editing window: Gutter

booleanDisplays the gutter.Default: trueRange: —

Editing window: Tab stops

booleanDisplays tab stops as vertical grid lines within the content area of text windows, using the tab width set in the Editor Defaults panel.Default: falseRange: —

Editing window: Page guide at

booleanDisplays the page guide.Default: trueRange: —

Editing window: Page guide at ## characters

integerDisplays the page guide at the specified character width.Default: 90Range: —

Editing window: Guide contrast

realAdjusts the contrast level of the page guide display region.Default: 4Range: 1 – 10

Text status bar items: Cursor position

booleanDisplays the current location (line and column) of the insertion point, or the endpoint of the current selection range in the status bar.Default: trueRange: —

Text status bar items: Language

booleanDisplays the Language popup menu in the status bar.Default: trueRange: —

Text status bar items: Text encoding

booleanDisplays the Text Encoding popup menu in the status bar.Default: trueRange: —

Text status bar items: Line break type

booleanDisplays the Line Break Type popup menu in the status bar.Default: trueRange: —

Text status bar items: Document lock state

booleanDisplays a padlock icon in the status bar to represent the document’s current lock state.Default: trueRange: —

Text status bar items: Document save date

booleanDisplays the current document’s last saved date and time (if applicable) in the status bar.Default: trueRange: —

Text status bar items: Document statistics

booleanDisplays an item in the status bar which shows the number of characters, words, and lines in the document.Default: trueRange: —

Text status bar items: Instances of selected text

booleanDisplays either the number of matches for the selected text within the document, or the word surrounding the insertion point if applicable.Default: trueRange: —

Text status bar items: Text magnification

booleanDisplays the Magnification popup in the status bar.Default: trueRange: —

Open documents into the front window when possible

booleanControls whether BBEdit should attempt to open newly created or opened documents into the frontmost window (if possible), or whether each document should open directly into a separate text window.Default: trueRange: —

Automatically refresh documents as they change on disk

booleanChecks if documents have changed on disk while they’re open.Default: trueRange: —

Remember the ## most recently used items

integerHow many files appear on the Open Recent sub-menuDefault: 15Range: —

Always show full paths in "Open Recent" menu

booleanAlways display full paths in the Open Recent menu.Default: falseRange: —

When BBEdit becomes active

integerControls what BBEdit does when you launch it, or activate it when there are no open windows.Default: 0Range: Do nothing (1), New text document (0)

Reopen documents that were open at last quit

booleanRemember what documents (as well as disk browsers and FTP/SFTP browsers) were open when you choose the “Quit” command, and will attempt to reopen those documents the next time you launch it.Default: trueRange: —

Restore unsaved changes

booleanWill preserve the contents of any unsaved document contents when you quit and restore those documents the next time you launch it.Default: trueRange: —

Include documents on FTP/SFTP servers

booleanAttempt to reopen documents from remote servers when you launch BBEdit.Default: trueRange: —

Always fetch fron server

booleanAlways reconnect and reload all files previously opened from remote servers.Default: falseRange: —

Automatically check for updates

booleanAutomatically looks to see if a newer version is available.Default: trueRange: —
booleanChecks for pre-release versions.Default: falseRange: —

Default model

stringThe default model BBEdit should use for ChatGPT.Default: "gpt-3.5-turbo"Range: gpt-3.5-turbo, gpt-3.5-turbo-16k, gpt-3.5-turbo-instruct, gpt-4, gpt-4-32k

Wrap lines in responses

boolean Responses should be wrapped.Default: trueRange: —

Wrap lines in responses to ## characters

integerSet the character width at which lines within responses should be wrapped.Default: 80Range: —

Show text completions

integerChoose when BBEdit will display text completions.Default: 1Range: After a delay in typing (1), Only manually (2)

Delay XX seconds before automatic completion

realChoose when BBEdit will display text completions.Default: 0.5Range: 0 – 5

Include dictionary words in completion list

booleanWill include dictionary words in the text completion list.Default: falseRange: —

Include system text replacements in completion list

booleanWill include any system-wide Text Replacement triggers (as configured in the “Keyboard” system preferences) which begin with the text you typed in the completion popup.Default: falseRange: —

Insert matching delimiters while typing

booleanTyping any opening delimiter will cause BBEdit to immediately insert the appropriate closing delimiter.Default: trueRange: —

Suround selected text when typing matching delimiters

booleanTyping an opening delimiter will cause BBEdit to surround the selected text with a matched pair of delimiters.Default: trueRange: —

Display instances of selected text

booleanWill display all occurrences of the selection within the current document.Default: trueRange: —
integerWill display all occurrences of the selection within the current document via either underlining or highlighting.Default: 0Range: Underline (0), Highlight (1)
realAdjust the duration of the delay before BBEdit applies highlighting.Default: 0.5Range: 0 – 5

Show tick marks in scroll bars: Instances of selected text

booleanShows tick marks for instances of selected text.Default: falseRange: —

Show tick marks in scroll bars: Live Search results

booleanShows tick marks for instances of Live Search results.Default: trueRange: —

Show tick marks in scroll bars: Spelling errors

booleanShows tick marks for instances of spelling errors.Default: trueRange: —

Show tick marks in scroll bars: Issues

booleanShows tick marks for instances of issues.Default: trueRange: —

Show issues

booleanWill display LSP-generated diagnostics when available.Default: trueRange: —

Highlight insertion point

booleanWill highlight the line that currently contains the insertion point.Default: trueRange: —

Use "hard" lines in soft-wrapped views

booleanThe line number bar, position display, and Line Number commands in editing views will use line and character position numbers that correspond to the “hard” line breaks actually present in the document, rather than the soft-wrapped line breaks.Default: trueRange: —

Insertion point

integerChoose your desired insertion point cursor style.Default: 0Range: Vertical bar (0), Block (1), Underscore (2)
realAdjust the amount of space between lines of text in editing views.Default: 1.1Range: 1 – 3

Extra vertical space ("overscroll") in text views

integerAllows you to specify how much empty space BBEdit should leave after the end of each document’s content.Default: 1Range: None (1), Half window (2), Full window (3)

Allow pinch-to-zoom to change magnification

booleanUse touchpad pinch gestures to increase or decrease the magnification level of the frontmost (active) document.Default: falseRange: —

Enable single-click line selection

booleanSelect lines by single-clicking on them in the line number bar or gutter.Default: trueRange: —

Cut/Copy entire line for insertion point

booleanThe Cut and Copy commands will act upon the entire line which contains the insertion point, in order to make life easier for Windows refugees.Default: falseRange: —

When opening a document: Collapse folds

booleanWill automatically collapse all folds.Default: falseRange: —

When opening a document: Collapse folds below level #

realSpecifies the level to collaps folds.Default: 2Range: 1 – —

Invisibles display: tabs

stringAllows you to specify alternative characters for tabs.Default: "∆"Range: —

Invisibles display: line breaks

stringAllows you to specify alternative characters for tabs.Default: "¬"Range: —

Default font

dataControls the standard font and font size which BBEdit uses to display the contents of text windows. This is in "data" format. To get the correct entry you will need to set the font in BBEdit first, then open the preference plist file in Xcode and copy the data string from the BBEditorFont key. Omit the <> from start and end of the string.Default: —Range: —

Override document setting

booleanWill cause the default font to always prevail over any previously saved font settings associated with a given text file.Default: trueRange: —

Spaces per tab

realControls the default number of spaces that BBEdit uses to represent the width of a tab character.Default: 4Range: 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16, 17, 18, 19, 20, 21, 22, 23, 24, 25, 26, 27, 28, 29, 30, 31, 32, 33, 34, 35, 36, 37, 38, 39, 40, 41, 42, 43, 44, 45, 46, 47, 48, 49, 50, 51, 52, 53, 54, 55, 56, 57, 58, 59, 60, 61, 62, 63, 64, 65, 66, 67, 68, 69, 70, 71, 72, 73, 74, 75, 76, 77, 78, 79, 80, 81, 82, 83, 84, 85, 86, 87, 88, 89, 90, 91, 92, 93, 94, 95, 96, 97, 98, 99

Magnification

integerSets the default magnification for new text documents.Default: 100Range: 800, 500, 400, 300, 200, 175, 150, 125, 100, 75, 50, 33, 25, 10

Auto-indent

booleanPressing the Return key in new windows automatically inserts spaces or tabs to indent the new line to the same level as the previous line.Default: trueRange: —

Balance while typing

booleanFlashes the matching open parenthesis, brace, bracket, or curly quote when you type a closing one.Default: trueRange: —

Use typographer's quotes

booleanWill automatically substitutes curly (or typographer’s) quotes (“ ” ‘ ’) for straight quotes (" ') in any new documents you create.Default: falseRange: —

Auto-expand tabs

booleanInserts an appropriate number of spaces instead of a tab character every time you press the Tab key.Default: falseRange: —

Show invisible characters

booleanShows or hides non-printing characters in the window.Default: falseRange: —

Show spaces

booleanWill display placeholder characters for spaces.Default: trueRange: —

Show tabs

booleanWill display placeholder characters for tabs.Default: trueRange: —

Show line breaks

booleanWill display placeholder characters for line breaks.Default: trueRange: —

Check spelling as you type

booleanWill automatically check spelling as you type, and underline any potentially misspelled words.Default: trueRange: —

Soft wrap text to

booleanSoft-wraps the text in the file to the right margin that you choose.Default: falseRange: —

Soft wrap text to: Page guide/Windows width/Character width

integerSoft-wraps the text in the file to the right margin that you choose.Default: 1Range: Page guide (1), Window width (2), Character width (3)

Soft wrap text to: Character width

integerSoft-wraps the text in the file to the right margin that you choose.Default: 80Range: —

Soft-wrapped line indentation

integerLets you specify how BBEdit should indent soft wrapped text.Default: 1Range: Flush left (1), First line (2), Reverse (3)

Use Tab key to navigate Placeholders

booleanWill jump to the next placeholder in the document (if any) when you press the Tab key, or the previous placeholder if you press Shift-Tab.Default: trueRange: —

"Home" and "End" key behavior

integerThis setting will have the Home and End keys perform these respective actions.Default: 1Range: Scroll to begining and end of document (1), Move cursor to begining and end of current line (2), Progressive (BREIF compatible) (3)

Enter key generates Return

booleanWill generate a line break when you press the Enter key.Default: falseRange: —

Allow Tab key to indent text blocks

booleanYou can press the Tab key to invoke the Shift Right command, or Shift-Tab to invoke the Shift Left command.Default: falseRange: —

Enable Shift-Delete for forward delete

booleanHolding down the Shift key with the Delete key makes the Delete key work the same way as the Forward Delete key on extended keyboards.Default: trueRange: —

Enable macOS "Help" key

booleanPressing the Insert key present on some PC-style keyboards will open BBEdit’s Help book.Default: falseRange: —

When auto-indenting, remove leading white space from indented line

booleanWhen you type Return, BBEdit will insert a line break and strip the following whitespace, leaving the remaining text also left-aligned.Default: falseRange: —

Allow Page Up and Page Down keys to move the insertion point

booleanMove the insertion point to the same relative position within the window in each new screenful of text displayed by Page Up or Page Down.Default: falseRange: —

Option-↑ and option-↓ move by paragraphs

booleanThe Option-Up arrow and Option-Down arrow key shortcuts will advance to the previous or next paragraph.Default: falseRange: —

Emulate Emacs key bindings

booleanThis option allows you to use the basic Emacs navigation keystrokes to move around in editing views.Default: trueRange: —

Display status window

booleanWill display a small palette which shows Emacs shortcuts as you type them.Default: falseRange: —

Enable meta sequences

booleanWill intercept presses of the Escape key and use these to emulate a meta key to generate Emacs command sequences, at the cost of no longer being able to use the Escape key to exit full screen mode.Default: falseRange: —

Allow the Escape key to trigger text completion

booleanPressing the Escape key will trigger text completion.Default: falseRange: —

Default Language for New Documents

stringIf you like, you can set the default language for new untitled documents.Default: "text-file"Range: ActionScript (actionscript), ANSI C (ansi-c), Arduino (arduino), C++ (c++), Clojure (clojure), Comma-separated Values (comma-separated-values), CSS (css), EditorConfig (editorconfig), Fortran (fortran), Fortran 9x (fortran-9x), Go (go), HTML (html), INI File (ini-file), Java (java), JavaScript (javascript), JSON (json), JSP (jsp), Lasso (lasso), Lisp (lisp), Log File (log-file), Lua (lua), Make (make), Markdown (markdown), Object Pascal (object-pascal), Objective-C (objective-c), Objective-C++ (objective-c++), Perl (perl), PHP (php), PHP in HTML (php-in-html), Python (python), R (r), Racket (racket), Rez (rez), Ruby (ruby), Ruby in HTML (ruby-in-html), Rust (rust), Sandbox Profile (sandbox-profile), Scheme (scheme), SCSS (scss), Setext (setext), Software Package Notes (software-package-notes), Solidity (solidity), SQL (Generic) (sql-(generic)), SQL (MS Transact) (sql-(ms-transact)), SQL (MySQL) (sql-(mysql)), SQL (PL/SQL) (sql-(pl/sql)), SQL (PostgreSQL) (sql-(postgresql)), Strings File (strings-file), Svelte (svelte), Swift (swift), Tab-separated Values (tab-separated-values), Tcl (tcl), TeX (tex), Text File (text-file), Textile (textile), TOML (toml), TypeScript (typescript), Unix man page (unix-man-page), Unix Shell Script (unix-shell-script), USDA (usda), VBScript (vbscript), VectorScript (vectorscript), Verilog HDL (verilog-hdl), VHDL (vhdl), Vue.js (vue.js), Xcode Project (xcode-project), XML (xml), YAML (yaml)

Default Language for Unmapped files

stringIf you like, you can set the default language for unmapped documents.Default: "text-file"Range: ActionScript (actionscript), ANSI C (ansi-c), Arduino (arduino), C++ (c++), Clojure (clojure), Comma-separated Values (comma-separated-values), CSS (css), EditorConfig (editorconfig), Fortran (fortran), Fortran 9x (fortran-9x), Go (go), HTML (html), INI File (ini-file), Java (java), JavaScript (javascript), JSON (json), JSP (jsp), Lasso (lasso), Lisp (lisp), Log File (log-file), Lua (lua), Make (make), Markdown (markdown), Object Pascal (object-pascal), Objective-C (objective-c), Objective-C++ (objective-c++), Perl (perl), PHP (php), PHP in HTML (php-in-html), Python (python), R (r), Racket (racket), Rez (rez), Ruby (ruby), Ruby in HTML (ruby-in-html), Rust (rust), Sandbox Profile (sandbox-profile), Scheme (scheme), SCSS (scss), Setext (setext), Software Package Notes (software-package-notes), Solidity (solidity), SQL (Generic) (sql-(generic)), SQL (MS Transact) (sql-(ms-transact)), SQL (MySQL) (sql-(mysql)), SQL (PL/SQL) (sql-(pl/sql)), SQL (PostgreSQL) (sql-(postgresql)), Strings File (strings-file), Svelte (svelte), Swift (swift), Tab-separated Values (tab-separated-values), Tcl (tcl), TeX (tex), Text File (text-file), Textile (textile), TOML (toml), TypeScript (typescript), Unix man page (unix-man-page), Unix Shell Script (unix-shell-script), USDA (usda), VBScript (vbscript), VectorScript (vectorscript), Verilog HDL (verilog-hdl), VHDL (vhdl), Vue.js (vue.js), Xcode Project (xcode-project), XML (xml), YAML (yaml)

Custom filesname extension mappings

arrayYou may add (or remove) additional extension mapping via the Custom Extension Mappings list. The values for the keys Language: Code and Language: Name need to match.Default: —Range: —
dict
dict—Default: —Range: —

Extension

string—Default: —Range: —

Language

dict—Default: —Range: —

Language: Code

string—Default: —Range: ActionScript (AScr), ANSI C (C ), Arduino (Adno), C++ (C++ ), Clojure (Cloj), Comma-separated Values (CSV ), CSS (CSS ), EditorConfig (ECFG), Fortran (Fort), Fortran 9x (F90 ), Git commit note (GitC), Go (Go ), Grep Replace Pattern (GrpR), Grep Search Pattern (GrpS), HTML (HTML), INI File (.ini), Java (Java), JavaScript (JScr), JSON (JSON), JSP (JSP ), Lasso (Laso), Lisp (Lisp), Log File (LOG ), Lua (Lua ), Make (Make), Markdown (MRKD), Object Pascal (Pasc), Objective-C (ObjC), Objective-C++ (ObC+), Perforce Specification (P4 ), Perl (Perl), PHP (PHP ), PHP in HTML (PHTM), Python (Pyth), R (R___), Racket (Rakt), Rez (Rez ), Ruby (Ruby), Ruby in HTML (RHTM), Rust (Rust), Sandbox Profile (SBox), Scheme (Schm), SCSS (SCSS), Setext (Setx), Shell Worksheet (ShWk), Software Package Notes (PkgD), Solidity (Sold), SQL (Generic) (SQL ), SQL (MS Transact) (MsSQ), SQL (MySQL) (MySQ), SQL (PL/SQL) (PlSQ), SQL (PostgreSQL) (PgSQ), Strings File (STRS), Svelte (Svel), Swift (Swft), Tab-separated Values (TSV ), Tcl (Tcl ), TeX (TeX ), Text File (DATA), Text Search/Replace String (TxSR), Textile (Txtl), TOML (TOML), TypeScript (TScr), Unix man page (ManP), Unix Shell Script (Shel), USDA (USDA), VBScript (VBSc), VectorScript (VScr), Verilog HDL (Veri), VHDL (VHDL), Vue.js (VuJS), Xcode Project (PBXP), XML (XML ), YAML (YAML)

Language: Name

string—Default: —Range: ActionScript, ANSI C, Arduino, C++, Clojure, Comma-separated Values, CSS, EditorConfig, Fortran, Fortran 9x, Git commit note, Go, Grep Replace Pattern, Grep Search Pattern, HTML, INI File, Java, JavaScript, JSON, JSP, Lasso, Lisp, Log File, Lua, Make, Markdown, Object Pascal, Objective-C, Objective-C++, Perforce Specification, Perl, PHP, PHP in HTML, Python, R, Racket, Rez, Ruby, Ruby in HTML, Rust, Sandbox Profile, Scheme, SCSS, Setext, Shell Worksheet, Software Package Notes, Solidity, SQL (Generic), SQL (MS Transact), SQL (MySQL), SQL (PL/SQL), SQL (PostgreSQL), Strings File, Svelte, Swift, Tab-separated Values, Tcl, TeX, Text File, Text Search/Replace String, Textile, TOML, TypeScript, Unix man page, Unix Shell Script, USDA, VBScript, VectorScript, Verilog HDL, VHDL, Vue.js, Xcode Project, XML, YAML

BBEdit Registered Owner v11

stringOrganization registered to BBEdit 11 license.Default: —Range: —

BBEdit License v11

stringBBEdit 11 license.Default: —Range: —

BBEdit Registered Owner v12

stringOrganization registered to BBEdit 12 license.Default: —Range: —

BBEdit License v12

stringBBEdit 12 license.Default: —Range: —

BBEdit Registered Owner v13

stringOrganization registered to BBEdit 13 license.Default: —Range: —

BBEdit License v13

stringBBEdit 13 license.Default: —Range: —

BBEdit Registered Owner v14

stringOrganization registered to BBEdit 14 license.Default: —Range: —

BBEdit License v14

stringBBEdit 14 license.Default: —Range: —

BBEdit Registered Owner v15

stringOrganization registered to BBEdit 15 license.Default: —Range: —

BBEdit License v15

stringBBEdit 15 license.Default: —Range: —

Web browsers available for previewing

arrayDisplays all the available (installed) web browsers known to BBEdit.Default: —Range: —
dict
dict—Default: —Range: —
bundleIDstring

Bundle ID

string—Default: —Range: —
namestring

Name

string—Default: —Range: —
pathstring

Path

string—Default: —Range: —
versionstring

Version

string—Default: —Range: —

Markdown processor

integerAllows you to select which built-in, or installed and recognized, Markdown processor BBEdit should employ to convert Markdown content to HTML for previewing and export. BBEdit has built-in support for ‘cmark’ as well as ‘classic’ Markdown.Default: 0Range: Default (cmark) (0), MultiMarkdown (1), Discount (2), Pandoc (3), cmark-gfm (5), Classic (4), Custom (999)

Custom command line: Command

stringThe command name must be available in your $PATH.Default: —Range: —

Custom command line: Arguments

stringThe command arguments must be separated by spaces.Default: —Range: —

Printing font

integerspecifies the default font BBEdit uses for printing when the “Print using document’s font” option is turned off.Default: 1Range: Use document's font (1), Use custom font (0)

Custom printing font

dataUses the specified font and tab settings when printing. This is in "data" format. To get the correct entry you will need to set the font in BBEdit first, then open the preference plist file in Xcode and copy the data string from the BBPrintingFont key. Omit the <> from start and end of the string.Default: —Range: —

Frame printing area

booleanDraws a box along the edges of the printed text.Default: falseRange: —

Print page headers

booleanPrints the page number, the name of the file, the time and date printed in a header at the top of each page.Default: trueRange: —

Print full path

booleanPrints the full path of the file being printed in the header.Default: trueRange: —

Print line numbers

booleanPrints line numbers along the left edge of the paper.Default: trueRange: —

1-inch gutter

booleanLeaves a one-inch margin along the left edge of the paper.Default: falseRange: —

Print color syntax

booleanPrints all colorized text within the document in color.Default: trueRange: —

Time stamp

integerChoose whether the date that appears in the printed page header is the date that the file was last modified or the date that the file was printed.Default: 1Range: Date last saved (1), Date printed (2)

Wrap Text to Printed Page

integerChoose whether a document’s contents should always be soft-wrapped upon printing, or only if soft wrapping is enabled for that document.Default: 1Range: Always (1), Only if the printed document is wrapped for display (0)

Automatically show sidebar: AlwaysShowFileList

booleanControls whether BBEdit should display the sidebar only as needed. The preference setting in BBEdit actually controlls two keys; AlwaysShowFileList and AutoShowFileList. The proper settings for these key key match as follows: As needed: AlwaysShowFileList-False / AutoShowFileList-True Always: AlwaysShowFileList-True / AutoShowFileList-False Never: AlwaysShowFileList-False / AutoShowFileList-FalseDefault: falseRange: —

Automatically show sidebar: AutoShowFileList

booleanControls whether BBEdit should display the sidebar only as needed. The preference setting in BBEdit actually controlls two keys; AlwaysShowFileList and AutoShowFileList. The proper settings for these key key match as follows: As needed: AlwaysShowFileList-False / AutoShowFileList-True Always: AlwaysShowFileList-True / AutoShowFileList-False Never: AlwaysShowFileList-False / AutoShowFileList-FalseDefault: trueRange: —

Reshape window when showing or hiding sidebar

booleanWill reshape the entire window when the sidebar appears (or is hidden) to maintain the editing pane at a consistent size.Default: trueRange: —

Add documents to sidebar in alphabetical order

booleanWill add newly created and/or opened documents to the sidebar list in alphabetical order.Default: trueRange: —

Sidebar list appearance and behavior: Show icons

booleanDisplays icons for files and folders in the sidebar’s file list.Default: trueRange: —

Sidebar list appearance and behavior: Show Finder tags

booleanDisplays the Finder tags for files and folders in the sidebar’s file list.Default: trueRange: —

Sidebar list appearance and behavior: Allow keyboard focus

booleanThe sidebar lists in projects, multi-document editing windows, and differences windows can acquire keyboard focus (by clicking or tabbing into them), and you can then use conventional keyboard navigation gestures to change the selection.Default: trueRange: —

Background

stringControls the background color used within editing windows. This needs to be entered as a comma seperated list of hue, saturation, lightness, and alpha (transparency). Example: hsla(0.668, 0.001, 0.970, 1.000)Default: —Range: —

Misspelled words

stringControls the color BBEdit uses to highlight misspelled words. This needs to be entered as a comma seperated list of hue, saturation, lightness, and alpha (transparency). Example: hsla(1.001, 0.503, 1.000, 1.000)Default: —Range: —
stringControls the color BBEdit uses to display spaces when the Show Invisibles and Show Spaces display options are active. This needs to be entered as a comma seperated list of hue, saturation, lightness, and alpha (transparency). Example: hsla(0.668, 0.003, 0.660, 1.000)Default: —Range: —

Other invisibles

stringControls the color BBEdit uses to display invisible characters other than spaces when the Show Invisibles display options is active. This needs to be entered as a comma seperated list of hue, saturation, lightness, and alpha (transparency). Example: hsla(0.003, 0.974, 0.868, 1.000)Default: —Range: —

Differences

stringControls the color BBEdit uses to highlight differing regions within a Differences window. This needs to be entered as a comma seperated list of hue, saturation, lightness, and alpha (transparency). Example: hsla(0.759, 0.311, 1.000, 1.000)Default: —Range: —

Sub-line differences

stringProvides explicit control over the color BBEdit uses to display character ranges within a single top-level (or line-level) difference, rather than using a derived color. This needs to be entered as a comma seperated list of hue, saturation, lightness, and alpha (transparency). Example: hsla(0.771, 0.389, 0.881, 1.000)Default: —Range: —

Insertion point line

stringControls the color BBEdit uses to highlight the current line the insertion point is located at. This needs to be entered as a comma seperated list of hue, saturation, lightness, and alpha (transparency). Example: hsla(0.172, 0.116, 0.976, 1.000)Default: —Range: —

Use custom highlight colors

booleanTurn this option on to have BBEdit use custom highlight colors.Default: falseRange: —

Use custom highlight colors: primary

stringChoose the primary highlight color. This needs to be entered as a comma seperated list of hue, saturation, lightness, and alpha (transparency). Example: hsla(0.591, 0.298, 1.000, 1.000)Default: —Range: —

Use custom highlight colors: primary

stringChoose the secondary highlight color. This needs to be entered as a comma seperated list of hue, saturation, lightness, and alpha (transparency). Example: hsla(0.668, 0.001, 0.864, 1.000)Default: —Range: —

Text Encodings

arrayAllows you to choose which of these encodings BBEdit includes in its menus. If you make changes, the following entries are the defaults or are required: Chinese (GB 18030) Chinese (GBK) Cyrillic (Windows) Japanese (ISO 2022-JP) Japanese (Mac OS) Japanese (Shift JIS) Korean (Mac OS) Simplified Chinese (GB 2312) Simplified Chinese (Mac OS) Traditional Chinese (Big 5) Traditional Chinese (Mac OS) [↓ These are required ↓] Unicode (UTF-16 Little-Endian, no BOM) Unicode (UFT-16 Little-Endian) Unicode (UTF-16, no BOM) Unicode (UTF-16) Unicode (UTF-8, with BOM) Unicode (UTF-8) [↑ These are required ↑] Western (ISO Latin 1) Western (ISO Latin 9) Western (Mac OS Roman) Western (Windows Latin 1)Default: —Range: —
integer
integer—Default: —Range: Baltic (DOS) (1030), Baltic (IOS Latin 7 (525), Baltic (Windows) (1287), Canadian French (DOS) (1048), Celtic (Mac OS) (39), Central European (DOS Latin 2) (1042), Central European (ISO Latin 2) (514), Central European (ISO Latin 4) (516), Central European (Mac OS) (29), Central European (Windows Latin 2) (1281), Chinese (GB 18030) (1586), Chinese (GBK) (1585), Croatian (Mac OS) (36), Cyrillic (DOS) (1043), Cyrillic (ISO 8859-5) (517), Cyrillic (KOI8-R) (2562), Cyrillic (Mac OS Ukrainian) (152), Cyrillic (Mac OS) (7), Cyrillic (Windows) (1282), Devanagari (Mac OS) (9), Dingbats (Mac OS) (34), Gaelic (Mac OS) (40), Greek (DOS Greek 1) (1041), Greek (DOS Greek 2) (1052), Greek (DOS) (1029), Greek (ISO 8859-7) (519), Greek (Mac OS) (6), Greek (Windows) (1283), Gujarati (Mac OS) (11), Gurmukhi (Mac OS) (10), Icelandic (DOS) (1046), Icelandic (Mac OS) (37), Inuit (Mac OS) (236), Japanese (EUC) (2336), Japanese (ISO 2022-JP) (2080), Japanese (Mac OS) (1), Japanese (Shift JIS X0213) (1576), Japanese (Shift JIS) (2561), Japanese (Windows, DOS) (1056), Keyboard Symbols (Mac OS) (41), Korean (EUC) (2368), Korean (Mac OS) (3), Korean (Windows, DOS) (1058), Latin-US (DOS) (1024), Nordic (DOS) (1050), Nordic (ISO Latin 6) (522), Portugese (DOS) (1045), Romanian (ISO Latin 10) (528), Romanian (Mac OS) (38), Russian (DOS) (1051), Simplified Chinese (GB 2312) (2352), Simplified Chinese (Mac OS) (25), Simplified Chinese (Windows, DOS) (1057), Symbol (Mac OS) (33), Thai (Mac OS) (21), Thai (Windows, DOS) (1053), Tibetan (Mac OS) (26), Traditional Chinese (Big 5 HKSCS) (2566), Traditional Chinese (Big 5-E) (2569), Traditional Chinese (Big 5) (2563), Traditional Chinese (EUC) (2353), Traditional Chinese (Mac OS) (2), Traditional Chinese (Windows, DOS) (1059), Turkish (DOS) (1044), Turkish (ISO Latin 5) (521), Turkish (Mac OS) (35), Turkish (Windows Latin 5) (1284), Ukrainian (KOI8-U) (2568), Unicode (UTF-16 Little-Endian, no BOM) (909209186), Unicode (UFT-16 Little-Endian) (909210741), Unicode (UTF-16, no BOM) (825650786), Unicode (UTF-16) (1970549046), Unicode (UTF-8, with BOM) (1970562616), Unicode (UTF-8) (809004642), Vietnamese (Windows) (1288), Western (ASCII) (1536), Western (DOS Latin 1) (1040), Western (EBCDIC Latin 1) (3074), Western (EBCDIC Latin Core) (3073), Western (ISO Latin 1) (513), Western (ISO Latin 3) (515), Western (ISO Latin 9) (527), Western (Mac Mail) (2564), Western (Mac OS Roman) (0), Western (NextStep) (2817), Western (Windows Latin 1) (1280)

Default text encoding for new documents

integerUses the encoding specified by this option for new documents which do not contain an intrinsic encoding specification.Default: 809004642Range: Baltic (DOS) (1030), Baltic (IOS Latin 7 (525), Baltic (Windows) (1287), Canadian French (DOS) (1048), Celtic (Mac OS) (39), Central European (DOS Latin 2) (1042), Central European (ISO Latin 2) (514), Central European (ISO Latin 4) (516), Central European (Mac OS) (29), Central European (Windows Latin 2) (1281), Chinese (GB 18030) (1586), Chinese (GBK) (1585), Croatian (Mac OS) (36), Cyrillic (DOS) (1043), Cyrillic (ISO 8859-5) (517), Cyrillic (KOI8-R) (2562), Cyrillic (Mac OS Ukrainian) (152), Cyrillic (Mac OS) (7), Cyrillic (Windows) (1282), Devanagari (Mac OS) (9), Dingbats (Mac OS) (34), Gaelic (Mac OS) (40), Greek (DOS Greek 1) (1041), Greek (DOS Greek 2) (1052), Greek (DOS) (1029), Greek (ISO 8859-7) (519), Greek (Mac OS) (6), Greek (Windows) (1283), Gujarati (Mac OS) (11), Gurmukhi (Mac OS) (10), Icelandic (DOS) (1046), Icelandic (Mac OS) (37), Inuit (Mac OS) (236), Japanese (EUC) (2336), Japanese (ISO 2022-JP) (2080), Japanese (Mac OS) (1), Japanese (Shift JIS X0213) (1576), Japanese (Shift JIS) (2561), Japanese (Windows, DOS) (1056), Keyboard Symbols (Mac OS) (41), Korean (EUC) (2368), Korean (Mac OS) (3), Korean (Windows, DOS) (1058), Latin-US (DOS) (1024), Nordic (DOS) (1050), Nordic (ISO Latin 6) (522), Portugese (DOS) (1045), Romanian (ISO Latin 10) (528), Romanian (Mac OS) (38), Russian (DOS) (1051), Simplified Chinese (GB 2312) (2352), Simplified Chinese (Mac OS) (25), Simplified Chinese (Windows, DOS) (1057), Symbol (Mac OS) (33), Thai (Mac OS) (21), Thai (Windows, DOS) (1053), Tibetan (Mac OS) (26), Traditional Chinese (Big 5 HKSCS) (2566), Traditional Chinese (Big 5-E) (2569), Traditional Chinese (Big 5) (2563), Traditional Chinese (EUC) (2353), Traditional Chinese (Mac OS) (2), Traditional Chinese (Windows, DOS) (1059), Turkish (DOS) (1044), Turkish (ISO Latin 5) (521), Turkish (Mac OS) (35), Turkish (Windows Latin 5) (1284), Ukrainian (KOI8-U) (2568), Unicode (UTF-16 Little-Endian, no BOM) (909209186), Unicode (UFT-16 Little-Endian) (909210741), Unicode (UTF-16, no BOM) (825650786), Unicode (UTF-16) (1970549046), Unicode (UTF-8, with BOM) (1970562616), Unicode (UTF-8) (809004642), Vietnamese (Windows) (1288), Western (ASCII) (1536), Western (DOS Latin 1) (1040), Western (EBCDIC Latin 1) (3074), Western (EBCDIC Latin Core) (3073), Western (ISO Latin 1) (513), Western (ISO Latin 3) (515), Western (ISO Latin 9) (527), Western (Mac Mail) (2564), Western (Mac OS Roman) (0), Western (NextStep) (2817), Western (Windows Latin 1) (1280)

If a file's encoding can't be guessed, try

arrayIf BBEdit cannot determine a file’s proper encoding by examination, it will try opening the file using the encodings contained in this list, in the order they appear. The default required value is "Western (Mac OS Roman)".Default: —Range: —
integer
integer—Default: —Range: Baltic (DOS) (1030), Baltic (IOS Latin 7 (525), Baltic (Windows) (1287), Canadian French (DOS) (1048), Celtic (Mac OS) (39), Central European (DOS Latin 2) (1042), Central European (ISO Latin 2) (514), Central European (ISO Latin 4) (516), Central European (Mac OS) (29), Central European (Windows Latin 2) (1281), Chinese (GB 18030) (1586), Chinese (GBK) (1585), Croatian (Mac OS) (36), Cyrillic (DOS) (1043), Cyrillic (ISO 8859-5) (517), Cyrillic (KOI8-R) (2562), Cyrillic (Mac OS Ukrainian) (152), Cyrillic (Mac OS) (7), Cyrillic (Windows) (1282), Devanagari (Mac OS) (9), Dingbats (Mac OS) (34), Gaelic (Mac OS) (40), Greek (DOS Greek 1) (1041), Greek (DOS Greek 2) (1052), Greek (DOS) (1029), Greek (ISO 8859-7) (519), Greek (Mac OS) (6), Greek (Windows) (1283), Gujarati (Mac OS) (11), Gurmukhi (Mac OS) (10), Icelandic (DOS) (1046), Icelandic (Mac OS) (37), Inuit (Mac OS) (236), Japanese (EUC) (2336), Japanese (ISO 2022-JP) (2080), Japanese (Mac OS) (1), Japanese (Shift JIS X0213) (1576), Japanese (Shift JIS) (2561), Japanese (Windows, DOS) (1056), Keyboard Symbols (Mac OS) (41), Korean (EUC) (2368), Korean (Mac OS) (3), Korean (Windows, DOS) (1058), Latin-US (DOS) (1024), Nordic (DOS) (1050), Nordic (ISO Latin 6) (522), Portugese (DOS) (1045), Romanian (ISO Latin 10) (528), Romanian (Mac OS) (38), Russian (DOS) (1051), Simplified Chinese (GB 2312) (2352), Simplified Chinese (Mac OS) (25), Simplified Chinese (Windows, DOS) (1057), Symbol (Mac OS) (33), Thai (Mac OS) (21), Thai (Windows, DOS) (1053), Tibetan (Mac OS) (26), Traditional Chinese (Big 5 HKSCS) (2566), Traditional Chinese (Big 5-E) (2569), Traditional Chinese (Big 5) (2563), Traditional Chinese (EUC) (2353), Traditional Chinese (Mac OS) (2), Traditional Chinese (Windows, DOS) (1059), Turkish (DOS) (1044), Turkish (ISO Latin 5) (521), Turkish (Mac OS) (35), Turkish (Windows Latin 5) (1284), Ukrainian (KOI8-U) (2568), Unicode (UTF-16 Little-Endian, no BOM) (909209186), Unicode (UFT-16 Little-Endian) (909210741), Unicode (UTF-16, no BOM) (825650786), Unicode (UTF-16) (1970549046), Unicode (UTF-8, with BOM) (1970562616), Unicode (UTF-8) (809004642), Vietnamese (Windows) (1288), Western (ASCII) (1536), Western (DOS Latin 1) (1040), Western (EBCDIC Latin 1) (3074), Western (EBCDIC Latin Core) (3073), Western (ISO Latin 1) (513), Western (ISO Latin 3) (515), Western (ISO Latin 9) (527), Western (Mac Mail) (2564), Western (Mac OS Roman) (0), Western (NextStep) (2817), Western (Windows Latin 1) (1280)

Line breaks

integerIf BBEdit cannot determine a file’s proper encoding by examination, it will try opening the file using the encodings contained in this list, in the order they appear. The default required value is "Western (Mac OS Roman)".Default: 1Range: Unix (LF) (1), Legacy Mac (CR) (2), Windows (CRLF) (3)

Ensure file ends with line break

booleanWill add a line break at the end of the file if there is not already one present.Default: falseRange: —

Strip trailing whitespaces

booleanWill trim all trailing non-vertical whitespace from the document file before writing it out.Default: falseRange: —
MakeBackupboolean

Make backup before saving

booleanAutomatically make a backup copy of each file that you save.Default: falseRange: —

Keep historical backups

booleanWill preserve backups in the “BBEdit Backups” folder.Default: trueRange: —

Preserve file name extension

booleanHave BBEdit place the tilde after the “base” name of the file (“foo~.html”) instead of the name of the original with a tilde appended (“foo.html~”).Default: falseRange: —

Rescue untitled document contents when discarding changes

booleanWhen this option is on and you close an untitled document (one that has never been saved to disk), and click “Don't Save”, BBEdit will preserve a snapshot of that document's contents.Default: trueRange: —

Remove rescued items

booleanWill automatically perform some housekeeping for you by cleaning up rescued data.Default: trueRange: —

Remove rescued items after ## days

realYou can adjust the interval from 1 to 365 days.Default: 7Range: 1 – 365

Text file name extensions

arrayAdd filename extensions for files that BBEdit does not intrinsically know about, but which should be treated as (plain) text files.Default: —Range: —
string

Extension

string—Default: —Range: —

Allow Editor Config Read Encoding

boolean—Default: trueRange: —

Allow Folder Selection in Open Dialog

boolean—Default: trueRange: —

Allow Multi Line Placeholders

boolean—Default: falseRange: —

Allow Prototype Object Extend (JavaScript)

boolean—Default: trueRange: —

Allow Shebang Line Override

boolean—Default: trueRange: —

Allow Shift Right to Indent Whitespace Only Lines

booleanBy default, the "Shift Right" command on the Text menu will not add indentation to lines that are empty or consist entirely of white space. If you would prefer to indent every line, regardless of its whitespace-only nature, set this preference to 'true'.Default: trueRange: —

Allow Volume Mount During State Restore

booleanBBEdit provides control over whether documents on remote servers - FTP/SFTP - or unmounted volumes are opened when automatically reopening documents at application startup. You can modify its behavior by setting this to 'true'.Default: falseRange: —

Prompt To Reopen Remote Documents

booleanIf set to 'false', BBEdit will not attempt to open any documents that were opened from FTP/SFTP servers. Defaults to 'true'. If set to 'false', BBEdit will open remote documents without asking, if ReopenRemoteDocuments is set to 'true'.Default: trueRange: —

Always Bring Unix Script Output To Front

boolean—Default: falseRange: —

Always Display Soft Hyphens

boolean—Default: trueRange: —

Always Show Annunciator For Not Found

booleanTo skip the sound check and always have BBEdit show the overlay alert instead of beeping.Default: falseRange: —

Always Use Base Python With Virtual Environment

boolean—Default: trueRange: —

Always Use Base Python With Virtual Environment (Python)

boolean—Default: trueRange: —

Apple Show All Extensions

boolean—Default: trueRange: —

Ask For Unguessable File Encoding

booleanOrdinarily, BBEdit will only ask you to choose a file's encoding when it can't otherwise figure out what the encoding is, and your "if the file's encoding can't be guessed" preference is a UTF-8 or UTF-16 variant. This should be fine for general use, but if for some reason you always want BBEdit to ask you when it can't guess a file's encoding, even if your preference would do the job, you can set this to 'true'.Default: falseRange: —

Ask XCode to Open File by Name

booleanIf Xcode is running, Open Selection and Open File by Name will ask it for a path to the file name; if something useful comes back, BBEdit will open it. If for some reason you are using Xcode but don't want BBEdit to do this, you can turn it off by setting this to 'false'.Default: trueRange: —

Auto Indent LSP Completion Text

boolean—Default: trueRange: —

Auto Reveal Selected Document In Project List

booleanBBEdit will not automatically reveal documents in the project list when you select them; View => Reveal in Project List works for this purpose. If you want automatic revealing, set to this to 'true'Default: falseRange: —

Auto Save App State

boolean—Default: trueRange: —

Auto Save Interval In Minutes: v2

integerIf document auto-save for crash recovery is on, this preference will define the default save time interval.Default: 1Range: —

Auto Swap Close Shortcuts

boolean—Default: trueRange: —

Auto Wrap Documents With Long Lines

boolean—Default: trueRange: —

Auto Wrap Documents With Long Lines (HTML)

boolean—Default: falseRange: —

Auto Wrap Line Length Threshold

integer—Default: 8192Range: —

Balance Includes Delimiters

booleanBy default, the "Balance" command (or double-clicking on a delimiter to balance) does not include the delimiters in the resulting selection. If you would like for it to do so, set this preference to 'true'.Default: falseRange: —

BRIEF State Timeout

realThe progressive (BRIEF compatible) behavior of the Home and End keys operates within a specific time period; if you wait longer than that, the behavior state resets. The factory default timeout period is ten seconds.Default: 10Range: 0.1 – —

Camel Case Navigation Includes Underscores

booleanWhen using "camel case" navigation (see above), BBEdit does not include underscores ( _ ) when moving or extending the selection range. If you would prefer that it do so, you can turn this on.Default: falseRange: —

Cascade New Windows

boolean—Default: trueRange: —

ChatGPT API Request Timeout

integer—Default: 0Range: —

Check Modification Date For Remote Saves

boolean—Default: trueRange: —

Clipboard Text Display Limit

integer—Default: 65536Range: —

Clipboard: Convert Non Breaking Spaces When Pasting

boolean—Default: trueRange: —

Clippings Work In Find Windows

boolean—Default: trueRange: —

Close OFBN Window After Opening Selection

booleanBy default, the "Open File by Name" window stays open when you click the "Open" button. However, if you would prefer for it to act more like a modal dialog, set this to 'true'.Default: falseRange: —

Codeless PCRE Timeout

integer—Default: 250Range: —

Color Patterns In Grep Cheat Sheet

booleanBBEdit will color patterns (the left-hand column) in the Grep Cheat Sheet menu according to the active color scheme. If you would prefer monochromatic patterns for any reason turn this off.Default: trueRange: —

Comment Whole Line With Insertion Point

booleanWhen using the Un/Comment command, if nothing is selected, BBEdit will use the line comment delimiter to comment (or uncomment) the entire line. If you would prefer that BBEdit insert the line-comment delimiter at the insertion point instead, set this preference to 'false'.Default: trueRange: —

Conda Interface Command Timeout

integer—Default: 3500Range: —

Context Menu Clipboard

boolean—Default: trueRange: —

Context Menu Markers

boolean—Default: trueRange: —

Context Menu Resolve URL

boolean—Default: trueRange: —

Context Menu Save New Selection

boolean—Default: trueRange: —

Context Menu Save New Selection

boolean—Default: trueRange: —

Context Menu Text Folding

boolean—Default: trueRange: —

Context Menu Text Searching

boolean—Default: trueRange: —

Counterpart Sibling Search Names

stringWhen the active document is either a source or a header file, the "Open Counterpart" command will now search the siblings of this file's parent for eligible counterparts. By default, BBEdit will only search in such folders if their names match one of the following patterns (including wildcards): `inc*`, `source`, `src`, or `*priv*`. If you wish to add additional qualifying names, you may do so by setting "CounterpartSiblingSearchNames" to contain a comma-delimited list of folder name patterns. Any whitespace surrounding the provided names will be stripped.Default: —Range: —

Cross Check For Image Files With Text Encoding Xattr

boolean—Default: falseRange: —

CSS Markup: New Line Before Brace

boolean—Default: trueRange: —

CSS Markup: Prefer Short Hex Colors

boolean—Default: trueRange: —

CSS Markup: Simple Rules On One Line

boolean—Default: trueRange: —

Ctags Completion Threshold

integer—Default: 2Range: —

Ctags Completion Threshold

string—Default: "markdown"Range: —

Diff: Ignore RCS Keywords

booleanWhen comparing text files, BBEdit will canonicalize RCS keywords to their unexpanded state, so that the values of RCS keywords are not significant to the differences calculations. If you wish, you can disable this, so that any chance in the RCS keywords on a line will cause the line to appear in the differences.Default: trueRange: —

Disable All Font Ligatures

boolean—Default: falseRange: —

Disable Attachment Scripts

boolean—Default: falseRange: —

Disable Ctags Scan On Remote Volumes

booleanWhen editing files that are on remote file servers - AFP, NFS, SMB, etc. -, BBEdit will not look for directory-relative ctags data files. This is a particular performance win when the file is located on a volume mounted via MacFUSE/SSH or similar, or if the file server is over a slow or high-latency link. To enable scanning for tags files on remote volumes, set this to 'false'.Default: trueRange: —

Disable Find And Replace History

booleanCompletely disable the search history in the Find and Multi-File Search windows.Default: falseRange: —

Disable Passive FTP

booleanSettings are available for disabling passive FTP, in order to deal with hosts that misbehave when sent the PASV command. Passive FTP can be disabled per host, per domain, or globally.Default: falseRange: —

Display Private Area Glyphs

boolean—Default: trueRange: —

Display: Full Path In Window Menu

boolean—Default: falseRange: —

Double Click To Balance

boolean—Default: trueRange: —

Editor Tail Mode (Log File)

boolean—Default: trueRange: —

Editor: Always Open Quick Find

booleanThe Live Search bar is not visible by default, but appears when you choose "Live Search" from the Search menu. If you would like the Live Search bar to be visible in each new document that you create or open, set this to 'true'.Default: falseRange: —

Editor: Auto Indent Is Brace Aware

boolean—Default: trueRange: —

Editor: Auto Word Count Size Threshold

integerAutomatic word counting is disabled for documents over a set size threshold, in order to avoid needless delays when working on very large documents. The factory default is 16M characters - 16777216 -, but you may change this limit. Setting to 0 disables the limit check entirely.Default: 16777216Range: 0 – —

Editor: Control Arrow Camel Case

booleanBBEdit supports "camel case" navigation: press Control-left-arrow or Control-right-arrow to jump to the next (or previous) transition from lower-case to upper-case characters (or a word boundary, whichever comes first). Note that this use of Control-left-arrow and Control-right-arrow replaces the pre-8.5 behavior of using these key combinations to scroll horizontally. If you prefer the old behavior, set these this preference to 'false'.Default: trueRange: —

Editor: Control Arrow H Scroll

booleanBBEdit supports "camel case" navigation: press Control-left-arrow or Control-right-arrow to jump to the next (or previous) transition from lower-case to upper-case characters (or a word boundary, whichever comes first). Note that this use of Control-left-arrow and Control-right-arrow replaces the pre-8.5 behavior of using these key combinations to scroll horizontally. If you prefer the old behavior, set these this preference to 'true'.Default: falseRange: —

Editor: Delete Indentation Whitespace To Tab Stop

booleanWhen you backspace from the insertion point, BBEdit will delete a tab stop's worth of spaces if there are only spaces (and tabs) between the insertion point and the start of the line on which you're editing. This may be disabled by setting this preference to 'false'.Default: trueRange: —

Editor: Soft Wrap Length Threshold

integerFor text documents whose size exceeds a certain threshold (expressed in bytes), BBEdit will ignore the Soft Wrap Text preference and leave wrapping off in order to improve the performance of opening very large files.Default: 50331648Range: —

Editor: Spell Check Length Limit

integerSince "Find All Misspelled Words" is pretty much pointless on files over a certain size, the maximum amount of text checked by this command is limited to 1M - 1024 squared - characters. This may be adjusted. Setting to 0 supresses the limit altogether.Default: 1048576Range: 0 – —

Enable Auto Save: v2

booleanDocument auto-save for crash recovery is on by default, to change this set this to 'false'.Default: trueRange: —

Enable Character Wrapping To Window Width

boolean—Default: trueRange: —

Enable Default Filename Extensions

boolean—Default: trueRange: —

Enable Font Ligatures

boolean—Default: falseRange: —

Enable Font Ligatures: Cascadia Mono*

boolean—Default: trueRange: —

Enable Font Ligatures: Fira Code*

boolean—Default: trueRange: —

Enable Font Ligatures: Hasklig*

boolean—Default: trueRange: —

Enable Font Ligatures: Jet Brains Mono*

boolean—Default: trueRange: —

Enable Font Ligatures: Mono Lisa*

boolean—Default: trueRange: —

Enable Font Ligatures: Monoid*

boolean—Default: trueRange: —

Enable Font Ligatures: Monoisome*

boolean—Default: trueRange: —

Enable Rare Ligatures

boolean—Default: falseRange: —

Enable SSH Compression

booleanSome servers don't work correctly when SSH compression is enabled. To work around this, SSH compression can be disabled per host, per domain, or globally.Default: trueRange: —

Enable SSH Legacy RSA Host Keys

boolean—Default: trueRange: —

Enable Syntax Coloring

boolean—Default: trueRange: —

Exchange Command And Option Horizontal

boolean—Default: falseRange: —

Exchange Command And Option Vertical

boolean—Default: falseRange: —

Find And Replace History Size

integerBy default, BBEdit will remember the 16 most recent search and replace strings/patterns for the popup menu in the Find and Multi-File Search windows. Setting the history to zero makes it infinite.Default: 16Range: 0 – —

Find Dialog: Uses Find Scrap

booleanLike many Mac OS X applications, BBEdit supports the "Find Scrap", a feature of the OS that enables sharing of the "search for" string between applications. Some applications put inappropriate content - such as Web search strings - on the Find Scrap, which can cause the "search for" string in BBEdit's Find dialog to be replaced when you didn't expect it. To tell BBEdit not to import the Find Scrap into its Find window, nor to export the "search for" string to the Find Scrap, set this to 'false'.Default: trueRange: —

Fixed Width Font Smoothing Threshold

integerWhether or not BBEdit uses text smoothing - antialiasing - may be adjusted separately for fixed-width and for proportional fonts. The factory default smoothing thresholds are 8pt for fixed width fonts, and 4pt for proportional fonts, respectively.Default: 8Range: —

Flash Balance Points When Navigating

booleanWhen you use the right-arrow key to navigate over a closing delimiter (right paren/brace/bracket/curly quote), the opening delimiter will be briefly highlighted. If you wish to turn this off, set this preference to 'false'.Default: trueRange: —

Font Smoothing Threshold

integerWhether or not BBEdit uses text smoothing - antialiasing - may be adjusted separately for fixed-width and for proportional fonts. Font sizes above the specified FixedWidthFontSmoothingThreshold are smoothed; font sizes below the threshold are not.Default: 4Range: —

Force Singleton Windows For Unix Script Output

boolean—Default: falseRange: —

FTP Abort Timeout

integer—Default: 3Range: —

FTP Auto Disconnect Period

integer—Default: 90Range: —

FTP Auto Disconnect Period

integer—Default: 20Range: —

FTP Control Timeout

integer—Default: 30Range: —

FTP Disable MLSD

booleanOrdinarily, BBEdit will use the MLSD command to obtain directory listings if the server supports it; and will fall back to more primitive methods if not. On some servers, however, MLSD works, but does not return the same results as the older methods. Therefore, there is a method to disable use of MLSD.Default: falseRange: —

FTP Remember Recent Files

boolean—Default: trueRange: —

FTP Safe Saves

boolean—Default: falseRange: —

FTP Show Parent Dir

booleanOn FTP servers, when using 'Show items starting with ".",' the FTP server may return the `.` and `..` items as part of the listing. This is normal, but if you don't want to see these items, you can hide them.Default: trueRange: —

FTP Transfer Timeout

integer—Default: 30Range: —

Full Screen Windows Hog Screen

booleanBy default, the application will allow windows to take up the entire screen when entering full screen mode. If desired, you may prevent this and instruct the application to figure out whether a window should be made the full width of the screen by setting this to 'false'.Default: trueRange: —

Full Screen Width Threshold

realWhen entering full screen mode, the application figures out whether the window width should be increased to take up the full screen width, or not, based on the width of the window relative to the width of the screen that it's on. The threshold at which the window is made to take up the entire screen width can be set. This setting requires that FullScreenWindowsHogScreen be turned on NEED FLOAT NUMBER MIN & MAXDefault: —Range: 0 – 1

Function Menu Show Comment Callouts

boolean—Default: trueRange: —

Function Menu Show Function Prototypes

boolean—Default: falseRange: —

Function Popup: Prototypes

boolean—Default: trueRange: —

Function Popup: Sort By Name

boolean—Default: falseRange: —

Generate Completions From Nearby Tags Files

boolean—Default: trueRange: —

Generate Temporary Tags For Completion

boolean—Default: trueRange: —

Gray Level For Modified Rings In List Widgets

real—Default: 0.65Range: —

Group Windows Menu By Kind

boolean—Default: trueRange: —

Honor Emacs State On Open

boolean—Default: trueRange: —

HTML Image Markup Creates Size Attributes

booleanWhen you drop an image file into an HTML document to generate an image tag, BBEdit will generate "width" and "height" tags based on information in the file itself. If you would prefer to omit these, set these to 'false'.Default: trueRange: —

HTML Image Markup Use Inline Style For Image Size

booleanIf HTMLImageMarkupCreatesSizeAttributes is turned on, you can instruct BBEdit to generate inline styles for image sizes, instead of height and width by setting this to 'true'.Default: falseRange: —

HTML Image Markup Uses File Name For Alt

booleanWhen generating image markup as a result of dropping an image file into an HTML document, BBEdit will generate an "alt" attribute for the image tag, whose value is the file's name. If you would prefer for the "alt" attribute to be omitted (which will result in an error when checking syntax), you can disable this by setting this to 'false'.Default: trueRange: —

Inspect Text File Contents For List Filtering

booleanThe "Text Files Only" filtering in project lists and disk browsers looks inside of files if necessary, for improved filtering accuracy.Default: trueRange: —

Inspect Zip Archive Contents For File Filtering

booleanWhen inspecting files to determine whether they're Zip archives for file filtering and searching, BBEdit will ordinarily only inspect the contents of the file if its metadata does not indicate that it’s a Zip archive. If for some reason you have files whose metadata indicates that they're Zip archives, but aren't really, you can use this setting to tell BBEdit to always inspect Zip archive contents.Default: falseRange: —

Leave Room For Palettes

boolean—Default: trueRange: —

Legacy Undo Selection Behavior

booleanWhen performing an Undo or Redo and the selection range changes, the Undo/Redo operation will select the affected text, rather than updating the Undo/Redo state to include the actual current selection range. If however you prefer the classic behavior (as implemented from the beginning of time up through BBEdit 11.6), you may obtain set this preference to 'true'.Default: falseRange: —

Link Encoding To Charset

boolean—Default: trueRange: —

Live Match Size Limit

integer—Default: 256Range: —

Longest Line Calculation Limit

integer—Default: 16777216Range: —

LSP Completions Replace Instead Of Insert

boolean—Default: falseRange: —

LSP Enable Markdown Documentation

boolean—Default: trueRange: —

Make Shebang Scripts Executable

boolean—Default: trueRange: —

Make Temp Project For Folder Open

boolean—Default: trueRange: —

Markup Panel Auto Prefill Recommended Attribute Names

booleanWhen you invoke the Markup Panel to create a new tag, it will automatically fill in attribute names for "promoted" attributes. If there are any attributes that you don't want to be present in the generated markup, just leave their values blank, and the panel will omit them (unless the attributes are required). If you wish, you can suppress the auto fill by setting this to 'false'. Turning off the auto fill will cause the "gear" to appear in the markup panel, and clicking it will manually fill in the promoted attributes for you.Default: trueRange: —

Markup Tools Misc: Skip XML Files When Scanning Folders

booleanWhen doing Check Syntax, Check Links, Update, or Update Images on a folder (including a web site), BBEdit will skip XML files (that is, files determined to be XML either by mapping their file name extensions, or by inspection of their contents). If you prefer to include such files, set this to 'false'.Default: trueRange: —

Max Document Length For Completion Tokenizer

integerSince "Find All Misspelled Words" is pretty much pointless on files over a certain size, the maximum amount of text checked by this command is limited to 1M - 1024 squared - characters. This may be adjusted. Setting to 0 supresses the limit altogether.Default: 1048576Range: 0 – —

Max Find Differences Group Size

integer—Default: 5Range: —

Maximum Header Font Size

integer—Default: 14Range: —

Maximum Line Bar Point Size

integerBBEdit will calculate an appropriate size for font used in the line number bar, based on the point size of the font used for editing.Default: 24Range: —

Maximum Text Length For Language Guessing

integer—Default: 32768Range: —

Minimum Lines For Block Fold

integer—Default: 1Range: —

Most Recent Items Group Limit

integerThe "Remember the … most recently used items" setting in the Application preferences applies to all item types. So, if it's set to 15, BBEdit will remember 15 text documents, 15 folders, 15 projects, 15 images, and so on. If you want finer control, you can construct an expert pref using the name of the document type as it appears in the menu, and if that name contains spaces, you'll need to quote it. You can also control the number of items shown in the "Most Recently Used" group.Default: —Range: —

Move Modeless Window To Active Space

booleanWhen using Spaces, you can control whether BBEdit's modeless dialog boxes - Find, Multi-File Search, and Open File by Name - get moved to the active space when switching spaces. By default, this is allowed for the Find, Multi-File Search, and Open File by Name windows. To control whether windows of these types are moved to the active space, set this to 'true'. This preference sets the default behavior for any of the defined window types for which a default is not explicitly specified.Default: falseRange: —

Number Of Open By Name Items

integer—Default: 100Range: —

OFBN Enumerates Xcode Subprojects

boolean—Default: trueRange: —

OFBN Includes Recent Items

boolean—Default: falseRange: —

Only Show Invisible Unicode Spaces When Show Spaces Is Turned On

boolean—Default: trueRange: —

Opaque Block Comments (PHP)

boolean—Default: trueRange: —

Opaque Here Doc (PHP)

boolean—Default: trueRange: —

Opaque Line Comments (PHP)

boolean—Default: trueRange: —

Opaque Strings (PHP)

boolean—Default: trueRange: —

Open By Name Max Wildcard Matches

integerWhen searching for matches, Open File by Name limits the number of matches to a reasonable maximum. The factory default is 200.Default: 200Range: —

Open Disk Browser For Tarballs

boolean—Default: trueRange: —

Open Disk Browser For Zip Files

boolean—Default: trueRange: —

Open Items On Single Click

boolean—Default: trueRange: —

Open Panel Shows Front Document Directory

booleanBy default, the Open panel implements the standard system behavior of displaying the same folder that was viewed the last time you used the Open command. If you wish, you may instead have the Open panel display the directory containing the active document by setting this to 'true'. If the active document is untitled or was opened from an FTP/SFTP server, or if there are no documents open, the Open panel will show you the last-used directory.Default: trueRange: —

Open PDFs As Text

booleanBy default, PDFs are considered text files and so may be opened and searched along with all other text files. To have PDFs treated as a special file type - (they will be ignored for any operation that requires a text file - set this to 'false'.Default: falseRange: —

Perform Line Feed Translation

boolean—Default: trueRange: —

Precompose Unicode When Pasting

booleanIf you find that you frequently need to bring in text which contains combining Unicode characters (as are frequently found in PDFs generated on other platforms, for example), it can be desirable to preprocess the combining characters into one composed character where possible. This is not a general need, but if you run into it often enough, you can tell BBEdit to combine the characters for you by setting this preference to 'true'. Despite the name, the precomposition is done when BBEdit imports the Clipboard from other applications, not when the paste is actually done. Note that this requires an additional copy of the Clipboard when the application imports the text, and for very large pastes, there may be a noticeable delay while the text gets precomposed. Thus, you should only turn on this setting when you are frequently working with text that contains combining Unicode charactersDefault: falseRange: —

Prefer Editor Config Tab Width

boolean—Default: trueRange: —

Pretty Print Pasted HTML

boolean—Default: trueRange: —

Projects Allow Volume Mount When Reopening

boolean—Default: trueRange: —

Projects Open Items On Single Click

booleanProject windows will ordinarily open an item in the file list for editing when you click on it and the editing view is visible. To require a double-click, set this to 'false'.Default: trueRange: —

Projects Remember Open Documents

boolean—Default: trueRange: —

Provide STDIN To Unix Scripts

booleanBBEdit provides the selection range in the active document (or the active document's contents, if there is no selection) as stdin when running a Unix script or executable from the Scripts menu. If the script isn't expecting this and never reads from stdin, this can cause a problem if there is more than 64K of data provided. The result will usually be a 100032 error. If this is a regular occurrence for you, you can turn the feature off.Default: trueRange: —

Recent Items: Remember ## Folders

integerThe "Remember the … most recently used items" setting in the Application preferences applies to all item types. So, if it's set to 15, BBEdit will remember 15 text documents, 15 folders, 15 projects, 15 images, and so on. If you want finer control, you can construct an expert pref using the name of the document type as it appears in the menu, and if that name contains spaces, you'll need to quote it. If you don't want to remember any recent documents of a particular type - they won't appear in the menu, either -, you can set its limit to 0Default: 15Range: —

Recent Items: Remember ## Images

integerThe "Remember the … most recently used items" setting in the Application preferences applies to all item types. So, if it's set to 15, BBEdit will remember 15 text documents, 15 folders, 15 projects, 15 images, and so on. If you want finer control, you can construct an expert pref using the name of the document type as it appears in the menu, and if that name contains spaces, you'll need to quote it. If you don't want to remember any recent documents of a particular type - they won't appear in the menu, either -, you can set its limit to 0Default: 15Range: —

Recent Items: Remember ## Projects

integerThe "Remember the … most recently used items" setting in the Application preferences applies to all item types. So, if it's set to 15, BBEdit will remember 15 text documents, 15 folders, 15 projects, 15 images, and so on. If you want finer control, you can construct an expert pref using the name of the document type as it appears in the menu, and if that name contains spaces, you'll need to quote it. If you don't want to remember any recent documents of a particular type - they won't appear in the menu, either -, you can set its limit to 0Default: 15Range: —

Recent Items: Remember ## Shell Worksheets

integerThe "Remember the … most recently used items" setting in the Application preferences applies to all item types. So, if it's set to 15, BBEdit will remember 15 text documents, 15 folders, 15 projects, 15 images, and so on. If you want finer control, you can construct an expert pref using the name of the document type as it appears in the menu, and if that name contains spaces, you'll need to quote it. If you don't want to remember any recent documents of a particular type - they won't appear in the menu, either -, you can set its limit to 0Default: 15Range: —

Recent Items: Remember Temp Files

booleanBy default, BBEdit does not remember recent items opened from any of the canonical locations for temporary files. This also includes the "svn-commit.tmp" files used for Subversion commits. If desired, you can change this by setting this to 'true'.Default: falseRange: —

Remember FTP Passwords

boolean—Default: trueRange: —

Replace All Results Include Timing

booleanIf you want to amaze and impress your friends and family with just how fast BBEdit's "Replace All" is, set this to 'true'. When set to 'true', the sheet, or growl notification, will display the amount of time required for the "Replace All" operation.Default: falseRange: —

Report Nonzero Exit Code From Unix Filters

boolean—Default: trueRange: —

Report Replace All Results

booleanWhen performing a single-file "Replace All" operation, BBEdit can show a confirmation sheet showing the number of replacements performed. If you would like to see this confirmation, set this to 'true'.Default: falseRange: —

Reuse Search Results Windows When Possible

boolean—Default: trueRange: —

Reverse Swipe Navigation Sense

boolean—Default: falseRange: —

Run Unix Command: History Limit

integer—Default: 16Range: —

Run Using Python3

booleanWhen running a Python script, if python3 is anywhere in your $PATH, BBEdit will use it instead of python. While this is generally useful in a teaching environment, if you are using a custom Python installation (such as Anaconda), it may prove inconvenient.Default: trueRange: —

Safe Saves Disabled

boolean—Default: trueRange: —

Save Document State

boolean—Default: trueRange: —
booleanBy default, BBEdit will not store document state for documents located in any of the canonical locations for temporary files. This also includes the "svn-commit.tmp" files used for Subversion commits. If you wish, you can change this by setting this to 'true'.Default: falseRange: —

Save Open With Data In Typeless Files

booleanPrevent BBEdit from adding a filename extension.Default: trueRange: —

Save Titled Documents Before Sleeping

booleanThe "Sleep" command does not save any documents in place, since it creates an auto-save file for any open documents with unsaved changes. However, if you want BBEdit to save any titled - i.e. opened from an existing file - documents to disk before sleeping, you can set this preference to 'true'.Default: falseRange: —

Scan HTML Strings For Functions

boolean—Default: falseRange: —

Scan HTML Strings For Functions (Python)

boolean—Default: trueRange: —

Script Editor Bundle ID

stringBy default, BBEdit will open AppleScript files using whatever application the OS claims is capable of doing so. If you wish to override this, change the "ScriptEditorBundleID" preference to the bundle ID of your preferred script editor.Default: "com.apple.ScriptEditor2"Range: —

Select First Placeholder In Completions

boolean—Default: trueRange: —

SFTP Connection Timeout

integerMost of the time, the default timeout for connecting to an SFTP server will suffice; however, if the server is heavily loaded it may take longer to respond.Default: 20Range: —

Show Anonymous Functions (ActionScript)

boolean—Default: trueRange: —

Show Anonymous Functions (JavaScript)

boolean—Default: trueRange: —

Show FTP Dot Files

boolean—Default: falseRange: —

Show Full Paths In Search Results

booleanIf you like BBEdit to show the full paths of files listed in search results windows, set this to 'true'.Default: falseRange: —

Show Git Ignored Command Is Visible

boolean—Default: trueRange: —

Show Language Setting In Shell Worksheets

boolean—Default: falseRange: —

Show SCM Data Command Is Visible

boolean—Default: falseRange: —

Show SVN Switched Items

boolean"Show Working Copy Status" for svn does not include switched items. If this affects you and you would prefer to see switched items, you may make them visibile by setting this to 'true'.Default: falseRange: —

Show Variables In Function List (PHP)

boolean—Default: falseRange: —

Skip Node Modules When Scanning Folders

booleanWhen scanning folders for various purposes (multi-file search, Find Differences, text factories, Open File by Name, and others), BBEdit will not explore node_modules directories that it encounters. If you want BBEdit to search node_modules directories turn this off.Default: falseRange: —

Skip SCM Admin Dirs When Scanning Folders

booleanWhen scanning folders for various purposes - multi-file search, Find differences, and others -, SCM administrative directories are specifically ignored, even if "Search Invisible Folders" is turned on: CVS, .svn, .git, .hg, .bzr. This avoids potential disasters that can result from indiscriminate search and replace in such directories. If, however, you choose to live dangerously, you can allow BBEdit to see inside of these directories by setting this to 'false'.Default: trueRange: —

Sort Completion Results By Name

boolean—Default: trueRange: —

Sort Windows And Documents By Name

booleanThe Window menu and Windows palette will list windows (and documents within them) sorted by name. If you would like them to be sorted by windowing order turn this off.Default: trueRange: —

Spell Checker Context Menu Timeout

integer—Default: 750Range: —

Spelling Word Completion Threshold

integer—Default: 3Range: —

SSH Server Keepalive Interval

integerIf you have problems with your SSH server closing the connection after a period of non-use (which will subsequently cause errors in BBEdit), you can tell BBEdit to send a periodic "keepalive" message to while connected to the server. This is configurable per host, per domain, or globally. Determining the appropriate value may require some experimentation, but 90 seconds is probably a good starting point.Default: 0Range: —

Strict Counterpart Matching For C Languages

boolean—Default: trueRange: —

Surf Next Previous In Display Order

booleanWhen using the "Previous Document" and "Next Document" commands on the View menu, or the navigation arrows in the navigation bar, the order in which BBEdit navigates documents is determined by the order in which they were opened. If you prefer, these commands can be made to navigate the documents in the order shown in the file list by setting this to 'true'.Default: falseRange: —

Swipe To Navigate Between Documents

boolean—Default: trueRange: —

Terminal Bundle ID

stringThe "Run in Terminal" and "Go Here in Terminal" commands will use Apple's "Terminal" application by default. If you would like to use a different one, set this here.Default: "com.apple.Terminal"Range: —

Throttle Vertical Scrolling Speed

booleanWhile drag-scrolling (that is, making a selection with the mouse and dragging it beyond the view boundaries, or using drag-and-drop for the same purpose), BBEdit will not normally limit the vertical scrolling speed. If this is too fast for you turn this off.Default: trueRange: —

Translate Line Breaks In Keyboard Input

boolean—Default: trueRange: —

Use $PATH For SSH

boolean—Default: trueRange: —

Use Clippings For Completion

booleanIf there is a partial word to the immediate left of the insertion point, the "Insert Clipping..." command will attempt to autocomplete that word based clipping names in the current and universal set (using a "begins with" style match.) If you wish to disable the autocompletion, set this preference to 'false'.Default: trueRange: —

Use Color Scheme Background For Dark Mode Ul

boolean—Default: trueRange: —

Use Dash For Reference Lookups

booleanIf Dash is installed, BBEdit will use it for "Find in Reference", in preference to any predefined or custom reference lookup URLs. You could, if you wanted, turn off Dash support by default and then enable it for specific languages.Default: trueRange: —

Use Distinct Colors For HTML Attributes And Values

boolean—Default: trueRange: —

Use Flake For Python Syntax Checking

booleanThe Python language module will use flake8 for syntax checking, if you have it installed and it is available in your $PATH. If you want to disable this and use Python’s built-in syntax checking turn this off.Default: trueRange: —

Use Flake For Python Syntax Checking (Python)

boolean—Default: trueRange: —

Use Inline Styles For Copied HTML

booleanThe "Copy as Styled HTML" and "Save as Styled HTML" commands normally generate style information inline. If you want to use an embedded style sheet instead, set this to 'false'.Default: trueRange: —

Use Numeric Keypad For Cursor Movement

boolean—Default: falseRange: —

Use Resource Fork For Document State

booleanBeginning with version 8.0, BBEdit stores document state (window position and various settings) in a central repository in your BBEdit preferences folder. If you wish, you can ask BBEdit to store document state in the resource fork of the document's file by setting this to 'true'.Default: falseRange: —

Use Separators In Unix Script Output

booleanOrdinarily, the output from Unix scripts run within BBEdit is delimited with line separators - except when the script output is sent to a new untitled document. If you wish to suppress the separators, you can set this to 'false'.Default: trueRange: —

Use System Font For Line Bar

booleanBBEdit uses the document's display font to draw line numbers in the line number bar. This may be less than ideal if the display font isn't monospaced. If desired, you can instruct BBEdit to use the system font with monospaced numbers for the line number bar.Default: falseRange: —

Use Tab Key As Completion Trigger

booleanTo use the Tab key to trigger text completion, set this preference to 'true'.Default: falseRange: —

Use Tokens From Document For Completion

boolean—Default: trueRange: —

Use XML Markup Rules For HTML5

booleanOrdinarily, BBEdit will generate XHTML-style markup in HTML5 documents (those with a "<!DOCTYPE HTML>" declaration). If you wish, you can suppress this by setting this to 'false'.Default: trueRange: —

Visible Search Sources: Configured Web Sites

boolean—Default: trueRange: —

Visible Search Sources: Disk Browsers

boolean—Default: trueRange: —

Visible Search Sources: Frontmost Project

boolean—Default: trueRange: —

Visible Search Sources: Open Documents

boolean—Default: trueRange: —

Visible Search Sources: Projects

boolean—Default: trueRange: —

Visible Search Sources: Recent Folders

boolean—Default: trueRange: —

Visible Search Sources: Recent Xcode Projects

boolean—Default: trueRange: —

Visible Search Sources: Results Browsers

boolean—Default: trueRange: —

Visible Search Sources: Saved Search Sets

boolean—Default: trueRange: —

Visible Search Sources: Saved Spotlight Searches

boolean—Default: trueRange: —

Warn Malformed UTF8

booleanTo control whether BBEdit warns you when opening a malformed UTF-8 file, set this to 'true'.Default: trueRange: —

Visible Search Sources: Saved Spotlight Searches

boolean—Default: trueRange: —

Worksheet Notification Minimum Run Time

integer—Default: 10Range: —

Visible Search Sources: Saved Spotlight Searches

boolean—Default: falseRange: —

Write Extended Attributes

stringBy default, BBEdit will avoid writing extended attributes - HFS Type/Creator - to volumes which don't natively support them - i.e. to avoid creating the ._FILE - when it is safe to do so. We'll be able to re-open the document correctly later. If desired, you can fine-tune this behavior.Default: "Smart"Range: Always: Always write the HFS file type and creator (the pre-8.6 behavior) (Always), Never: Never set the HFS file type and creator (even if the document’s volume supports it) (Never), Smart: Write HFS file type and creator only if the document’s volume supports it (Smart)

Zoom Windows In Place

booleanBBEdit attempts to move windows as little as possible when you zoom them. To override this and let BBEdit place the window in the upper left-hand corner of the screen, set this to 'false'.Default: trueRange: —

Move All Window types to active space

booleanWhen using Spaces, you can control whether BBEdit's modeless dialog boxes - Find, Multi-File Search, and Open File by Name - get moved to the active space when switching spaces. By default, this is allowed for the Find, Multi-File Search, and Open File by Name windows. To control whether windows of these types are moved to the active space, set this to 'true'. This preference sets the default behavior for any of the defined window types for which a default is not explicitly specified. This key has been removed from BBEdit as of version 15. This has been replaced with MoveModelessWindowToActiveSpace.Default: falseRange: —

Move Find Window to Active Space

booleanWhen using Spaces, you can control whether BBEdit's modeless dialog boxes - Find, Multi-File Search, and Open File by Name - get moved to the active space when switching spaces. By default, this is allowed for the Find, Multi-File Search, and Open File by Name windows. To control whether windows of these types are moved to the active space, set this to 'true'. This key has been removed from BBEdit as of version 15. This has been replaced with MoveModelessWindowToActiveSpace.Default: falseRange: —

Move Multi-File Find Window to Active Space

booleanWhen using Spaces, you can control whether BBEdit's modeless dialog boxes - Find, Multi-File Search, and Open File by Name - get moved to the active space when switching spaces. By default, this is allowed for the Find, Multi-File Search, and Open File by Name windows. To control whether windows of these types are moved to the active space, set this to 'true'. This key has been removed from BBEdit as of version 15. This has been replaced with MoveModelessWindowToActiveSpace.Default: falseRange: —

Move Open File by Name Window to active space

booleanWhen using Spaces, you can control whether BBEdit's modeless dialog boxes - Find, Multi-File Search, and Open File by Name - get moved to the active space when switching spaces. By default, this is allowed for the Find, Multi-File Search, and Open File by Name windows. To control whether windows of these types are moved to the active space, set this to 'true'. This key has been removed from BBEdit as of version 15. This has been replaced with MoveModelessWindowToActiveSpace.Default: falseRange: —
booleanBBEdit ordinarily recognizes image files as images, and will open them into image windows (or ignore them when filtering for text files). To have images possibly treated as text files, which can be potentially dangerous, set this to 'false'. This key has been removed from BBEdit as of version 15.Default: trueRange: —

Reopen Remote Documents

booleanIf set to 'true', BBEdit will attempt to mount a volume containing a document it wants to reopen. Defaults to 'false'. This key has been removed from BBEdit as of version 15. This has been replaced with ReopenDocumentsOnRemoteVolumes.Default: falseRange: —

Automatic Update Install Prompt

booleanControls the automatic update install prompt. When enabled, presents users with the option to allow automatic download and install of available updates. If disabled, disallows automatic updates and requires manual installation every time.Default: trueRange: —

Enable Automatic Silent Updates

booleanControls automatic silent updates. If enabled, users will not be informed about updates and updates will be silently installed when the app quits.Default: falseRange: —

Enable Automatic Update Checks

booleanControls automatic update checks.Default: trueRange: —
SUFeedURLstring

Sparkle Feed URL

stringSetting this to a non-existent URL will disable the ability for users to manually check for updates. Useful when you intend to use your own software distribution mechanism to deploy updates.Default: —Range: —

Automatic Update Check Interval

integerControls the automatic update check interval. The default is 1 day (86400 seconds). Setting to 0 disables updates.Default: 86400Range: —