title: All Settings description: "Complete reference for all Zed settings."
All Settings
This is the complete reference for all Zed settings.
You may also want to change your theme, configure your key bindings, set up tasks, or install extensions.
Settings
The sections below document supported Zed settings.
Active Pane Modifiers
- Description: Styling settings applied to the active pane.
- Setting:
active_pane_modifiers - Default:
{
"active_pane_modifiers": {
"border_size": 0.0,
"inactive_opacity": 1.0
}
}
Border size
- Description: Size of the border surrounding the active pane. When set to 0, the active pane doesn't have any border. The border is drawn inset.
- Setting:
border_size - Default:
0.0
Options
Non-negative float values
Inactive Opacity
- Description: Opacity of inactive panels. When set to 1.0, inactive panes have the same opacity as the active pane. If set to 0, inactive pane content is not visible. Values are clamped to the [0.0, 1.0] range.
- Setting:
inactive_opacity - Default:
1.0
Options
float values
Bottom Dock Layout
- Description: Control the layout of the bottom dock, relative to the left and right docks.
- Setting:
bottom_dock_layout - Default:
"contained"
Options
- Contain the bottom dock, giving the full height of the window to the left and right docks.
{
"bottom_dock_layout": "contained"
}
- Give the bottom dock the full width of the window, truncating the left and right docks.
{
"bottom_dock_layout": "full"
}
- Left align the bottom dock, truncating the left dock and giving the right dock the full height of the window.
{
"bottom_dock_layout": "left_aligned"
}
- Right align the bottom dock, giving the left dock the full height of the window and truncating the right dock.
{
"bottom_dock_layout": "right_aligned"
}
Agent Font Size
- Description: The font size for text in the agent panel. Inherits the UI font size if unset.
- Setting:
agent_font_size - Default:
null
Options
integer values from 6 to 100 pixels (inclusive)
Allow Rewrap
- Description: Controls where the {#action editor::Rewrap} action is allowed in the current language scope
- Setting:
allow_rewrap - Default:
"in_comments"
Options
- Allow rewrap in comments only:
{
"allow_rewrap": "in_comments"
}
- Allow rewrap in selections only:
{
"allow_rewrap": "in_selections"
}
- Allow rewrap anywhere:
{
"allow_rewrap": "anywhere"
}
Note: This setting has no effect in Vim mode, as rewrap is already allowed everywhere.
Auto Indent
- Description: Whether indentation should be adjusted based on context while typing. This can be specified on a per-language basis.
- Setting:
auto_indent - Default:
true
Options
boolean values
Auto Indent On Paste
- Description: Whether indentation of pasted content should be adjusted based on the context
- Setting:
auto_indent_on_paste - Default:
true
Options
boolean values
Auto Install extensions
- Description: Define extensions to install automatically or never install.
- Setting:
auto_install_extensions - Default:
{ "html": true }
Options
You can find the names of your currently installed extensions by listing the subfolders under the extension installation location:
On macOS:
ls ~/Library/Application\ Support/Zed/extensions/installed/
On Linux:
ls ~/.local/share/zed/extensions/installed
Define extensions which should be installed (true) or never installed (false).
{
"auto_install_extensions": {
"html": true,
"dockerfile": true,
"docker-compose": false
}
}
Autosave
- Description: When to automatically save edited buffers.
- Setting:
autosave - Default:
off
Options
- To disable autosave, set it to
off:
{
"autosave": "off"
}
- To autosave when focus changes, use
on_focus_change:
{
"autosave": "on_focus_change"
}
- To autosave when the active window changes, use
on_window_change:
{
"autosave": "on_window_change"
}
- To autosave after an inactivity period, use
after_delay:
{
"autosave": {
"after_delay": {
"milliseconds": 1000
}
}
}
Note that a save will be triggered when an unsaved tab is closed, even if this is earlier than the configured inactivity period.
Autoscroll on Clicks
- Description: Whether to scroll when clicking near the edge of the visible text area.
- Setting:
autoscroll_on_clicks - Default:
false
Options
boolean values
Auto Signature Help
- Description: Show method signatures in the editor when inside parentheses.
- Setting:
auto_signature_help - Default:
false
Options
boolean values
Show Signature Help After Edits
- Description: Whether to show the signature help after completion or a bracket pair inserted. If
auto_signature_helpis enabled, this setting will be treated as enabled also. - Setting:
show_signature_help_after_edits - Default:
false
Options
boolean values
Auto Update
- Description: Whether or not to automatically check for updates.
- Setting:
auto_update - Default:
true
Options
boolean values
Base Keymap
- Description: Base key bindings scheme. Base keymaps can be overridden with user keymaps.
- Setting:
base_keymap - Default:
VSCode
Options
- VS Code
{
"base_keymap": "VSCode"
}
- Atom
{
"base_keymap": "Atom"
}
- JetBrains
{
"base_keymap": "JetBrains"
}
- None
{
"base_keymap": "None"
}
- Sublime Text
{
"base_keymap": "SublimeText"
}
- TextMate
{
"base_keymap": "TextMate"
}
Buffer Font Family
- Description: The name of a font to use for rendering text in the editor.
- Setting:
buffer_font_family - Default:
.ZedMono. This currently aliases to Lilex.
Options
The name of any font family installed on the user's system, or ".ZedMono".
Buffer Font Features
- Description: The OpenType features to enable for text in the editor.
- Setting:
buffer_font_features - Default:
null - Platform: macOS and Windows.
Options
Zed supports all OpenType features that can be enabled or disabled for a given buffer or terminal font, as well as setting values for font features.
For example, to disable font ligatures, add the following to your settings:
{
"buffer_font_features": {
"calt": false
}
}
You can also set other OpenType features, like setting cv01 to 7:
{
"buffer_font_features": {
"cv01": 7
}
}
Buffer Font Fallbacks
- Description: Set the buffer text's font fallbacks, this will be merged with the platform's default fallbacks.
- Setting:
buffer_font_fallbacks - Default:
null - Platform: macOS and Windows.
Options
For example, to use Nerd Font as a fallback, add the following to your settings:
{
"buffer_font_fallbacks": ["Nerd Font"]
}
Buffer Font Size
- Description: The default font size for text in the editor.
- Setting:
buffer_font_size - Default:
15
Options
A font size from 6 to 100 pixels (inclusive)
Buffer Font Weight
- Description: The default font weight for text in the editor.
- Setting:
buffer_font_weight - Default:
400
Options
integer values between 100 and 900
Buffer Line Height
- Description: The default line height for text in the editor.
- Setting:
buffer_line_height - Default:
"comfortable"
Options
"standard", "comfortable" or { "custom": float } (1 is compact, 2 is loose)
Centered Layout
- Description: Configuration for the centered layout mode.
- Setting:
centered_layout - Default:
{
"centered_layout": {
"left_padding": 0.2,
"right_padding": 0.2
}
}
Options
The left_padding and right_padding options define the relative width of the
left and right padding of the central pane from the workspace when the centered layout mode is activated. Valid values range is from 0 to 0.4.
Close on File Delete
- Description: Whether to automatically close editor tabs when their corresponding files are deleted from disk.
- Setting:
close_on_file_delete - Default:
false
Options
boolean values
When enabled, this setting will automatically close tabs for files that have been deleted from the file system. This is particularly useful for workflows involving temporary or scratch files that are frequently created and deleted. When disabled (default), deleted files remain open with a strikethrough through their tab title.
Note: Dirty files (files with unsaved changes) will not be automatically closed even when this setting is enabled, ensuring you don't lose unsaved work.
Confirm Quit
- Description: Whether or not to prompt the user to confirm before closing the application.
- Setting:
confirm_quit - Default:
false
Options
boolean values
Diagnostics Max Severity
- Description: Which level to use to filter out diagnostics displayed in the editor
- Setting:
diagnostics_max_severity - Default:
null
Options
- Allow all diagnostics (default):
{
"diagnostics_max_severity": "all"
}
- Show only errors:
{
"diagnostics_max_severity": "error"
}
- Show errors and warnings:
{
"diagnostics_max_severity": "warning"
}
- Show errors, warnings, and information:
{
"diagnostics_max_severity": "info"
}
Lines 1–500 of 5396. Load more
--- title: All Settings description: "Complete reference for all Zed settings." --- # All Settings This is the complete reference for all Zed settings. You may also want to change your [theme](../themes.md), configure your [key bindings](../key-bindings.md), set up [tasks](../tasks.md), or install [extensions](../extensions.md). # Settings The sections below document supported Zed settings. ## Active Pane Modifiers - Description: Styling settings applied to the active pane. - Setting: `active_pane_modifiers` - Default: ```json [settings] { "active_pane_modifiers": { "border_size": 0.0, "inactive_opacity": 1.0 } } ``` ### Border size - Description: Size of the border surrounding the active pane. When set to 0, the active pane doesn't have any border. The border is drawn inset. - Setting: `border_size` - Default: `0.0` **Options** Non-negative `float` values ### Inactive Opacity - Description: Opacity of inactive panels. When set to 1.0, inactive panes have the same opacity as the active pane. If set to 0, inactive pane content is not visible. Values are clamped to the [0.0, 1.0] range. - Setting: `inactive_opacity` - Default: `1.0` **Options** `float` values ## Bottom Dock Layout - Description: Control the layout of the bottom dock, relative to the left and right docks. - Setting: `bottom_dock_layout` - Default: `"contained"` **Options** 1. Contain the bottom dock, giving the full height of the window to the left and right docks. ```json [settings] { "bottom_dock_layout": "contained" } ``` 2. Give the bottom dock the full width of the window, truncating the left and right docks. ```json [settings] { "bottom_dock_layout": "full" } ``` 3. Left align the bottom dock, truncating the left dock and giving the right dock the full height of the window. ```json [settings] { "bottom_dock_layout": "left_aligned" } ``` 4. Right align the bottom dock, giving the left dock the full height of the window and truncating the right dock. ```json [settings] { "bottom_dock_layout": "right_aligned" } ``` ## Agent Font Size - Description: The font size for text in the agent panel. Inherits the UI font size if unset. - Setting: `agent_font_size` - Default: `null` **Options** `integer` values from `6` to `100` pixels (inclusive) ## Allow Rewrap - Description: Controls where the {#action editor::Rewrap} action is allowed in the current language scope - Setting: `allow_rewrap` - Default: `"in_comments"` **Options** 1. Allow rewrap in comments only: ```json [settings] { "allow_rewrap": "in_comments" } ``` 2. Allow rewrap in selections only: ```json [settings] { "allow_rewrap": "in_selections" } ``` 3. Allow rewrap anywhere: ```json [settings] { "allow_rewrap": "anywhere" } ``` Note: This setting has no effect in Vim mode, as rewrap is already allowed everywhere. ## Auto Indent - Description: Whether indentation should be adjusted based on context while typing. This can be specified on a per-language basis. - Setting: `auto_indent` - Default: `true` **Options** `boolean` values ## Auto Indent On Paste - Description: Whether indentation of pasted content should be adjusted based on the context - Setting: `auto_indent_on_paste` - Default: `true` **Options** `boolean` values ## Auto Install extensions - Description: Define extensions to install automatically or never install. - Setting: `auto_install_extensions` - Default: `{ "html": true }` **Options** You can find the names of your currently installed extensions by listing the subfolders under the [extension installation location](../extensions/installing-extensions.md#installation-location): On macOS: ```sh ls ~/Library/Application\ Support/Zed/extensions/installed/ ``` On Linux: ```sh ls ~/.local/share/zed/extensions/installed ``` Define extensions which should be installed (`true`) or never installed (`false`). ```json [settings] { "auto_install_extensions": { "html": true, "dockerfile": true, "docker-compose": false } } ``` ## Autosave - Description: When to automatically save edited buffers. - Setting: `autosave` - Default: `off` **Options** 1. To disable autosave, set it to `off`: ```json [settings] { "autosave": "off" } ``` 2. To autosave when focus changes, use `on_focus_change`: ```json [settings] { "autosave": "on_focus_change" } ``` 3. To autosave when the active window changes, use `on_window_change`: ```json [settings] { "autosave": "on_window_change" } ``` 4. To autosave after an inactivity period, use `after_delay`: ```json [settings] { "autosave": { "after_delay": { "milliseconds": 1000 } } } ``` Note that a save will be triggered when an unsaved tab is closed, even if this is earlier than the configured inactivity period. ## Autoscroll on Clicks - Description: Whether to scroll when clicking near the edge of the visible text area. - Setting: `autoscroll_on_clicks` - Default: `false` **Options** `boolean` values ## Auto Signature Help - Description: Show method signatures in the editor when inside parentheses. - Setting: `auto_signature_help` - Default: `false` **Options** `boolean` values ### Show Signature Help After Edits - Description: Whether to show the signature help after completion or a bracket pair inserted. If `auto_signature_help` is enabled, this setting will be treated as enabled also. - Setting: `show_signature_help_after_edits` - Default: `false` **Options** `boolean` values ## Auto Update - Description: Whether or not to automatically check for updates. - Setting: `auto_update` - Default: `true` **Options** `boolean` values ## Base Keymap - Description: Base key bindings scheme. Base keymaps can be overridden with user keymaps. - Setting: `base_keymap` - Default: `VSCode` **Options** 1. VS Code ```json [settings] { "base_keymap": "VSCode" } ``` 2. Atom ```json [settings] { "base_keymap": "Atom" } ``` 3. JetBrains ```json [settings] { "base_keymap": "JetBrains" } ``` 4. None ```json [settings] { "base_keymap": "None" } ``` 5. Sublime Text ```json [settings] { "base_keymap": "SublimeText" } ``` 6. TextMate ```json [settings] { "base_keymap": "TextMate" } ``` ## Buffer Font Family - Description: The name of a font to use for rendering text in the editor. - Setting: `buffer_font_family` - Default: `.ZedMono`. This currently aliases to [Lilex](https://lilex.myrt.co). **Options** The name of any font family installed on the user's system, or `".ZedMono"`. ## Buffer Font Features - Description: The OpenType features to enable for text in the editor. - Setting: `buffer_font_features` - Default: `null` - Platform: macOS and Windows. **Options** Zed supports all OpenType features that can be enabled or disabled for a given buffer or terminal font, as well as setting values for font features. For example, to disable font ligatures, add the following to your settings: ```json [settings] { "buffer_font_features": { "calt": false } } ``` You can also set other OpenType features, like setting `cv01` to `7`: ```json [settings] { "buffer_font_features": { "cv01": 7 } } ``` ## Buffer Font Fallbacks - Description: Set the buffer text's font fallbacks, this will be merged with the platform's default fallbacks. - Setting: `buffer_font_fallbacks` - Default: `null` - Platform: macOS and Windows. **Options** For example, to use `Nerd Font` as a fallback, add the following to your settings: ```json [settings] { "buffer_font_fallbacks": ["Nerd Font"] } ``` ## Buffer Font Size - Description: The default font size for text in the editor. - Setting: `buffer_font_size` - Default: `15` **Options** A font size from `6` to `100` pixels (inclusive) ## Buffer Font Weight - Description: The default font weight for text in the editor. - Setting: `buffer_font_weight` - Default: `400` **Options** `integer` values between `100` and `900` ## Buffer Line Height - Description: The default line height for text in the editor. - Setting: `buffer_line_height` - Default: `"comfortable"` **Options** `"standard"`, `"comfortable"` or `{ "custom": float }` (`1` is compact, `2` is loose) ## Centered Layout - Description: Configuration for the centered layout mode. - Setting: `centered_layout` - Default: ```json [settings] { "centered_layout": { "left_padding": 0.2, "right_padding": 0.2 } } ``` **Options** The `left_padding` and `right_padding` options define the relative width of the left and right padding of the central pane from the workspace when the centered layout mode is activated. Valid values range is from `0` to `0.4`. ## Close on File Delete - Description: Whether to automatically close editor tabs when their corresponding files are deleted from disk. - Setting: `close_on_file_delete` - Default: `false` **Options** `boolean` values When enabled, this setting will automatically close tabs for files that have been deleted from the file system. This is particularly useful for workflows involving temporary or scratch files that are frequently created and deleted. When disabled (default), deleted files remain open with a strikethrough through their tab title. Note: Dirty files (files with unsaved changes) will not be automatically closed even when this setting is enabled, ensuring you don't lose unsaved work. ## Confirm Quit - Description: Whether or not to prompt the user to confirm before closing the application. - Setting: `confirm_quit` - Default: `false` **Options** `boolean` values ## Diagnostics Max Severity - Description: Which level to use to filter out diagnostics displayed in the editor - Setting: `diagnostics_max_severity` - Default: `null` **Options** 1. Allow all diagnostics (default): ```json [settings] { "diagnostics_max_severity": "all" } ``` 2. Show only errors: ```json [settings] { "diagnostics_max_severity": "error" } ``` 3. Show errors and warnings: ```json [settings] { "diagnostics_max_severity": "warning" } ``` 4. Show errors, warnings, and information: ```json [settings] { "diagnostics_max_severity": "info" }