1# Configuring Zed
   2
   3Zed is designed to be configured: we want to fit your workflow and preferences exactly. We provide default settings that are designed to be a comfortable starting point for as many people as possible, but we hope you will enjoy tweaking it to make it feel incredible.
   4
   5In addition to the settings described here, 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](https://github.com/zed-industries/extensions).
   6
   7## Settings Editor
   8
   9You can browse through many of the supported settings via the Settings Editor, which can be opened with the {#kb zed::OpenSettings} keybinding, or through the `zed: open settings` action in the command palette. Through it, you can customize your local, user settings as well as project settings.
  10
  11> Note that not all settings that Zed supports are available through the Settings Editor yet.
  12> Some more intricate ones, such as language formatters, can only be changed through the JSON settings file {#kb zed::OpenSettingsFile}.
  13
  14## User Settings File
  15
  16<!--
  17TBD: Settings files. Rewrite with "remote settings" in mind (e.g. `local settings` on the remote host).
  18Consider renaming `zed: Open Local Settings` to `zed: Open Project Settings`.
  19
  20TBD: Add settings documentation about how settings are merged as overlays. E.g. project>local>default. Note how settings that are maps are merged, but settings that are arrays are replaced and must include the defaults.
  21-->
  22
  23Your settings JSON file can be opened with {#kb zed::OpenSettingsFile}.
  24By default it is located at `~/.config/zed/settings.json`, though if you have `XDG_CONFIG_HOME` in your environment on Linux it will be at `$XDG_CONFIG_HOME/zed/settings.json` instead.
  25
  26Whatever you have added to your user settings file gets merged with any local configuration inside your projects.
  27
  28### Default Settings
  29
  30In the Settings Editor, the values you see set are the default ones.
  31You can also verify them in JSON by running {#action zed::OpenDefaultSettings} from the command palette.
  32
  33Extensions that provide language servers may also provide default settings for those language servers.
  34
  35## Project Settings File
  36
  37Similarly to user files, you can open your project settings file by running {#action zed::OpenProjectSettings} from the command palette.
  38This will create a `.zed` directory containing`.zed/settings.json`.
  39
  40Although most projects will only need one settings file at the root, you can add more local settings files for subdirectories as needed.
  41Not all settings can be set in local files, just those that impact the behavior of the editor and language tooling.
  42For example you can set `tab_size`, `formatter` etc. but not `theme`, `vim_mode` and similar.
  43
  44The syntax for configuration files is a super-set of JSON that allows `//` comments.
  45
  46## Per-release Channel Overrides
  47
  48Zed reads the same `settings.json` across all release channels (Stable, Preview or Nightly).
  49However, you can scope overrides to a specific channel by adding top-level `stable`, `preview`, `nightly` or `dev` objects.
  50They are merged into the base configuration with settings from these keys taking precedence upon launching the specified build. For example:
  51
  52```json [settings]
  53{
  54  "theme": "sunset",
  55  "vim_mode": false,
  56  "nightly": {
  57    "theme": "cave-light",
  58    "vim_mode": true
  59  },
  60  "preview": {
  61    "theme": "zed-dark"
  62  }
  63}
  64```
  65
  66With this configuration, Stable keeps all base preferences, Preview switches to `zed-dark`, and Nightly enables Vim mode with a different theme.
  67
  68Changing settings in the Settings Editorwill always apply the change across all channels.
  69
  70# Settings
  71
  72Find below an extensive run-through of many supported settings by Zed.
  73
  74## Active Pane Modifiers
  75
  76- Description: Styling settings applied to the active pane.
  77- Setting: `active_pane_modifiers`
  78- Default:
  79
  80```json [settings]
  81{
  82  "active_pane_modifiers": {
  83    "border_size": 0.0,
  84    "inactive_opacity": 1.0
  85  }
  86}
  87```
  88
  89### Border size
  90
  91- 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.
  92- Setting: `border_size`
  93- Default: `0.0`
  94
  95**Options**
  96
  97Non-negative `float` values
  98
  99### Inactive Opacity
 100
 101- Description: Opacity of inactive panels. When set to 1.0, the inactive panes have the same opacity as the active one. If set to 0, the inactive panes content will not be visible at all. Values are clamped to the [0.0, 1.0] range.
 102- Setting: `inactive_opacity`
 103- Default: `1.0`
 104
 105**Options**
 106
 107`float` values
 108
 109## Bottom Dock Layout
 110
 111- Description: Control the layout of the bottom dock, relative to the left and right docks.
 112- Setting: `bottom_dock_layout`
 113- Default: `"contained"`
 114
 115**Options**
 116
 1171. Contain the bottom dock, giving the full height of the window to the left and right docks.
 118
 119```json [settings]
 120{
 121  "bottom_dock_layout": "contained"
 122}
 123```
 124
 1252. Give the bottom dock the full width of the window, truncating the left and right docks.
 126
 127```json [settings]
 128{
 129  "bottom_dock_layout": "full"
 130}
 131```
 132
 1333. Left align the bottom dock, truncating the left dock and giving the right dock the full height of the window.
 134
 135```json [settings]
 136{
 137  "bottom_dock_layout": "left_aligned"
 138}
 139```
 140
 1414. Right align the bottom dock, giving the left dock the full height of the window and truncating the right dock.
 142
 143```json [settings]
 144{
 145  "bottom_dock_layout": "right_aligned"
 146}
 147```
 148
 149## Agent Font Size
 150
 151- Description: The font size for text in the agent panel. Inherits the UI font size if unset.
 152- Setting: `agent_font_size`
 153- Default: `null`
 154
 155**Options**
 156
 157`integer` values from `6` to `100` pixels (inclusive)
 158
 159## Allow Rewrap
 160
 161- Description: Controls where the {#action editor::Rewrap} action is allowed in the current language scope
 162- Setting: `allow_rewrap`
 163- Default: `"in_comments"`
 164
 165**Options**
 166
 1671. Allow rewrap in comments only:
 168
 169```json [settings]
 170{
 171  "allow_rewrap": "in_comments"
 172}
 173```
 174
 1752. Allow rewrap in selections only:
 176
 177```json [settings]
 178{
 179  "allow_rewrap": "in_selections"
 180}
 181```
 182
 1833. Allow rewrap anywhere:
 184
 185```json [settings]
 186{
 187  "allow_rewrap": "anywhere"
 188}
 189```
 190
 191Note: This setting has no effect in Vim mode, as rewrap is already allowed everywhere.
 192
 193## Auto Indent
 194
 195- Description: Whether indentation should be adjusted based on the context whilst typing. This can be specified on a per-language basis.
 196- Setting: `auto_indent`
 197- Default: `true`
 198
 199**Options**
 200
 201`boolean` values
 202
 203## Auto Indent On Paste
 204
 205- Description: Whether indentation of pasted content should be adjusted based on the context
 206- Setting: `auto_indent_on_paste`
 207- Default: `true`
 208
 209**Options**
 210
 211`boolean` values
 212
 213## Auto Install extensions
 214
 215- Description: Define extensions to be autoinstalled or never be installed.
 216- Setting: `auto_install_extensions`
 217- Default: `{ "html": true }`
 218
 219**Options**
 220
 221You can find the names of your currently installed extensions by listing the subfolders under the [extension installation location](./extensions/installing-extensions.md#installation-location):
 222
 223On macOS:
 224
 225```sh
 226ls ~/Library/Application\ Support/Zed/extensions/installed/
 227```
 228
 229On Linux:
 230
 231```sh
 232ls ~/.local/share/zed/extensions/installed
 233```
 234
 235Define extensions which should be installed (`true`) or never installed (`false`).
 236
 237```json [settings]
 238{
 239  "auto_install_extensions": {
 240    "html": true,
 241    "dockerfile": true,
 242    "docker-compose": false
 243  }
 244}
 245```
 246
 247## Auto Update extensions
 248
 249- Description: Define extensions to be autoupdated or manually updated.
 250- Setting: `auto_update_extensions`
 251- Default: `null`
 252
 253**Options**
 254
 255Define extensions which will be autoupdated (`true`) vs. those that will be manually updated (`false`).
 256
 257```json [settings]
 258{
 259  "auto_update_extensions": {
 260    "html": true,
 261    "dockerfile": true,
 262    "docker-compose": false
 263  }
 264}
 265```
 266
 267## Autosave
 268
 269- Description: When to automatically save edited buffers.
 270- Setting: `autosave`
 271- Default: `off`
 272
 273**Options**
 274
 2751. To disable autosave, set it to `off`:
 276
 277```json [settings]
 278{
 279  "autosave": "off"
 280}
 281```
 282
 2832. To autosave when focus changes, use `on_focus_change`:
 284
 285```json [settings]
 286{
 287  "autosave": "on_focus_change"
 288}
 289```
 290
 2913. To autosave when the active window changes, use `on_window_change`:
 292
 293```json [settings]
 294{
 295  "autosave": "on_window_change"
 296}
 297```
 298
 2994. To autosave after an inactivity period, use `after_delay`:
 300
 301```json [settings]
 302{
 303  "autosave": {
 304    "after_delay": {
 305      "milliseconds": 1000
 306    }
 307  }
 308}
 309```
 310
 311Note that a save will be triggered when an unsaved tab is closed, even if this is earlier than the configured inactivity period.
 312
 313## Autoscroll on Clicks
 314
 315- Description: Whether to scroll when clicking near the edge of the visible text area.
 316- Setting: `autoscroll_on_clicks`
 317- Default: `false`
 318
 319**Options**
 320
 321`boolean` values
 322
 323## Auto Signature Help
 324
 325- Description: Show method signatures in the editor, when inside parentheses
 326- Setting: `auto_signature_help`
 327- Default: `false`
 328
 329**Options**
 330
 331`boolean` values
 332
 333### Show Signature Help After Edits
 334
 335- 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.
 336- Setting: `show_signature_help_after_edits`
 337- Default: `false`
 338
 339**Options**
 340
 341`boolean` values
 342
 343## Auto Update
 344
 345- Description: Whether or not to automatically check for updates.
 346- Setting: `auto_update`
 347- Default: `true`
 348
 349**Options**
 350
 351`boolean` values
 352
 353## Base Keymap
 354
 355- Description: Base key bindings scheme. Base keymaps can be overridden with user keymaps.
 356- Setting: `base_keymap`
 357- Default: `VSCode`
 358
 359**Options**
 360
 3611. VS Code
 362
 363```json [settings]
 364{
 365  "base_keymap": "VSCode"
 366}
 367```
 368
 3692. Atom
 370
 371```json [settings]
 372{
 373  "base_keymap": "Atom"
 374}
 375```
 376
 3773. JetBrains
 378
 379```json [settings]
 380{
 381  "base_keymap": "JetBrains"
 382}
 383```
 384
 3854. None
 386
 387```json [settings]
 388{
 389  "base_keymap": "None"
 390}
 391```
 392
 3935. Sublime Text
 394
 395```json [settings]
 396{
 397  "base_keymap": "SublimeText"
 398}
 399```
 400
 4016. TextMate
 402
 403```json [settings]
 404{
 405  "base_keymap": "TextMate"
 406}
 407```
 408
 409## Buffer Font Family
 410
 411- Description: The name of a font to use for rendering text in the editor.
 412- Setting: `buffer_font_family`
 413- Default: `.ZedMono`. This currently aliases to [Lilex](https://lilex.myrt.co).
 414
 415**Options**
 416
 417The name of any font family installed on the user's system, or `".ZedMono"`.
 418
 419## Buffer Font Features
 420
 421- Description: The OpenType features to enable for text in the editor.
 422- Setting: `buffer_font_features`
 423- Default: `null`
 424- Platform: macOS and Windows.
 425
 426**Options**
 427
 428Zed 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.
 429
 430For example, to disable font ligatures, add the following to your settings:
 431
 432```json [settings]
 433{
 434  "buffer_font_features": {
 435    "calt": false
 436  }
 437}
 438```
 439
 440You can also set other OpenType features, like setting `cv01` to `7`:
 441
 442```json [settings]
 443{
 444  "buffer_font_features": {
 445    "cv01": 7
 446  }
 447}
 448```
 449
 450## Buffer Font Fallbacks
 451
 452- Description: Set the buffer text's font fallbacks, this will be merged with the platform's default fallbacks.
 453- Setting: `buffer_font_fallbacks`
 454- Default: `null`
 455- Platform: macOS and Windows.
 456
 457**Options**
 458
 459For example, to use `Nerd Font` as a fallback, add the following to your settings:
 460
 461```json [settings]
 462{
 463  "buffer_font_fallbacks": ["Nerd Font"]
 464}
 465```
 466
 467## Buffer Font Size
 468
 469- Description: The default font size for text in the editor.
 470- Setting: `buffer_font_size`
 471- Default: `15`
 472
 473**Options**
 474
 475A font size from `6` to `100` pixels (inclusive)
 476
 477## Buffer Font Weight
 478
 479- Description: The default font weight for text in the editor.
 480- Setting: `buffer_font_weight`
 481- Default: `400`
 482
 483**Options**
 484
 485`integer` values between `100` and `900`
 486
 487## Buffer Line Height
 488
 489- Description: The default line height for text in the editor.
 490- Setting: `buffer_line_height`
 491- Default: `"comfortable"`
 492
 493**Options**
 494
 495`"standard"`, `"comfortable"` or `{ "custom": float }` (`1` is compact, `2` is loose)
 496
 497## Centered Layout
 498
 499- Description: Configuration for the centered layout mode.
 500- Setting: `centered_layout`
 501- Default:
 502
 503```json [settings]
 504"centered_layout": {
 505  "left_padding": 0.2,
 506  "right_padding": 0.2,
 507}
 508```
 509
 510**Options**
 511
 512The `left_padding` and `right_padding` options define the relative width of the
 513left 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`.
 514
 515## Close on File Delete
 516
 517- Description: Whether to automatically close editor tabs when their corresponding files are deleted from disk.
 518- Setting: `close_on_file_delete`
 519- Default: `false`
 520
 521**Options**
 522
 523`boolean` values
 524
 525When 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.
 526
 527Note: Dirty files (files with unsaved changes) will not be automatically closed even when this setting is enabled, ensuring you don't lose unsaved work.
 528
 529## Confirm Quit
 530
 531- Description: Whether or not to prompt the user to confirm before closing the application.
 532- Setting: `confirm_quit`
 533- Default: `false`
 534
 535**Options**
 536
 537`boolean` values
 538
 539## Diagnostics Max Severity
 540
 541- Description: Which level to use to filter out diagnostics displayed in the editor
 542- Setting: `diagnostics_max_severity`
 543- Default: `null`
 544
 545**Options**
 546
 5471. Allow all diagnostics (default):
 548
 549```json [settings]
 550{
 551  "diagnostics_max_severity": "all"
 552}
 553```
 554
 5552. Show only errors:
 556
 557```json [settings]
 558{
 559  "diagnostics_max_severity": "error"
 560}
 561```
 562
 5633. Show errors and warnings:
 564
 565```json [settings]
 566{
 567  "diagnostics_max_severity": "warning"
 568}
 569```
 570
 5714. Show errors, warnings, and information:
 572
 573```json [settings]
 574{
 575  "diagnostics_max_severity": "info"
 576}
 577```
 578
 5795. Show all including hints:
 580
 581```json [settings]
 582{
 583  "diagnostics_max_severity": "hint"
 584}
 585```
 586
 587## Disable AI
 588
 589- Description: Whether to disable all AI features in Zed
 590- Setting: `disable_ai`
 591- Default: `false`
 592
 593**Options**
 594
 595`boolean` values
 596
 597## Direnv Integration
 598
 599- Description: Settings for [direnv](https://direnv.net/) integration. Requires `direnv` to be installed.
 600  `direnv` integration make it possible to use the environment variables set by a `direnv` configuration to detect some language servers in `$PATH` instead of installing them.
 601  It also allows for those environment variables to be used in tasks.
 602- Setting: `load_direnv`
 603- Default: `"direct"`
 604
 605**Options**
 606
 607There are three options to choose from:
 608
 6091. `shell_hook`: Use the shell hook to load direnv. This relies on direnv to activate upon entering the directory. Supports POSIX shells and fish.
 6102. `direct`: Use `direnv export json` to load direnv. This will load direnv directly without relying on the shell hook and might cause some inconsistencies. This allows direnv to work with any shell.
 6113. `disabled`: No shell environment will be loaded automatically; direnv must be invoked manually (e.g. with `direnv exec`) to be used.
 612
 613## Double Click In Multibuffer
 614
 615- Description: What to do when multibuffer is double clicked in some of its excerpts (parts of singleton buffers)
 616- Setting: `double_click_in_multibuffer`
 617- Default: `"select"`
 618
 619**Options**
 620
 6211. Behave as a regular buffer and select the whole word (default):
 622
 623```json [settings]
 624{
 625  "double_click_in_multibuffer": "select"
 626}
 627```
 628
 6292. Open the excerpt clicked as a new buffer in the new tab:
 630
 631```json [settings]
 632{
 633  "double_click_in_multibuffer": "open"
 634}
 635```
 636
 637For the case of "open", regular selection behavior can be achieved by holding `alt` when double clicking.
 638
 639## Drop Target Size
 640
 641- Description: Relative size of the drop target in the editor that will open dropped file as a split pane (0-0.5). For example, 0.25 means if you drop onto the top/bottom quarter of the pane a new vertical split will be used, if you drop onto the left/right quarter of the pane a new horizontal split will be used.
 642- Setting: `drop_target_size`
 643- Default: `0.2`
 644
 645**Options**
 646
 647`float` values between `0` and `0.5`
 648
 649## Edit Predictions
 650
 651- Description: Settings for edit predictions.
 652- Setting: `edit_predictions`
 653- Default:
 654
 655```json [settings]
 656  "edit_predictions": {
 657    "disabled_globs": [
 658      "**/.env*",
 659      "**/*.pem",
 660      "**/*.key",
 661      "**/*.cert",
 662      "**/*.crt",
 663      "**/.dev.vars",
 664      "**/secrets.yml"
 665    ]
 666  }
 667```
 668
 669**Options**
 670
 671### Disabled Globs
 672
 673- Description: A list of globs for which edit predictions should be disabled for. This list adds to a pre-existing, sensible default set of globs. Any additional ones you add are combined with them.
 674- Setting: `disabled_globs`
 675- Default: `["**/.env*", "**/*.pem", "**/*.key", "**/*.cert", "**/*.crt", "**/.dev.vars", "**/secrets.yml"]`
 676
 677**Options**
 678
 679List of `string` values.
 680
 681## Edit Predictions Disabled in
 682
 683- Description: A list of language scopes in which edit predictions should be disabled.
 684- Setting: `edit_predictions_disabled_in`
 685- Default: `[]`
 686
 687**Options**
 688
 689List of `string` values
 690
 6911. Don't show edit predictions in comments:
 692
 693```json [settings]
 694"disabled_in": ["comment"]
 695```
 696
 6972. Don't show edit predictions in strings and comments:
 698
 699```json [settings]
 700"disabled_in": ["comment", "string"]
 701```
 702
 7033. Only in Go, don't show edit predictions in strings and comments:
 704
 705```json [settings]
 706{
 707  "languages": {
 708    "Go": {
 709      "edit_predictions_disabled_in": ["comment", "string"]
 710    }
 711  }
 712}
 713```
 714
 715## Current Line Highlight
 716
 717- Description: How to highlight the current line in the editor.
 718- Setting: `current_line_highlight`
 719- Default: `all`
 720
 721**Options**
 722
 7231. Don't highlight the current line:
 724
 725```json [settings]
 726"current_line_highlight": "none"
 727```
 728
 7292. Highlight the gutter area:
 730
 731```json [settings]
 732"current_line_highlight": "gutter"
 733```
 734
 7353. Highlight the editor area:
 736
 737```json [settings]
 738"current_line_highlight": "line"
 739```
 740
 7414. Highlight the full line:
 742
 743```json [settings]
 744"current_line_highlight": "all"
 745```
 746
 747## Selection Highlight
 748
 749- Description: Whether to highlight all occurrences of the selected text in an editor.
 750- Setting: `selection_highlight`
 751- Default: `true`
 752
 753## Rounded Selection
 754
 755- Description: Whether the text selection should have rounded corners.
 756- Setting: `rounded_selection`
 757- Default: `true`
 758
 759## Cursor Blink
 760
 761- Description: Whether or not the cursor blinks.
 762- Setting: `cursor_blink`
 763- Default: `true`
 764
 765**Options**
 766
 767`boolean` values
 768
 769## Cursor Shape
 770
 771- Description: Cursor shape for the default editor.
 772- Setting: `cursor_shape`
 773- Default: `bar`
 774
 775**Options**
 776
 7771. A vertical bar:
 778
 779```json [settings]
 780"cursor_shape": "bar"
 781```
 782
 7832. A block that surrounds the following character:
 784
 785```json [settings]
 786"cursor_shape": "block"
 787```
 788
 7893. An underline / underscore that runs along the following character:
 790
 791```json [settings]
 792"cursor_shape": "underline"
 793```
 794
 7954. An box drawn around the following character:
 796
 797```json [settings]
 798"cursor_shape": "hollow"
 799```
 800
 801## Gutter
 802
 803- Description: Settings for the editor gutter
 804- Setting: `gutter`
 805- Default:
 806
 807```json [settings]
 808{
 809  "gutter": {
 810    "line_numbers": true,
 811    "runnables": true,
 812    "breakpoints": true,
 813    "folds": true,
 814    "min_line_number_digits": 4
 815  }
 816}
 817```
 818
 819**Options**
 820
 821- `line_numbers`: Whether to show line numbers in the gutter
 822- `runnables`: Whether to show runnable buttons in the gutter
 823- `breakpoints`: Whether to show breakpoints in the gutter
 824- `folds`: Whether to show fold buttons in the gutter
 825- `min_line_number_digits`: Minimum number of characters to reserve space for in the gutter
 826
 827## Hide Mouse
 828
 829- Description: Determines when the mouse cursor should be hidden in an editor or input box.
 830- Setting: `hide_mouse`
 831- Default: `on_typing_and_movement`
 832
 833**Options**
 834
 8351. Never hide the mouse cursor:
 836
 837```json [settings]
 838"hide_mouse": "never"
 839```
 840
 8412. Hide only when typing:
 842
 843```json [settings]
 844"hide_mouse": "on_typing"
 845```
 846
 8473. Hide on both typing and cursor movement:
 848
 849```json [settings]
 850"hide_mouse": "on_typing_and_movement"
 851```
 852
 853## Snippet Sort Order
 854
 855- Description: Determines how snippets are sorted relative to other completion items.
 856- Setting: `snippet_sort_order`
 857- Default: `inline`
 858
 859**Options**
 860
 8611. Place snippets at the top of the completion list:
 862
 863```json [settings]
 864"snippet_sort_order": "top"
 865```
 866
 8672. Place snippets normally without any preference:
 868
 869```json [settings]
 870"snippet_sort_order": "inline"
 871```
 872
 8733. Place snippets at the bottom of the completion list:
 874
 875```json [settings]
 876"snippet_sort_order": "bottom"
 877```
 878
 8794. Do not show snippets in the completion list at all:
 880
 881```json [settings]
 882"snippet_sort_order": "none"
 883```
 884
 885## Editor Scrollbar
 886
 887- Description: Whether or not to show the editor scrollbar and various elements in it.
 888- Setting: `scrollbar`
 889- Default:
 890
 891```json [settings]
 892"scrollbar": {
 893  "show": "auto",
 894  "cursors": true,
 895  "git_diff": true,
 896  "search_results": true,
 897  "selected_text": true,
 898  "selected_symbol": true,
 899  "diagnostics": "all",
 900  "axes": {
 901    "horizontal": true,
 902    "vertical": true,
 903  },
 904},
 905```
 906
 907### Show Mode
 908
 909- Description: When to show the editor scrollbar.
 910- Setting: `show`
 911- Default: `auto`
 912
 913**Options**
 914
 9151. Show the scrollbar if there's important information or follow the system's configured behavior:
 916
 917```json [settings]
 918"scrollbar": {
 919  "show": "auto"
 920}
 921```
 922
 9232. Match the system's configured behavior:
 924
 925```json [settings]
 926"scrollbar": {
 927  "show": "system"
 928}
 929```
 930
 9313. Always show the scrollbar:
 932
 933```json [settings]
 934"scrollbar": {
 935  "show": "always"
 936}
 937```
 938
 9394. Never show the scrollbar:
 940
 941```json [settings]
 942"scrollbar": {
 943  "show": "never"
 944}
 945```
 946
 947### Cursor Indicators
 948
 949- Description: Whether to show cursor positions in the scrollbar.
 950- Setting: `cursors`
 951- Default: `true`
 952
 953Cursor indicators appear as small marks on the scrollbar showing where other collaborators' cursors are positioned in the file.
 954
 955**Options**
 956
 957`boolean` values
 958
 959### Git Diff Indicators
 960
 961- Description: Whether to show git diff indicators in the scrollbar.
 962- Setting: `git_diff`
 963- Default: `true`
 964
 965Git diff indicators appear as colored marks showing lines that have been added, modified, or deleted compared to the git HEAD.
 966
 967**Options**
 968
 969`boolean` values
 970
 971### Search Results Indicators
 972
 973- Description: Whether to show buffer search results in the scrollbar.
 974- Setting: `search_results`
 975- Default: `true`
 976
 977Search result indicators appear as marks showing all locations in the file where your current search query matches.
 978
 979**Options**
 980
 981`boolean` values
 982
 983### Selected Text Indicators
 984
 985- Description: Whether to show selected text occurrences in the scrollbar.
 986- Setting: `selected_text`
 987- Default: `true`
 988
 989Selected text indicators appear as marks showing all occurrences of the currently selected text throughout the file.
 990
 991**Options**
 992
 993`boolean` values
 994
 995### Selected Symbols Indicators
 996
 997- Description: Whether to show selected symbol occurrences in the scrollbar.
 998- Setting: `selected_symbol`
 999- Default: `true`
1000
1001Selected symbol indicators appear as marks showing all occurrences of the currently selected symbol (like a function or variable name) throughout the file.
1002
1003**Options**
1004
1005`boolean` values
1006
1007### Diagnostics
1008
1009- Description: Which diagnostic indicators to show in the scrollbar.
1010- Setting: `diagnostics`
1011- Default: `all`
1012
1013Diagnostic indicators appear as colored marks showing errors, warnings, and other language server diagnostics at their corresponding line positions in the file.
1014
1015**Options**
1016
10171. Show all diagnostics:
1018
1019```json [settings]
1020{
1021  "show_diagnostics": "all"
1022}
1023```
1024
10252. Do not show any diagnostics:
1026
1027```json [settings]
1028{
1029  "show_diagnostics": "off"
1030}
1031```
1032
10333. Show only errors:
1034
1035```json [settings]
1036{
1037  "show_diagnostics": "error"
1038}
1039```
1040
10414. Show only errors and warnings:
1042
1043```json [settings]
1044{
1045  "show_diagnostics": "warning"
1046}
1047```
1048
10495. Show only errors, warnings, and information:
1050
1051```json [settings]
1052{
1053  "show_diagnostics": "info"
1054}
1055```
1056
1057### Axes
1058
1059- Description: Forcefully enable or disable the scrollbar for each axis
1060- Setting: `axes`
1061- Default:
1062
1063```json [settings]
1064"scrollbar": {
1065  "axes": {
1066    "horizontal": true,
1067    "vertical": true,
1068  },
1069}
1070```
1071
1072#### Horizontal
1073
1074- Description: When false, forcefully disables the horizontal scrollbar. Otherwise, obey other settings.
1075- Setting: `horizontal`
1076- Default: `true`
1077
1078**Options**
1079
1080`boolean` values
1081
1082#### Vertical
1083
1084- Description: When false, forcefully disables the vertical scrollbar. Otherwise, obey other settings.
1085- Setting: `vertical`
1086- Default: `true`
1087
1088**Options**
1089
1090`boolean` values
1091
1092## Minimap
1093
1094- Description: Settings related to the editor's minimap, which provides an overview of your document.
1095- Setting: `minimap`
1096- Default:
1097
1098```json [settings]
1099{
1100  "minimap": {
1101    "show": "never",
1102    "thumb": "always",
1103    "thumb_border": "left_open",
1104    "current_line_highlight": null
1105  }
1106}
1107```
1108
1109### Show Mode
1110
1111- Description: When to show the minimap in the editor.
1112- Setting: `show`
1113- Default: `never`
1114
1115**Options**
1116
11171. Always show the minimap:
1118
1119```json [settings]
1120{
1121  "show": "always"
1122}
1123```
1124
11252. Show the minimap if the editor's scrollbars are visible:
1126
1127```json [settings]
1128{
1129  "show": "auto"
1130}
1131```
1132
11333. Never show the minimap:
1134
1135```json [settings]
1136{
1137  "show": "never"
1138}
1139```
1140
1141### Thumb Display
1142
1143- Description: When to show the minimap thumb (the visible editor area) in the minimap.
1144- Setting: `thumb`
1145- Default: `always`
1146
1147**Options**
1148
11491. Show the minimap thumb when hovering over the minimap:
1150
1151```json [settings]
1152{
1153  "thumb": "hover"
1154}
1155```
1156
11572. Always show the minimap thumb:
1158
1159```json [settings]
1160{
1161  "thumb": "always"
1162}
1163```
1164
1165### Thumb Border
1166
1167- Description: How the minimap thumb border should look.
1168- Setting: `thumb_border`
1169- Default: `left_open`
1170
1171**Options**
1172
11731. Display a border on all sides of the thumb:
1174
1175```json [settings]
1176{
1177  "thumb_border": "full"
1178}
1179```
1180
11812. Display a border on all sides except the left side:
1182
1183```json [settings]
1184{
1185  "thumb_border": "left_open"
1186}
1187```
1188
11893. Display a border on all sides except the right side:
1190
1191```json [settings]
1192{
1193  "thumb_border": "right_open"
1194}
1195```
1196
11974. Display a border only on the left side:
1198
1199```json [settings]
1200{
1201  "thumb_border": "left_only"
1202}
1203```
1204
12055. Display the thumb without any border:
1206
1207```json [settings]
1208{
1209  "thumb_border": "none"
1210}
1211```
1212
1213### Current Line Highlight
1214
1215- Description: How to highlight the current line in the minimap.
1216- Setting: `current_line_highlight`
1217- Default: `null`
1218
1219**Options**
1220
12211. Inherit the editor's current line highlight setting:
1222
1223```json [settings]
1224{
1225  "minimap": {
1226    "current_line_highlight": null
1227  }
1228}
1229```
1230
12312. Highlight the current line in the minimap:
1232
1233```json [settings]
1234{
1235  "minimap": {
1236    "current_line_highlight": "line"
1237  }
1238}
1239```
1240
1241or
1242
1243```json [settings]
1244{
1245  "minimap": {
1246    "current_line_highlight": "all"
1247  }
1248}
1249```
1250
12513. Do not highlight the current line in the minimap:
1252
1253```json [settings]
1254{
1255  "minimap": {
1256    "current_line_highlight": "gutter"
1257  }
1258}
1259```
1260
1261or
1262
1263```json [settings]
1264{
1265  "minimap": {
1266    "current_line_highlight": "none"
1267  }
1268}
1269```
1270
1271## Editor Tab Bar
1272
1273- Description: Settings related to the editor's tab bar.
1274- Settings: `tab_bar`
1275- Default:
1276
1277```json [settings]
1278"tab_bar": {
1279  "show": true,
1280  "show_nav_history_buttons": true,
1281  "show_tab_bar_buttons": true
1282}
1283```
1284
1285### Show
1286
1287- Description: Whether or not to show the tab bar in the editor.
1288- Setting: `show`
1289- Default: `true`
1290
1291**Options**
1292
1293`boolean` values
1294
1295### Navigation History Buttons
1296
1297- Description: Whether or not to show the navigation history buttons.
1298- Setting: `show_nav_history_buttons`
1299- Default: `true`
1300
1301**Options**
1302
1303`boolean` values
1304
1305### Tab Bar Buttons
1306
1307- Description: Whether or not to show the tab bar buttons.
1308- Setting: `show_tab_bar_buttons`
1309- Default: `true`
1310
1311**Options**
1312
1313`boolean` values
1314
1315## Editor Tabs
1316
1317- Description: Configuration for the editor tabs.
1318- Setting: `tabs`
1319- Default:
1320
1321```json [settings]
1322"tabs": {
1323  "close_position": "right",
1324  "file_icons": false,
1325  "git_status": false,
1326  "activate_on_close": "history",
1327  "show_close_button": "hover",
1328  "show_diagnostics": "off"
1329},
1330```
1331
1332### Close Position
1333
1334- Description: Where to display close button within a tab.
1335- Setting: `close_position`
1336- Default: `right`
1337
1338**Options**
1339
13401. Display the close button on the right:
1341
1342```json [settings]
1343{
1344  "close_position": "right"
1345}
1346```
1347
13482. Display the close button on the left:
1349
1350```json [settings]
1351{
1352  "close_position": "left"
1353}
1354```
1355
1356### File Icons
1357
1358- Description: Whether to show the file icon for a tab.
1359- Setting: `file_icons`
1360- Default: `false`
1361
1362### Git Status
1363
1364- Description: Whether or not to show Git file status in tab.
1365- Setting: `git_status`
1366- Default: `false`
1367
1368### Activate on close
1369
1370- Description: What to do after closing the current tab.
1371- Setting: `activate_on_close`
1372- Default: `history`
1373
1374**Options**
1375
13761.  Activate the tab that was open previously:
1377
1378```json [settings]
1379{
1380  "activate_on_close": "history"
1381}
1382```
1383
13842. Activate the right neighbour tab if present:
1385
1386```json [settings]
1387{
1388  "activate_on_close": "neighbour"
1389}
1390```
1391
13923. Activate the left neighbour tab if present:
1393
1394```json [settings]
1395{
1396  "activate_on_close": "left_neighbour"
1397}
1398```
1399
1400### Show close button
1401
1402- Description: Controls the appearance behavior of the tab's close button.
1403- Setting: `show_close_button`
1404- Default: `hover`
1405
1406**Options**
1407
14081.  Show it just upon hovering the tab:
1409
1410```json [settings]
1411{
1412  "show_close_button": "hover"
1413}
1414```
1415
14162. Show it persistently:
1417
1418```json [settings]
1419{
1420  "show_close_button": "always"
1421}
1422```
1423
14243. Never show it, even if hovering it:
1425
1426```json [settings]
1427{
1428  "show_close_button": "hidden"
1429}
1430```
1431
1432### Show Diagnostics
1433
1434- Description: Whether to show diagnostics indicators in tabs. This setting only works when file icons are active and controls which files with diagnostic issues to mark.
1435- Setting: `show_diagnostics`
1436- Default: `off`
1437
1438**Options**
1439
14401. Do not mark any files:
1441
1442```json [settings]
1443{
1444  "show_diagnostics": "off"
1445}
1446```
1447
14482. Only mark files with errors:
1449
1450```json [settings]
1451{
1452  "show_diagnostics": "errors"
1453}
1454```
1455
14563. Mark files with errors and warnings:
1457
1458```json [settings]
1459{
1460  "show_diagnostics": "all"
1461}
1462```
1463
1464### Show Inline Code Actions
1465
1466- Description: Whether to show code action button at start of buffer line.
1467- Setting: `inline_code_actions`
1468- Default: `true`
1469
1470**Options**
1471
1472`boolean` values
1473
1474### Session
1475
1476- Description: Controls Zed lifecycle-related behavior.
1477- Setting: `session`
1478- Default:
1479
1480```json
1481{
1482  "session": {
1483    "restore_unsaved_buffers": true,
1484    "trust_all_worktrees": false
1485  }
1486}
1487```
1488
1489**Options**
1490
14911.  Whether or not to restore unsaved buffers on restart:
1492
1493```json [settings]
1494{
1495  "session": {
1496    "restore_unsaved_buffers": true
1497  }
1498}
1499```
1500
1501If this is true, user won't be prompted whether to save/discard dirty files when closing the application.
1502
15032. Whether or not to skip worktree and workspace trust checks:
1504
1505```json [settings]
1506{
1507  "session": {
1508    "trust_all_worktrees": false
1509  }
1510}
1511```
1512
1513When trusted, project settings are synchronized automatically, language and MCP servers are downloaded and started automatically.
1514
1515### Drag And Drop Selection
1516
1517- Description: Whether to allow drag and drop text selection in buffer. `delay` is the milliseconds that must elapse before drag and drop is allowed. Otherwise, a new text selection is created.
1518- Setting: `drag_and_drop_selection`
1519- Default:
1520
1521```json [settings]
1522"drag_and_drop_selection": {
1523  "enabled": true,
1524  "delay": 300
1525}
1526```
1527
1528## Editor Toolbar
1529
1530- Description: Whether or not to show various elements in the editor toolbar.
1531- Setting: `toolbar`
1532- Default:
1533
1534```json [settings]
1535"toolbar": {
1536  "breadcrumbs": true,
1537  "quick_actions": true,
1538  "selections_menu": true,
1539  "agent_review": true,
1540  "code_actions": false
1541},
1542```
1543
1544**Options**
1545
1546Each option controls displaying of a particular toolbar element. If all elements are hidden, the editor toolbar is not displayed.
1547
1548## Use System Tabs
1549
1550- Description: Whether to allow windows to tab together based on the user’s tabbing preference (macOS only).
1551- Setting: `use_system_window_tabs`
1552- Default: `false`
1553
1554**Options**
1555
1556This setting enables integration with macOS’s native window tabbing feature. When set to `true`, Zed windows can be grouped together as tabs in a single macOS window, following the system-wide tabbing preferences set by the user (such as "Always", "In Full Screen", or "Never"). This setting is only available on macOS.
1557
1558## Enable Language Server
1559
1560- Description: Whether or not to use language servers to provide code intelligence.
1561- Setting: `enable_language_server`
1562- Default: `true`
1563
1564**Options**
1565
1566`boolean` values
1567
1568## Ensure Final Newline On Save
1569
1570- Description: Removes any lines containing only whitespace at the end of the file and ensures just one newline at the end.
1571- Setting: `ensure_final_newline_on_save`
1572- Default: `true`
1573
1574**Options**
1575
1576`boolean` values
1577
1578## Expand Excerpt Lines
1579
1580- Description: The default number of lines to expand excerpts in the multibuffer by
1581- Setting: `expand_excerpt_lines`
1582- Default: `5`
1583
1584**Options**
1585
1586Positive `integer` values
1587
1588## Excerpt Context Lines
1589
1590- Description: The number of lines of context to provide when showing excerpts in the multibuffer.
1591- Setting: `excerpt_context_lines`
1592- Default: `2`
1593
1594**Options**
1595
1596Positive `integer` value between 1 and 32. Values outside of this range will be clamped to this range.
1597
1598## Extend Comment On Newline
1599
1600- Description: Whether to start a new line with a comment when a previous line is a comment as well.
1601- Setting: `extend_comment_on_newline`
1602- Default: `true`
1603
1604**Options**
1605
1606`boolean` values
1607
1608## Extend List On Newline
1609
1610- Description: Whether to continue lists when pressing Enter at the end of a list item. Supports unordered, ordered, and task lists. Pressing Enter on an empty list item removes the marker and exits the list.
1611- Setting: `extend_list_on_newline`
1612- Default: `true`
1613
1614**Options**
1615
1616`boolean` values
1617
1618## Indent List On Tab
1619
1620- Description: Whether to indent list items when pressing Tab on a line containing only a list marker. This enables quick creation of nested lists.
1621- Setting: `indent_list_on_tab`
1622- Default: `true`
1623
1624**Options**
1625
1626`boolean` values
1627
1628## Status Bar
1629
1630- Description: Control various elements in the status bar. Note that some items in the status bar have their own settings set elsewhere.
1631- Setting: `status_bar`
1632- Default:
1633
1634```json [settings]
1635"status_bar": {
1636  "active_language_button": true,
1637  "cursor_position_button": true,
1638  "line_endings_button": false,
1639  "active_encoding_button": "non_utf8"
1640},
1641```
1642
1643There is an experimental setting that completely hides the status bar. This causes major usability problems (you will be unable to use many of Zed's features), but is provided for those who value screen real-estate above all else.
1644
1645```json
1646"status_bar": {
1647  "experimental.show": false
1648}
1649```
1650
1651## LSP
1652
1653- Description: Configuration for language servers.
1654- Setting: `lsp`
1655- Default: `null`
1656
1657**Options**
1658
1659The following settings can be overridden for specific language servers:
1660
1661- `initialization_options`
1662- `settings`
1663
1664To override configuration for a language server, add an entry for that language server's name to the `lsp` value.
1665
1666Some options are passed via `initialization_options` to the language server. These are for options which must be specified at language server startup and when changed will require restarting the language server.
1667
1668For example to pass the `check` option to `rust-analyzer`, use the following configuration:
1669
1670```json [settings]
1671"lsp": {
1672  "rust-analyzer": {
1673    "initialization_options": {
1674      "check": {
1675        "command": "clippy" // rust-analyzer.check.command (default: "check")
1676      }
1677    }
1678  }
1679}
1680```
1681
1682While other options may be changed at a runtime and should be placed under `settings`:
1683
1684```json [settings]
1685"lsp": {
1686  "yaml-language-server": {
1687    "settings": {
1688      "yaml": {
1689        "keyOrdering": true // Enforces alphabetical ordering of keys in maps
1690      }
1691    }
1692  }
1693}
1694```
1695
1696## Global LSP Settings
1697
1698- Description: Configuration for global LSP settings that apply to all language servers
1699- Setting: `global_lsp_settings`
1700- Default:
1701
1702```json [settings]
1703{
1704  "global_lsp_settings": {
1705    "button": true
1706  }
1707}
1708```
1709
1710**Options**
1711
1712- `button`: Whether to show the LSP status button in the status bar
1713
1714## LSP Highlight Debounce
1715
1716- Description: The debounce delay in milliseconds before querying highlights from the language server based on the current cursor location.
1717- Setting: `lsp_highlight_debounce`
1718- Default: `75`
1719
1720**Options**
1721
1722`integer` values representing milliseconds
1723
1724## Features
1725
1726- Description: Features that can be globally enabled or disabled
1727- Setting: `features`
1728- Default:
1729
1730```json [settings]
1731{
1732  "features": {
1733    "edit_prediction_provider": "zed"
1734  }
1735}
1736```
1737
1738### Edit Prediction Provider
1739
1740- Description: Which edit prediction provider to use
1741- Setting: `edit_prediction_provider`
1742- Default: `"zed"`
1743
1744**Options**
1745
17461. Use Zeta as the edit prediction provider:
1747
1748```json [settings]
1749{
1750  "features": {
1751    "edit_prediction_provider": "zed"
1752  }
1753}
1754```
1755
17562. Use Copilot as the edit prediction provider:
1757
1758```json [settings]
1759{
1760  "features": {
1761    "edit_prediction_provider": "copilot"
1762  }
1763}
1764```
1765
17663. Use Supermaven as the edit prediction provider:
1767
1768```json [settings]
1769{
1770  "features": {
1771    "edit_prediction_provider": "supermaven"
1772  }
1773}
1774```
1775
17764. Turn off edit predictions across all providers
1777
1778```json [settings]
1779{
1780  "features": {
1781    "edit_prediction_provider": "none"
1782  }
1783}
1784```
1785
1786## Format On Save
1787
1788- Description: Whether or not to perform a buffer format before saving.
1789- Setting: `format_on_save`
1790- Default: `on`
1791
1792**Options**
1793
17941. `on`, enables format on save obeying `formatter` setting:
1795
1796```json [settings]
1797{
1798  "format_on_save": "on"
1799}
1800```
1801
18022. `off`, disables format on save:
1803
1804```json [settings]
1805{
1806  "format_on_save": "off"
1807}
1808```
1809
1810## Formatter
1811
1812- Description: How to perform a buffer format.
1813- Setting: `formatter`
1814- Default: `auto`
1815
1816**Options**
1817
18181. To use the current language server, use `"language_server"`:
1819
1820```json [settings]
1821{
1822  "formatter": "language_server"
1823}
1824```
1825
18262. Or to use an external command, use `"external"`. Specify the name of the formatting program to run, and an array of arguments to pass to the program. The buffer's text will be passed to the program on stdin, and the formatted output should be written to stdout. For example, the following command would strip trailing spaces using [`sed(1)`](https://linux.die.net/man/1/sed):
1827
1828```json [settings]
1829{
1830  "formatter": {
1831    "external": {
1832      "command": "sed",
1833      "arguments": ["-e", "s/ *$//"]
1834    }
1835  }
1836}
1837```
1838
18393. External formatters may optionally include a `{buffer_path}` placeholder which at runtime will include the path of the buffer being formatted. Formatters operate by receiving file content via standard input, reformatting it and then outputting it to standard output and so normally don't know the filename of what they are formatting. Tools like Prettier support receiving the file path via a command line argument which can then used to impact formatting decisions.
1840
1841WARNING: `{buffer_path}` should not be used to direct your formatter to read from a filename. Your formatter should only read from standard input and should not read or write files directly.
1842
1843```json [settings]
1844  "formatter": {
1845    "external": {
1846      "command": "prettier",
1847      "arguments": ["--stdin-filepath", "{buffer_path}"]
1848    }
1849  }
1850```
1851
18524. Or to use code actions provided by the connected language servers, use `"code_actions"`:
1853
1854```json [settings]
1855{
1856  "formatter": [
1857    // Use ESLint's --fix:
1858    { "code_action": "source.fixAll.eslint" },
1859    // Organize imports on save:
1860    { "code_action": "source.organizeImports" }
1861  ]
1862}
1863```
1864
18655. Or to use multiple formatters consecutively, use an array of formatters:
1866
1867```json [settings]
1868{
1869  "formatter": [
1870    { "language_server": { "name": "rust-analyzer" } },
1871    {
1872      "external": {
1873        "command": "sed",
1874        "arguments": ["-e", "s/ *$//"]
1875      }
1876    }
1877  ]
1878}
1879```
1880
1881Here `rust-analyzer` will be used first to format the code, followed by a call of sed.
1882If any of the formatters fails, the subsequent ones will still be executed.
1883
1884## Auto close
1885
1886- Description: Whether to automatically add matching closing characters when typing opening parenthesis, bracket, brace, single or double quote characters.
1887- Setting: `use_autoclose`
1888- Default: `true`
1889
1890**Options**
1891
1892`boolean` values
1893
1894## Always Treat Brackets As Autoclosed
1895
1896- Description: Controls how the editor handles the autoclosed characters.
1897- Setting: `always_treat_brackets_as_autoclosed`
1898- Default: `false`
1899
1900**Options**
1901
1902`boolean` values
1903
1904**Example**
1905
1906If the setting is set to `true`:
1907
19081. Enter in the editor: `)))`
19092. Move the cursor to the start: `^)))`
19103. Enter again: `)))`
1911
1912The result is still `)))` and not `))))))`, which is what it would be by default.
1913
1914## File Scan Exclusions
1915
1916- Setting: `file_scan_exclusions`
1917- Description: Files or globs of files that will be excluded by Zed entirely. They will be skipped during file scans, file searches, and not be displayed in the project file tree. Overrides `file_scan_inclusions`.
1918- Default:
1919
1920```json [settings]
1921"file_scan_exclusions": [
1922  "**/.git",
1923  "**/.svn",
1924  "**/.hg",
1925  "**/.jj",
1926  "**/.sl",
1927  "**/.repo",
1928  "**/CVS",
1929  "**/.DS_Store",
1930  "**/Thumbs.db",
1931  "**/.classpath",
1932  "**/.settings"
1933],
1934```
1935
1936Note, specifying `file_scan_exclusions` in settings.json will override the defaults (shown above). If you are looking to exclude additional items you will need to include all the default values in your settings.
1937
1938## File Scan Inclusions
1939
1940- Setting: `file_scan_inclusions`
1941- Description: Files or globs of files that will be included by Zed, even when ignored by git. This is useful for files that are not tracked by git, but are still important to your project. Note that globs that are overly broad can slow down Zed's file scanning. `file_scan_exclusions` takes precedence over these inclusions.
1942- Default:
1943
1944```json [settings]
1945"file_scan_inclusions": [".env*"],
1946```
1947
1948## File Types
1949
1950- Setting: `file_types`
1951- Description: Configure how Zed selects a language for a file based on its filename or extension. Supports glob entries.
1952- Default:
1953
1954```json [settings]
1955"file_types": {
1956  "JSONC": ["**/.zed/**/*.json", "**/zed/**/*.json", "**/Zed/**/*.json", "**/.vscode/**/*.json"],
1957  "Shell Script": [".env.*"]
1958}
1959```
1960
1961**Examples**
1962
1963To interpret all `.c` files as C++, files called `MyLockFile` as TOML and files starting with `Dockerfile` as Dockerfile:
1964
1965```json [settings]
1966{
1967  "file_types": {
1968    "C++": ["c"],
1969    "TOML": ["MyLockFile"],
1970    "Dockerfile": ["Dockerfile*"]
1971  }
1972}
1973```
1974
1975## Diagnostics
1976
1977- Description: Configuration for diagnostics-related features.
1978- Setting: `diagnostics`
1979- Default:
1980
1981```json [settings]
1982{
1983  "diagnostics": {
1984    "include_warnings": true,
1985    "inline": {
1986      "enabled": false
1987    },
1988    "update_with_cursor": false,
1989    "primary_only": false,
1990    "use_rendered": false
1991  }
1992}
1993```
1994
1995### Inline Diagnostics
1996
1997- Description: Whether or not to show diagnostics information inline.
1998- Setting: `inline`
1999- Default:
2000
2001```json [settings]
2002{
2003  "diagnostics": {
2004    "inline": {
2005      "enabled": false,
2006      "update_debounce_ms": 150,
2007      "padding": 4,
2008      "min_column": 0,
2009      "max_severity": null
2010    }
2011  }
2012}
2013```
2014
2015**Options**
2016
20171. Enable inline diagnostics.
2018
2019```json [settings]
2020{
2021  "diagnostics": {
2022    "inline": {
2023      "enabled": true
2024    }
2025  }
2026}
2027```
2028
20292. Delay diagnostic updates until some time after the last diagnostic update.
2030
2031```json [settings]
2032{
2033  "diagnostics": {
2034    "inline": {
2035      "enabled": true,
2036      "update_debounce_ms": 150
2037    }
2038  }
2039}
2040```
2041
20423. Set padding between the end of the source line and the start of the diagnostic.
2043
2044```json [settings]
2045{
2046  "diagnostics": {
2047    "inline": {
2048      "enabled": true,
2049      "padding": 4
2050    }
2051  }
2052}
2053```
2054
20554. Horizontally align inline diagnostics at the given column.
2056
2057```json [settings]
2058{
2059  "diagnostics": {
2060    "inline": {
2061      "enabled": true,
2062      "min_column": 80
2063    }
2064  }
2065}
2066```
2067
20685. Show only warning and error diagnostics.
2069
2070```json [settings]
2071{
2072  "diagnostics": {
2073    "inline": {
2074      "enabled": true,
2075      "max_severity": "warning"
2076    }
2077  }
2078}
2079```
2080
2081## Git
2082
2083- Description: Configuration for git-related features.
2084- Setting: `git`
2085- Default:
2086
2087```json [settings]
2088{
2089  "git": {
2090    "git_gutter": "tracked_files",
2091    "inline_blame": {
2092      "enabled": true
2093    },
2094    "branch_picker": {
2095      "show_author_name": true
2096    },
2097    "hunk_style": "staged_hollow"
2098  }
2099}
2100```
2101
2102### Git Gutter
2103
2104- Description: Whether or not to show the git gutter.
2105- Setting: `git_gutter`
2106- Default: `tracked_files`
2107
2108**Options**
2109
21101. Show git gutter in tracked files
2111
2112```json [settings]
2113{
2114  "git": {
2115    "git_gutter": "tracked_files"
2116  }
2117}
2118```
2119
21202. Hide git gutter
2121
2122```json [settings]
2123{
2124  "git": {
2125    "git_gutter": "hide"
2126  }
2127}
2128```
2129
2130### Gutter Debounce
2131
2132- Description: Sets the debounce threshold (in milliseconds) after which changes are reflected in the git gutter.
2133- Setting: `gutter_debounce`
2134- Default: `null`
2135
2136**Options**
2137
2138`integer` values representing milliseconds
2139
2140Example:
2141
2142```json [settings]
2143{
2144  "git": {
2145    "gutter_debounce": 100
2146  }
2147}
2148```
2149
2150### Inline Git Blame
2151
2152- Description: Whether or not to show git blame information inline, on the currently focused line.
2153- Setting: `inline_blame`
2154- Default:
2155
2156```json [settings]
2157{
2158  "git": {
2159    "inline_blame": {
2160      "enabled": true
2161    }
2162  }
2163}
2164```
2165
2166**Options**
2167
21681. Disable inline git blame:
2169
2170```json [settings]
2171{
2172  "git": {
2173    "inline_blame": {
2174      "enabled": false
2175    }
2176  }
2177}
2178```
2179
21802. Only show inline git blame after a delay (that starts after cursor stops moving):
2181
2182```json [settings]
2183{
2184  "git": {
2185    "inline_blame": {
2186      "delay_ms": 500
2187    }
2188  }
2189}
2190```
2191
21923. Show a commit summary next to the commit date and author:
2193
2194```json [settings]
2195{
2196  "git": {
2197    "inline_blame": {
2198      "show_commit_summary": true
2199    }
2200  }
2201}
2202```
2203
22044. Use this as the minimum column at which to display inline blame information:
2205
2206```json [settings]
2207{
2208  "git": {
2209    "inline_blame": {
2210      "min_column": 80
2211    }
2212  }
2213}
2214```
2215
22165. Set the padding between the end of the line and the inline blame hint, in ems:
2217
2218```json [settings]
2219{
2220  "git": {
2221    "inline_blame": {
2222      "padding": 10
2223    }
2224  }
2225}
2226```
2227
2228### Branch Picker
2229
2230- Description: Configuration related to the branch picker.
2231- Setting: `branch_picker`
2232- Default:
2233
2234```json [settings]
2235{
2236  "git": {
2237    "branch_picker": {
2238      "show_author_name": false
2239    }
2240  }
2241}
2242```
2243
2244**Options**
2245
22461. Show the author name in the branch picker:
2247
2248```json [settings]
2249{
2250  "git": {
2251    "branch_picker": {
2252      "show_author_name": true
2253    }
2254  }
2255}
2256```
2257
2258### Hunk Style
2259
2260- Description: What styling we should use for the diff hunks.
2261- Setting: `hunk_style`
2262- Default:
2263
2264```json [settings]
2265{
2266  "git": {
2267    "hunk_style": "staged_hollow"
2268  }
2269}
2270```
2271
2272**Options**
2273
22741. Show the staged hunks faded out and with a border:
2275
2276```json [settings]
2277{
2278  "git": {
2279    "hunk_style": "staged_hollow"
2280  }
2281}
2282```
2283
22842. Show unstaged hunks faded out and with a border:
2285
2286```json [settings]
2287{
2288  "git": {
2289    "hunk_style": "unstaged_hollow"
2290  }
2291}
2292```
2293
2294## Go to Definition Fallback
2295
2296- Description: What to do when the {#action editor::GoToDefinition} action fails to find a definition
2297- Setting: `go_to_definition_fallback`
2298- Default: `"find_all_references"`
2299
2300**Options**
2301
23021. Do nothing:
2303
2304```json [settings]
2305{
2306  "go_to_definition_fallback": "none"
2307}
2308```
2309
23102. Find references for the same symbol (default):
2311
2312```json [settings]
2313{
2314  "go_to_definition_fallback": "find_all_references"
2315}
2316```
2317
2318## Hard Tabs
2319
2320- Description: Whether to indent lines using tab characters or multiple spaces.
2321- Setting: `hard_tabs`
2322- Default: `false`
2323
2324**Options**
2325
2326`boolean` values
2327
2328## Helix Mode
2329
2330- Description: Whether or not to enable Helix mode. Enabling `helix_mode` also enables `vim_mode`. See the [Helix documentation](./helix.md) for more details.
2331- Setting: `helix_mode`
2332- Default: `false`
2333
2334**Options**
2335
2336`boolean` values
2337
2338## Indent Guides
2339
2340- Description: Configuration related to indent guides. Indent guides can be configured separately for each language.
2341- Setting: `indent_guides`
2342- Default:
2343
2344```json [settings]
2345{
2346  "indent_guides": {
2347    "enabled": true,
2348    "line_width": 1,
2349    "active_line_width": 1,
2350    "coloring": "fixed",
2351    "background_coloring": "disabled"
2352  }
2353}
2354```
2355
2356**Options**
2357
23581. Disable indent guides
2359
2360```json [settings]
2361{
2362  "indent_guides": {
2363    "enabled": false
2364  }
2365}
2366```
2367
23682. Enable indent guides for a specific language.
2369
2370```json [settings]
2371{
2372  "languages": {
2373    "Python": {
2374      "indent_guides": {
2375        "enabled": true
2376      }
2377    }
2378  }
2379}
2380```
2381
23823. Enable indent aware coloring ("rainbow indentation").
2383   The colors that are used for different indentation levels are defined in the theme (theme key: `accents`). They can be customized by using theme overrides.
2384
2385```json [settings]
2386{
2387  "indent_guides": {
2388    "enabled": true,
2389    "coloring": "indent_aware"
2390  }
2391}
2392```
2393
23944. Enable indent aware background coloring ("rainbow indentation").
2395   The colors that are used for different indentation levels are defined in the theme (theme key: `accents`). They can be customized by using theme overrides.
2396
2397```json [settings]
2398{
2399  "indent_guides": {
2400    "enabled": true,
2401    "coloring": "indent_aware",
2402    "background_coloring": "indent_aware"
2403  }
2404}
2405```
2406
2407## Hover Popover Enabled
2408
2409- Description: Whether or not to show the informational hover box when moving the mouse over symbols in the editor.
2410- Setting: `hover_popover_enabled`
2411- Default: `true`
2412
2413**Options**
2414
2415`boolean` values
2416
2417## Hover Popover Delay
2418
2419- Description: Time to wait in milliseconds before showing the informational hover box.
2420- Setting: `hover_popover_delay`
2421- Default: `300`
2422
2423**Options**
2424
2425`integer` values representing milliseconds
2426
2427## Icon Theme
2428
2429- Description: The icon theme setting can be specified in two forms - either as the name of an icon theme or as an object containing the `mode`, `dark`, and `light` icon themes for files/folders inside Zed.
2430- Setting: `icon_theme`
2431- Default: `Zed (Default)`
2432
2433### Icon Theme Object
2434
2435- Description: Specify the icon theme using an object that includes the `mode`, `dark`, and `light`.
2436- Setting: `icon_theme`
2437- Default:
2438
2439```json [settings]
2440"icon_theme": {
2441  "mode": "system",
2442  "dark": "Zed (Default)",
2443  "light": "Zed (Default)"
2444},
2445```
2446
2447### Mode
2448
2449- Description: Specify the icon theme mode.
2450- Setting: `mode`
2451- Default: `system`
2452
2453**Options**
2454
24551. Set the icon theme to dark mode
2456
2457```json [settings]
2458{
2459  "mode": "dark"
2460}
2461```
2462
24632. Set the icon theme to light mode
2464
2465```json [settings]
2466{
2467  "mode": "light"
2468}
2469```
2470
24713. Set the icon theme to system mode
2472
2473```json [settings]
2474{
2475  "mode": "system"
2476}
2477```
2478
2479### Dark
2480
2481- Description: The name of the dark icon theme.
2482- Setting: `dark`
2483- Default: `Zed (Default)`
2484
2485**Options**
2486
2487Run the {#action icon_theme_selector::Toggle} action in the command palette to see a current list of valid icon themes names.
2488
2489### Light
2490
2491- Description: The name of the light icon theme.
2492- Setting: `light`
2493- Default: `Zed (Default)`
2494
2495**Options**
2496
2497Run the {#action icon_theme_selector::Toggle} action in the command palette to see a current list of valid icon themes names.
2498
2499## Image Viewer
2500
2501- Description: Settings for image viewer functionality
2502- Setting: `image_viewer`
2503- Default:
2504
2505```json [settings]
2506{
2507  "image_viewer": {
2508    "unit": "binary"
2509  }
2510}
2511```
2512
2513**Options**
2514
2515### Unit
2516
2517- Description: The unit for image file sizes
2518- Setting: `unit`
2519- Default: `"binary"`
2520
2521**Options**
2522
25231. Use binary units (KiB, MiB):
2524
2525```json [settings]
2526{
2527  "image_viewer": {
2528    "unit": "binary"
2529  }
2530}
2531```
2532
25332. Use decimal units (KB, MB):
2534
2535```json [settings]
2536{
2537  "image_viewer": {
2538    "unit": "decimal"
2539  }
2540}
2541```
2542
2543## Inlay hints
2544
2545- Description: Configuration for displaying extra text with hints in the editor.
2546- Setting: `inlay_hints`
2547- Default:
2548
2549```json [settings]
2550"inlay_hints": {
2551  "enabled": false,
2552  "show_type_hints": true,
2553  "show_parameter_hints": true,
2554  "show_other_hints": true,
2555  "show_background": false,
2556  "edit_debounce_ms": 700,
2557  "scroll_debounce_ms": 50,
2558  "toggle_on_modifiers_press": null
2559}
2560```
2561
2562**Options**
2563
2564Inlay hints querying consists of two parts: editor (client) and LSP server.
2565With the inlay settings above are changed to enable the hints, editor will start to query certain types of hints and react on LSP hint refresh request from the server.
2566At this point, the server may or may not return hints depending on its implementation, further configuration might be needed, refer to the corresponding LSP server documentation.
2567
2568The following languages have inlay hints preconfigured by Zed:
2569
2570- [Go](https://docs.zed.dev/languages/go)
2571- [Rust](https://docs.zed.dev/languages/rust)
2572- [Svelte](https://docs.zed.dev/languages/svelte)
2573- [TypeScript](https://docs.zed.dev/languages/typescript)
2574
2575Use the `lsp` section for the server configuration. Examples are provided in the corresponding language documentation.
2576
2577Hints are not instantly queried in Zed, two kinds of debounces are used, either may be set to 0 to be disabled.
2578Settings-related hint updates are not debounced.
2579
2580All possible config values for `toggle_on_modifiers_press` are:
2581
2582```json [settings]
2583"inlay_hints": {
2584  "toggle_on_modifiers_press": {
2585    "control": true,
2586    "shift": true,
2587    "alt": true,
2588    "platform": true,
2589    "function": true
2590  }
2591}
2592```
2593
2594Unspecified values have a `false` value, hints won't be toggled if all the modifiers are `false` or not all the modifiers are pressed.
2595
2596## Journal
2597
2598- Description: Configuration for the journal.
2599- Setting: `journal`
2600- Default:
2601
2602```json [settings]
2603"journal": {
2604  "path": "~",
2605  "hour_format": "hour12"
2606}
2607
2608```
2609
2610### Path
2611
2612- Description: The path of the directory where journal entries are stored. If an invalid path is specified, the journal will fall back to using `~` (the home directory).
2613- Setting: `path`
2614- Default: `~`
2615
2616**Options**
2617
2618`string` values
2619
2620### Hour Format
2621
2622- Description: The format to use for displaying hours in the journal.
2623- Setting: `hour_format`
2624- Default: `hour12`
2625
2626**Options**
2627
26281. 12-hour format:
2629
2630```json [settings]
2631{
2632  "hour_format": "hour12"
2633}
2634```
2635
26362. 24-hour format:
2637
2638```json [settings]
2639{
2640  "hour_format": "hour24"
2641}
2642```
2643
2644## JSX Tag Auto Close
2645
2646- Description: Whether to automatically close JSX tags
2647- Setting: `jsx_tag_auto_close`
2648- Default:
2649
2650```json [settings]
2651{
2652  "jsx_tag_auto_close": {
2653    "enabled": true
2654  }
2655}
2656```
2657
2658**Options**
2659
2660- `enabled`: Whether to enable automatic JSX tag closing
2661
2662## Languages
2663
2664- Description: Configuration for specific languages.
2665- Setting: `languages`
2666- Default: `null`
2667
2668**Options**
2669
2670To override settings for a language, add an entry for that languages name to the `languages` value. Example:
2671
2672```json [settings]
2673"languages": {
2674  "C": {
2675    "format_on_save": "off",
2676    "preferred_line_length": 64,
2677    "soft_wrap": "preferred_line_length"
2678  },
2679  "JSON": {
2680    "tab_size": 4
2681  }
2682}
2683```
2684
2685The following settings can be overridden for each specific language:
2686
2687- [`enable_language_server`](#enable-language-server)
2688- [`ensure_final_newline_on_save`](#ensure-final-newline-on-save)
2689- [`format_on_save`](#format-on-save)
2690- [`formatter`](#formatter)
2691- [`hard_tabs`](#hard-tabs)
2692- [`preferred_line_length`](#preferred-line-length)
2693- [`remove_trailing_whitespace_on_save`](#remove-trailing-whitespace-on-save)
2694- [`show_edit_predictions`](#show-edit-predictions)
2695- [`show_whitespaces`](#show-whitespaces)
2696- [`whitespace_map`](#whitespace-map)
2697- [`soft_wrap`](#soft-wrap)
2698- [`tab_size`](#tab-size)
2699- [`use_autoclose`](#use-autoclose)
2700- [`always_treat_brackets_as_autoclosed`](#always-treat-brackets-as-autoclosed)
2701
2702These values take in the same options as the root-level settings with the same name.
2703
2704## Language Models
2705
2706- Description: Configuration for language model providers
2707- Setting: `language_models`
2708- Default:
2709
2710```json [settings]
2711{
2712  "language_models": {
2713    "anthropic": {
2714      "api_url": "https://api.anthropic.com"
2715    },
2716    "google": {
2717      "api_url": "https://generativelanguage.googleapis.com"
2718    },
2719    "ollama": {
2720      "api_url": "http://localhost:11434"
2721    },
2722    "openai": {
2723      "api_url": "https://api.openai.com/v1"
2724    }
2725  }
2726}
2727```
2728
2729**Options**
2730
2731Configuration for various AI model providers including API URLs and authentication settings.
2732
2733## Line Indicator Format
2734
2735- Description: Format for line indicator in the status bar
2736- Setting: `line_indicator_format`
2737- Default: `"short"`
2738
2739**Options**
2740
27411. Short format:
2742
2743```json [settings]
2744{
2745  "line_indicator_format": "short"
2746}
2747```
2748
27492. Long format:
2750
2751```json [settings]
2752{
2753  "line_indicator_format": "long"
2754}
2755```
2756
2757## Linked Edits
2758
2759- Description: Whether to perform linked edits of associated ranges, if the language server supports it. For example, when editing opening `<html>` tag, the contents of the closing `</html>` tag will be edited as well.
2760- Setting: `linked_edits`
2761- Default: `true`
2762
2763**Options**
2764
2765`boolean` values
2766
2767## LSP Document Colors
2768
2769- Description: Whether to show document color information from the language server
2770- Setting: `lsp_document_colors`
2771- Default: `true`
2772
2773**Options**
2774
2775`boolean` values
2776
2777## Max Tabs
2778
2779- Description: Maximum number of tabs to show in the tab bar
2780- Setting: `max_tabs`
2781- Default: `null`
2782
2783**Options**
2784
2785Positive `integer` values or `null` for unlimited tabs
2786
2787## Middle Click Paste (Linux only)
2788
2789- Description: Enable middle-click paste on Linux
2790- Setting: `middle_click_paste`
2791- Default: `true`
2792
2793**Options**
2794
2795`boolean` values
2796
2797## Multi Cursor Modifier
2798
2799- Description: Determines the modifier to be used to add multiple cursors with the mouse. The open hover link mouse gestures will adapt such that it do not conflict with the multicursor modifier.
2800- Setting: `multi_cursor_modifier`
2801- Default: `alt`
2802
2803**Options**
2804
28051. Maps to `Alt` on Linux and Windows and to `Option` on macOS:
2806
2807```json [settings]
2808{
2809  "multi_cursor_modifier": "alt"
2810}
2811```
2812
28132. Maps `Control` on Linux and Windows and to `Command` on macOS:
2814
2815```json [settings]
2816{
2817  "multi_cursor_modifier": "cmd_or_ctrl" // alias: "cmd", "ctrl"
2818}
2819```
2820
2821## Node
2822
2823- Description: Configuration for Node.js integration
2824- Setting: `node`
2825- Default:
2826
2827```json [settings]
2828{
2829  "node": {
2830    "ignore_system_version": false,
2831    "path": null,
2832    "npm_path": null
2833  }
2834}
2835```
2836
2837**Options**
2838
2839- `ignore_system_version`: Whether to ignore the system Node.js version
2840- `path`: Custom path to Node.js binary
2841- `npm_path`: Custom path to npm binary
2842
2843## Network Proxy
2844
2845- Description: Configure a network proxy for Zed.
2846- Setting: `proxy`
2847- Default: `null`
2848
2849**Options**
2850
2851The proxy setting must contain a URL to the proxy.
2852
2853The following URI schemes are supported:
2854
2855- `http`
2856- `https`
2857- `socks4` - SOCKS4 proxy with local DNS
2858- `socks4a` - SOCKS4 proxy with remote DNS
2859- `socks5` - SOCKS5 proxy with local DNS
2860- `socks5h` - SOCKS5 proxy with remote DNS
2861
2862`http` will be used when no scheme is specified.
2863
2864By default no proxy will be used, or Zed will attempt to retrieve proxy settings from environment variables, such as `http_proxy`, `HTTP_PROXY`, `https_proxy`, `HTTPS_PROXY`, `all_proxy`, `ALL_PROXY`, `no_proxy` and `NO_PROXY`.
2865
2866For example, to set an `http` proxy, add the following to your settings:
2867
2868```json [settings]
2869{
2870  "proxy": "http://127.0.0.1:10809"
2871}
2872```
2873
2874Or to set a `socks5` proxy:
2875
2876```json [settings]
2877{
2878  "proxy": "socks5h://localhost:10808"
2879}
2880```
2881
2882If you wish to exclude certain hosts from using the proxy, set the `NO_PROXY` environment variable. This accepts a comma-separated list of hostnames, host suffixes, IPv4/IPv6 addresses or blocks that should not use the proxy. For example if your environment included `NO_PROXY="google.com, 192.168.1.0/24"` all hosts in `192.168.1.*`, `google.com` and `*.google.com` would bypass the proxy. See [reqwest NoProxy docs](https://docs.rs/reqwest/latest/reqwest/struct.NoProxy.html#method.from_string) for more.
2883
2884## On Last Window Closed
2885
2886- Description: What to do when the last window is closed
2887- Setting: `on_last_window_closed`
2888- Default: `"platform_default"`
2889
2890**Options**
2891
28921. Use platform default behavior:
2893
2894```json [settings]
2895{
2896  "on_last_window_closed": "platform_default"
2897}
2898```
2899
29002. Always quit the application:
2901
2902```json [settings]
2903{
2904  "on_last_window_closed": "quit_app"
2905}
2906```
2907
2908## Profiles
2909
2910- Description: Configuration profiles that can be applied on top of existing settings
2911- Setting: `profiles`
2912- Default: `{}`
2913
2914**Options**
2915
2916Configuration object for defining settings profiles. Example:
2917
2918```json [settings]
2919{
2920  "profiles": {
2921    "presentation": {
2922      "buffer_font_size": 20,
2923      "ui_font_size": 18,
2924      "theme": "One Light"
2925    }
2926  }
2927}
2928```
2929
2930## Preview tabs
2931
2932- Description:
2933  Preview tabs allow you to open files in preview mode, where they close automatically when you switch to another file unless you explicitly pin them. This is useful for quickly viewing files without cluttering your workspace. Preview tabs display their file names in italics. \
2934   There are several ways to convert a preview tab into a regular tab:
2935
2936  - Double-clicking on the file
2937  - Double-clicking on the tab header
2938  - Using the {#action project_panel::OpenPermanent} action
2939  - Editing the file
2940  - Dragging the file to a different pane
2941
2942- Setting: `preview_tabs`
2943- Default:
2944
2945```json [settings]
2946"preview_tabs": {
2947  "enabled": true,
2948  "enable_preview_from_project_panel": true,
2949  "enable_preview_from_file_finder": false,
2950  "enable_preview_from_multibuffer": true,
2951  "enable_preview_multibuffer_from_code_navigation": false,
2952  "enable_preview_file_from_code_navigation": true,
2953  "enable_keep_preview_on_code_navigation": false,
2954}
2955```
2956
2957### Enable preview from project panel
2958
2959- Description: Determines whether to open files in preview mode when opened from the project panel with a single click.
2960- Setting: `enable_preview_from_project_panel`
2961- Default: `true`
2962
2963**Options**
2964
2965`boolean` values
2966
2967### Enable preview from file finder
2968
2969- Description: Determines whether to open files in preview mode when selected from the file finder.
2970- Setting: `enable_preview_from_file_finder`
2971- Default: `false`
2972
2973**Options**
2974
2975`boolean` values
2976
2977### Enable preview from multibuffer
2978
2979- Description: Determines whether to open files in preview mode when opened from a multibuffer.
2980- Setting: `enable_preview_from_multibuffer`
2981- Default: `true`
2982
2983**Options**
2984
2985`boolean` values
2986
2987### Enable preview multibuffer from code navigation
2988
2989- Description: Determines whether to open tabs in preview mode when code navigation is used to open a multibuffer.
2990- Setting: `enable_preview_multibuffer_from_code_navigation`
2991- Default: `false`
2992
2993**Options**
2994
2995`boolean` values
2996
2997### Enable preview file from code navigation
2998
2999- Description: Determines whether to open tabs in preview mode when code navigation is used to open a single file.
3000- Setting: `enable_preview_file_from_code_navigation`
3001- Default: `true`
3002
3003**Options**
3004
3005`boolean` values
3006
3007### Enable keep preview on code navigation
3008
3009- Description: Determines whether to keep tabs in preview mode when code navigation is used to navigate away from them. If `enable_preview_file_from_code_navigation` or `enable_preview_multibuffer_from_code_navigation` is also true, the new tab may replace the existing one.
3010- Setting: `enable_keep_preview_on_code_navigation`
3011- Default: `false`
3012
3013**Options**
3014
3015`boolean` values
3016
3017## File Finder
3018
3019### File Icons
3020
3021- Description: Whether to show file icons in the file finder.
3022- Setting: `file_icons`
3023- Default: `true`
3024
3025### Modal Max Width
3026
3027- Description: Max-width of the file finder modal. It can take one of these values: `small`, `medium`, `large`, `xlarge`, and `full`.
3028- Setting: `modal_max_width`
3029- Default: `small`
3030
3031### Skip Focus For Active In Search
3032
3033- Description: Determines whether the file finder should skip focus for the active file in search results.
3034- Setting: `skip_focus_for_active_in_search`
3035- Default: `true`
3036
3037## Pane Split Direction Horizontal
3038
3039- Description: The direction that you want to split panes horizontally
3040- Setting: `pane_split_direction_horizontal`
3041- Default: `"up"`
3042
3043**Options**
3044
30451. Split upward:
3046
3047```json [settings]
3048{
3049  "pane_split_direction_horizontal": "up"
3050}
3051```
3052
30532. Split downward:
3054
3055```json [settings]
3056{
3057  "pane_split_direction_horizontal": "down"
3058}
3059```
3060
3061## Pane Split Direction Vertical
3062
3063- Description: The direction that you want to split panes vertically
3064- Setting: `pane_split_direction_vertical`
3065- Default: `"left"`
3066
3067**Options**
3068
30691. Split to the left:
3070
3071```json [settings]
3072{
3073  "pane_split_direction_vertical": "left"
3074}
3075```
3076
30772. Split to the right:
3078
3079```json [settings]
3080{
3081  "pane_split_direction_vertical": "right"
3082}
3083```
3084
3085## Preferred Line Length
3086
3087- Description: The column at which to soft-wrap lines, for buffers where soft-wrap is enabled.
3088- Setting: `preferred_line_length`
3089- Default: `80`
3090
3091**Options**
3092
3093`integer` values
3094
3095## Private Files
3096
3097- Description: Globs to match against file paths to determine if a file is private
3098- Setting: `private_files`
3099- Default: `["**/.env*", "**/*.pem", "**/*.key", "**/*.cert", "**/*.crt", "**/secrets.yml"]`
3100
3101**Options**
3102
3103List of `string` glob patterns
3104
3105## Projects Online By Default
3106
3107- Description: Whether or not to show the online projects view by default.
3108- Setting: `projects_online_by_default`
3109- Default: `true`
3110
3111**Options**
3112
3113`boolean` values
3114
3115## Read SSH Config
3116
3117- Description: Whether to read SSH configuration files
3118- Setting: `read_ssh_config`
3119- Default: `true`
3120
3121**Options**
3122
3123`boolean` values
3124
3125## Redact Private Values
3126
3127- Description: Hide the values of variables from visual display in private files
3128- Setting: `redact_private_values`
3129- Default: `false`
3130
3131**Options**
3132
3133`boolean` values
3134
3135## Relative Line Numbers
3136
3137- Description: Whether to show relative line numbers in the gutter
3138- Setting: `relative_line_numbers`
3139- Default: `"disabled"`
3140
3141**Options**
3142
31431. Show relative line numbers in the gutter whilst counting wrapped lines as one line:
3144
3145```json [settings]
3146{
3147  "relative_line_numbers": "enabled"
3148}
3149```
3150
31512. Show relative line numbers in the gutter, including wrapped lines in the counting:
3152
3153```json [settings]
3154{
3155  "relative_line_numbers": "wrapped"
3156}
3157```
3158
31592. Do not use relative line numbers:
3160
3161```json [settings]
3162{
3163  "relative_line_numbers": "disabled"
3164}
3165```
3166
3167## Remove Trailing Whitespace On Save
3168
3169- Description: Whether or not to remove any trailing whitespace from lines of a buffer before saving it.
3170- Setting: `remove_trailing_whitespace_on_save`
3171- Default: `true`
3172
3173**Options**
3174
3175`boolean` values
3176
3177## Resize All Panels In Dock
3178
3179- Description: Whether to resize all the panels in a dock when resizing the dock. Can be a combination of "left", "right" and "bottom".
3180- Setting: `resize_all_panels_in_dock`
3181- Default: `["left"]`
3182
3183**Options**
3184
3185List of strings containing any combination of:
3186
3187- `"left"`: Resize left dock panels together
3188- `"right"`: Resize right dock panels together
3189- `"bottom"`: Resize bottom dock panels together
3190
3191## Restore on File Reopen
3192
3193- Description: Whether to attempt to restore previous file's state when opening it again. The state is stored per pane.
3194- Setting: `restore_on_file_reopen`
3195- Default: `true`
3196
3197**Options**
3198
3199`boolean` values
3200
3201## Restore on Startup
3202
3203- Description: Controls session restoration on startup.
3204- Setting: `restore_on_startup`
3205- Default: `last_session`
3206
3207**Options**
3208
32091. Restore all workspaces that were open when quitting Zed:
3210
3211```json [settings]
3212{
3213  "restore_on_startup": "last_session"
3214}
3215```
3216
32172. Restore the workspace that was closed last:
3218
3219```json [settings]
3220{
3221  "restore_on_startup": "last_workspace"
3222}
3223```
3224
32253. Always start with an empty editor:
3226
3227```json [settings]
3228{
3229  "restore_on_startup": "empty_tab"
3230}
3231```
3232
32334. Always start with the welcome launchpad:
3234
3235```json [settings]
3236{
3237  "restore_on_startup": "launchpad"
3238}
3239```
3240
3241## Scroll Beyond Last Line
3242
3243- Description: Whether the editor will scroll beyond the last line
3244- Setting: `scroll_beyond_last_line`
3245- Default: `"one_page"`
3246
3247**Options**
3248
32491. Scroll one page beyond the last line by one page:
3250
3251```json [settings]
3252{
3253  "scroll_beyond_last_line": "one_page"
3254}
3255```
3256
32572. The editor will scroll beyond the last line by the same amount of lines as `vertical_scroll_margin`:
3258
3259```json [settings]
3260{
3261  "scroll_beyond_last_line": "vertical_scroll_margin"
3262}
3263```
3264
32653. The editor will not scroll beyond the last line:
3266
3267```json [settings]
3268{
3269  "scroll_beyond_last_line": "off"
3270}
3271```
3272
3273**Options**
3274
3275`boolean` values
3276
3277## Scroll Sensitivity
3278
3279- Description: Scroll sensitivity multiplier. This multiplier is applied to both the horizontal and vertical delta values while scrolling.
3280- Setting: `scroll_sensitivity`
3281- Default: `1.0`
3282
3283**Options**
3284
3285Positive `float` values
3286
3287### Fast Scroll Sensitivity
3288
3289- Description: Scroll sensitivity multiplier for fast scrolling. This multiplier is applied to both the horizontal and vertical delta values while scrolling. Fast scrolling happens when a user holds the alt or option key while scrolling.
3290- Setting: `fast_scroll_sensitivity`
3291- Default: `4.0`
3292
3293**Options**
3294
3295Positive `float` values
3296
3297### Horizontal Scroll Margin
3298
3299- Description: The number of characters to keep on either side when scrolling with the mouse
3300- Setting: `horizontal_scroll_margin`
3301- Default: `5`
3302
3303**Options**
3304
3305Non-negative `integer` values
3306
3307### Vertical Scroll Margin
3308
3309- Description: The number of lines to keep above/below the cursor when scrolling with the keyboard
3310- Setting: `vertical_scroll_margin`
3311- Default: `3`
3312
3313**Options**
3314
3315Non-negative `integer` values
3316
3317## Search
3318
3319- Description: Search options to enable by default when opening new project and buffer searches.
3320- Setting: `search`
3321- Default:
3322
3323```json [settings]
3324"search": {
3325  "button": true,
3326  "whole_word": false,
3327  "case_sensitive": false,
3328  "include_ignored": false,
3329  "regex": false,
3330  "center_on_match": false
3331},
3332```
3333
3334### Button
3335
3336- Description: Whether to show the project search button in the status bar.
3337- Setting: `button`
3338- Default: `true`
3339
3340### Whole Word
3341
3342- Description: Whether to only match on whole words.
3343- Setting: `whole_word`
3344- Default: `false`
3345
3346### Case Sensitive
3347
3348- Description: Whether to match case sensitively. This setting affects both
3349  searches and editor actions like "Select Next Occurrence", "Select Previous
3350  Occurrence", and "Select All Occurrences".
3351- Setting: `case_sensitive`
3352- Default: `false`
3353
3354### Include Ignore
3355
3356- Description: Whether to include gitignored files in search results.
3357- Setting: `include_ignored`
3358- Default: `false`
3359
3360### Regex
3361
3362- Description: Whether to interpret the search query as a regular expression.
3363- Setting: `regex`
3364- Default: `false`
3365
3366### Center On Match
3367
3368- Description: Whether to center the cursor on each search match when navigating.
3369- Setting: `center_on_match`
3370- Default: `false`
3371
3372## Search Wrap
3373
3374- Description: If `search_wrap` is disabled, search result do not wrap around the end of the file
3375- Setting: `search_wrap`
3376- Default: `true`
3377
3378## Center on Match
3379
3380- Description: If `center_on_match` is enabled, the editor will center the cursor on the current match when searching.
3381- Setting: `center_on_match`
3382- Default: `false`
3383
3384## Seed Search Query From Cursor
3385
3386- Description: When to populate a new search's query based on the text under the cursor.
3387- Setting: `seed_search_query_from_cursor`
3388- Default: `always`
3389
3390**Options**
3391
33921. `always` always populate the search query with the word under the cursor
33932. `selection` only populate the search query when there is text selected
33943. `never` never populate the search query
3395
3396## Use Smartcase Search
3397
3398- Description: When enabled, automatically adjusts search case sensitivity based on your query. If your search query contains any uppercase letters, the search becomes case-sensitive; if it contains only lowercase letters, the search becomes case-insensitive. \
3399  This applies to both in-file searches and project-wide searches.
3400- Setting: `use_smartcase_search`
3401- Default: `false`
3402
3403**Options**
3404
3405`boolean` values
3406
3407Examples:
3408
3409- Searching for "function" would match "function", "Function", "FUNCTION", etc.
3410- Searching for "Function" would only match "Function", not "function" or "FUNCTION"
3411
3412## Show Call Status Icon
3413
3414- Description: Whether or not to show the call status icon in the status bar.
3415- Setting: `show_call_status_icon`
3416- Default: `true`
3417
3418**Options**
3419
3420`boolean` values
3421
3422## Completions
3423
3424- Description: Controls how completions are processed for this language.
3425- Setting: `completions`
3426- Default:
3427
3428```json [settings]
3429{
3430  "completions": {
3431    "words": "fallback",
3432    "words_min_length": 3,
3433    "lsp": true,
3434    "lsp_fetch_timeout_ms": 0,
3435    "lsp_insert_mode": "replace_suffix"
3436  }
3437}
3438```
3439
3440### Words
3441
3442- Description: Controls how words are completed. For large documents, not all words may be fetched for completion.
3443- Setting: `words`
3444- Default: `fallback`
3445
3446**Options**
3447
34481. `enabled` - Always fetch document's words for completions along with LSP completions
34492. `fallback` - Only if LSP response errors or times out, use document's words to show completions
34503. `disabled` - Never fetch or complete document's words for completions (word-based completions can still be queried via a separate action)
3451
3452### Min Words Query Length
3453
3454- Description: Minimum number of characters required to automatically trigger word-based completions.
3455  Before that value, it's still possible to trigger the words-based completion manually with the corresponding editor command.
3456- Setting: `words_min_length`
3457- Default: `3`
3458
3459**Options**
3460
3461Positive integer values
3462
3463### LSP
3464
3465- Description: Whether to fetch LSP completions or not.
3466- Setting: `lsp`
3467- Default: `true`
3468
3469**Options**
3470
3471`boolean` values
3472
3473### LSP Fetch Timeout (ms)
3474
3475- Description: When fetching LSP completions, determines how long to wait for a response of a particular server. When set to 0, waits indefinitely.
3476- Setting: `lsp_fetch_timeout_ms`
3477- Default: `0`
3478
3479**Options**
3480
3481`integer` values representing milliseconds
3482
3483### LSP Insert Mode
3484
3485- Description: Controls what range to replace when accepting LSP completions.
3486- Setting: `lsp_insert_mode`
3487- Default: `replace_suffix`
3488
3489**Options**
3490
34911. `insert` - Replaces text before the cursor, using the `insert` range described in the LSP specification
34922. `replace` - Replaces text before and after the cursor, using the `replace` range described in the LSP specification
34933. `replace_subsequence` - Behaves like `"replace"` if the text that would be replaced is a subsequence of the completion text, and like `"insert"` otherwise
34944. `replace_suffix` - Behaves like `"replace"` if the text after the cursor is a suffix of the completion, and like `"insert"` otherwise
3495
3496## Show Completions On Input
3497
3498- Description: Whether or not to show completions as you type.
3499- Setting: `show_completions_on_input`
3500- Default: `true`
3501
3502**Options**
3503
3504`boolean` values
3505
3506## Show Completion Documentation
3507
3508- Description: Whether to display inline and alongside documentation for items in the completions menu.
3509- Setting: `show_completion_documentation`
3510- Default: `true`
3511
3512**Options**
3513
3514`boolean` values
3515
3516## Show Edit Predictions
3517
3518- Description: Whether to show edit predictions as you type or manually by triggering `editor::ShowEditPrediction`.
3519- Setting: `show_edit_predictions`
3520- Default: `true`
3521
3522**Options**
3523
3524`boolean` values
3525
3526## Show Whitespaces
3527
3528- Description: Whether or not to render whitespace characters in the editor.
3529- Setting: `show_whitespaces`
3530- Default: `selection`
3531
3532**Options**
3533
35341. `all`
35352. `selection`
35363. `none`
35374. `boundary`
35385. `trailing`
3539
3540## Whitespace Map
3541
3542- Description: Specify the characters used to render whitespace when show_whitespaces is enabled.
3543- Setting: `whitespace_map`
3544- Default:
3545
3546```json [settings]
3547{
3548  "whitespace_map": {
3549    "space": "•",
3550    "tab": "→"
3551  }
3552}
3553```
3554
3555## Soft Wrap
3556
3557- Description: Whether or not to automatically wrap lines of text to fit editor / preferred width.
3558- Setting: `soft_wrap`
3559- Default: `none`
3560
3561**Options**
3562
35631. `none` to avoid wrapping generally, unless the line is too long
35642. `prefer_line` (deprecated, same as `none`)
35653. `editor_width` to wrap lines that overflow the editor width
35664. `preferred_line_length` to wrap lines that overflow `preferred_line_length` config value
35675. `bounded` to wrap lines at the minimum of `editor_width` and `preferred_line_length`
3568
3569## Show Wrap Guides
3570
3571- Description: Whether to show wrap guides (vertical rulers) in the editor. Setting this to true will show a guide at the 'preferred_line_length' value if 'soft_wrap' is set to 'preferred_line_length', and will show any additional guides as specified by the 'wrap_guides' setting.
3572- Setting: `show_wrap_guides`
3573- Default: `true`
3574
3575**Options**
3576
3577`boolean` values
3578
3579## Use On Type Format
3580
3581- Description: Whether to use additional LSP queries to format (and amend) the code after every "trigger" symbol input, defined by LSP server capabilities
3582- Setting: `use_on_type_format`
3583- Default: `true`
3584
3585**Options**
3586
3587`boolean` values
3588
3589## Use Auto Surround
3590
3591- Description: Whether to automatically surround selected text when typing opening parenthesis, bracket, brace, single or double quote characters. For example, when you select text and type '(', Zed will surround the text with ().
3592- Setting: `use_auto_surround`
3593- Default: `true`
3594
3595**Options**
3596
3597`boolean` values
3598
3599## Use System Path Prompts
3600
3601- Description: Whether to use the system provided dialogs for Open and Save As. When set to false, Zed will use the built-in keyboard-first pickers.
3602- Setting: `use_system_path_prompts`
3603- Default: `true`
3604
3605**Options**
3606
3607`boolean` values
3608
3609## Use System Prompts
3610
3611- Description: Whether to use the system provided dialogs for prompts, such as confirmation prompts. When set to false, Zed will use its built-in prompts. Note that on Linux, this option is ignored and Zed will always use the built-in prompts.
3612- Setting: `use_system_prompts`
3613- Default: `true`
3614
3615**Options**
3616
3617`boolean` values
3618
3619## Wrap Guides (Vertical Rulers)
3620
3621- Description: Where to display vertical rulers as wrap-guides. Disable by setting `show_wrap_guides` to `false`.
3622- Setting: `wrap_guides`
3623- Default: []
3624
3625**Options**
3626
3627List of `integer` column numbers
3628
3629## Tab Size
3630
3631- Description: The number of spaces to use for each tab character.
3632- Setting: `tab_size`
3633- Default: `4`
3634
3635**Options**
3636
3637`integer` values
3638
3639## Tasks
3640
3641- Description: Configuration for tasks that can be run within Zed
3642- Setting: `tasks`
3643- Default:
3644
3645```json [settings]
3646{
3647  "tasks": {
3648    "variables": {},
3649    "enabled": true,
3650    "prefer_lsp": false
3651  }
3652}
3653```
3654
3655**Options**
3656
3657- `variables`: Custom variables for task configuration
3658- `enabled`: Whether tasks are enabled
3659- `prefer_lsp`: Whether to prefer LSP-provided tasks over Zed language extension ones
3660
3661## Telemetry
3662
3663- Description: Control what info is collected by Zed.
3664- Setting: `telemetry`
3665- Default:
3666
3667```json [settings]
3668"telemetry": {
3669  "diagnostics": true,
3670  "metrics": true
3671},
3672```
3673
3674**Options**
3675
3676### Diagnostics
3677
3678- Description: Setting for sending debug-related data, such as crash reports.
3679- Setting: `diagnostics`
3680- Default: `true`
3681
3682**Options**
3683
3684`boolean` values
3685
3686### Metrics
3687
3688- Description: Setting for sending anonymized usage data, such what languages you're using Zed with.
3689- Setting: `metrics`
3690- Default: `true`
3691
3692**Options**
3693
3694`boolean` values
3695
3696## Terminal
3697
3698- Description: Configuration for the terminal.
3699- Setting: `terminal`
3700- Default:
3701
3702```json [settings]
3703{
3704  "terminal": {
3705    "alternate_scroll": "off",
3706    "blinking": "terminal_controlled",
3707    "copy_on_select": false,
3708    "keep_selection_on_copy": true,
3709    "dock": "bottom",
3710    "default_width": 640,
3711    "default_height": 320,
3712    "detect_venv": {
3713      "on": {
3714        "directories": [".env", "env", ".venv", "venv"],
3715        "activate_script": "default"
3716      }
3717    },
3718    "env": {},
3719    "font_family": null,
3720    "font_features": null,
3721    "font_size": null,
3722    "line_height": "comfortable",
3723    "minimum_contrast": 45,
3724    "option_as_meta": false,
3725    "button": true,
3726    "shell": "system",
3727    "scroll_multiplier": 3.0,
3728    "toolbar": {
3729      "breadcrumbs": false
3730    },
3731    "working_directory": "current_project_directory",
3732    "scrollbar": {
3733      "show": null
3734    }
3735  }
3736}
3737```
3738
3739### Terminal: Dock
3740
3741- Description: Control the position of the dock
3742- Setting: `dock`
3743- Default: `bottom`
3744
3745**Options**
3746
3747`"bottom"`, `"left"` or `"right"`
3748
3749### Terminal: Alternate Scroll
3750
3751- Description: Set whether Alternate Scroll mode (DECSET code: `?1007`) is active by default. Alternate Scroll mode converts mouse scroll events into up / down key presses when in the alternate screen (e.g. when running applications like vim or less). The terminal can still set and unset this mode with ANSI escape codes.
3752- Setting: `alternate_scroll`
3753- Default: `off`
3754
3755**Options**
3756
37571. Default alternate scroll mode to off
3758
3759```json [settings]
3760{
3761  "terminal": {
3762    "alternate_scroll": "off"
3763  }
3764}
3765```
3766
37672. Default alternate scroll mode to on
3768
3769```json [settings]
3770{
3771  "terminal": {
3772    "alternate_scroll": "on"
3773  }
3774}
3775```
3776
3777### Terminal: Blinking
3778
3779- Description: Set the cursor blinking behavior in the terminal
3780- Setting: `blinking`
3781- Default: `terminal_controlled`
3782
3783**Options**
3784
37851. Never blink the cursor, ignore the terminal mode
3786
3787```json [settings]
3788{
3789  "terminal": {
3790    "blinking": "off"
3791  }
3792}
3793```
3794
37952. Default the cursor blink to off, but allow the terminal to turn blinking on
3796
3797```json [settings]
3798{
3799  "terminal": {
3800    "blinking": "terminal_controlled"
3801  }
3802}
3803```
3804
38053. Always blink the cursor, ignore the terminal mode
3806
3807```json [settings]
3808{
3809  "terminal": {
3810    "blinking": "on"
3811  }
3812}
3813```
3814
3815### Terminal: Copy On Select
3816
3817- Description: Whether or not selecting text in the terminal will automatically copy to the system clipboard.
3818- Setting: `copy_on_select`
3819- Default: `false`
3820
3821**Options**
3822
3823`boolean` values
3824
3825**Example**
3826
3827```json [settings]
3828{
3829  "terminal": {
3830    "copy_on_select": true
3831  }
3832}
3833```
3834
3835### Terminal: Cursor Shape
3836
3837- Description: Controls the visual shape of the cursor in the terminal. When not explicitly set, it defaults to a block shape.
3838- Setting: `cursor_shape`
3839- Default: `null` (defaults to block)
3840
3841**Options**
3842
38431. A block that surrounds the following character
3844
3845```json [settings]
3846{
3847  "terminal": {
3848    "cursor_shape": "block"
3849  }
3850}
3851```
3852
38532. A vertical bar
3854
3855```json [settings]
3856{
3857  "terminal": {
3858    "cursor_shape": "bar"
3859  }
3860}
3861```
3862
38633. An underline / underscore that runs along the following character
3864
3865```json [settings]
3866{
3867  "terminal": {
3868    "cursor_shape": "underline"
3869  }
3870}
3871```
3872
38734. A box drawn around the following character
3874
3875```json [settings]
3876{
3877  "terminal": {
3878    "cursor_shape": "hollow"
3879  }
3880}
3881```
3882
3883### Terminal: Keep Selection On Copy
3884
3885- Description: Whether or not to keep the selection in the terminal after copying text.
3886- Setting: `keep_selection_on_copy`
3887- Default: `true`
3888
3889**Options**
3890
3891`boolean` values
3892
3893**Example**
3894
3895```json [settings]
3896{
3897  "terminal": {
3898    "keep_selection_on_copy": false
3899  }
3900}
3901```
3902
3903### Terminal: Env
3904
3905- Description: Any key-value pairs added to this object will be added to the terminal's environment. Keys must be unique, use `:` to separate multiple values in a single variable
3906- Setting: `env`
3907- Default: `{}`
3908
3909**Example**
3910
3911```json [settings]
3912{
3913  "terminal": {
3914    "env": {
3915      "ZED": "1",
3916      "KEY": "value1:value2"
3917    }
3918  }
3919}
3920```
3921
3922### Terminal: Font Size
3923
3924- Description: What font size to use for the terminal. When not set defaults to matching the editor's font size
3925- Setting: `font_size`
3926- Default: `null`
3927
3928**Options**
3929
3930`integer` values
3931
3932```json [settings]
3933{
3934  "terminal": {
3935    "font_size": 15
3936  }
3937}
3938```
3939
3940### Terminal: Font Family
3941
3942- Description: What font to use for the terminal. When not set, defaults to matching the editor's font.
3943- Setting: `font_family`
3944- Default: `null`
3945
3946**Options**
3947
3948The name of any font family installed on the user's system
3949
3950```json [settings]
3951{
3952  "terminal": {
3953    "font_family": "Berkeley Mono"
3954  }
3955}
3956```
3957
3958### Terminal: Font Features
3959
3960- Description: What font features to use for the terminal. When not set, defaults to matching the editor's font features.
3961- Setting: `font_features`
3962- Default: `null`
3963- Platform: macOS and Windows.
3964
3965**Options**
3966
3967See Buffer Font Features
3968
3969```json [settings]
3970{
3971  "terminal": {
3972    "font_features": {
3973      "calt": false
3974      // See Buffer Font Features for more features
3975    }
3976  }
3977}
3978```
3979
3980### Terminal: Line Height
3981
3982- Description: Set the terminal's line height.
3983- Setting: `line_height`
3984- Default: `standard`
3985
3986**Options**
3987
39881. Use a line height that's `comfortable` for reading, 1.618.
3989
3990```json [settings]
3991{
3992  "terminal": {
3993    "line_height": "comfortable"
3994  }
3995}
3996```
3997
39982. Use a `standard` line height, 1.3. This option is useful for TUIs, particularly if they use box characters. (default)
3999
4000```json [settings]
4001{
4002  "terminal": {
4003    "line_height": "standard"
4004  }
4005}
4006```
4007
40083.  Use a custom line height.
4009
4010```json [settings]
4011{
4012  "terminal": {
4013    "line_height": {
4014      "custom": 2
4015    }
4016  }
4017}
4018```
4019
4020### Terminal: Minimum Contrast
4021
4022- Description: Controls the minimum contrast between foreground and background colors in the terminal. Uses the APCA (Accessible Perceptual Contrast Algorithm) for color adjustments. Set this to 0 to disable this feature.
4023- Setting: `minimum_contrast`
4024- Default: `45`
4025
4026**Options**
4027
4028`integer` values from 0 to 106. Common recommended values:
4029
4030- `0`: No contrast adjustment
4031- `45`: Minimum for large fluent text (default)
4032- `60`: Minimum for other content text
4033- `75`: Minimum for body text
4034- `90`: Preferred for body text
4035
4036```json [settings]
4037{
4038  "terminal": {
4039    "minimum_contrast": 45
4040  }
4041}
4042```
4043
4044### Terminal: Option As Meta
4045
4046- Description: Re-interprets the option keys to act like a 'meta' key, like in Emacs.
4047- Setting: `option_as_meta`
4048- Default: `false`
4049
4050**Options**
4051
4052`boolean` values
4053
4054```json [settings]
4055{
4056  "terminal": {
4057    "option_as_meta": true
4058  }
4059}
4060```
4061
4062### Terminal: Shell
4063
4064- Description: What shell to use when launching the terminal.
4065- Setting: `shell`
4066- Default: `system`
4067
4068**Options**
4069
40701. Use the system's default terminal configuration (usually the `/etc/passwd` file).
4071
4072```json [settings]
4073{
4074  "terminal": {
4075    "shell": "system"
4076  }
4077}
4078```
4079
40802. A program to launch:
4081
4082```json [settings]
4083{
4084  "terminal": {
4085    "shell": {
4086      "program": "sh"
4087    }
4088  }
4089}
4090```
4091
40923. A program with arguments:
4093
4094```json [settings]
4095{
4096  "terminal": {
4097    "shell": {
4098      "with_arguments": {
4099        "program": "/bin/bash",
4100        "args": ["--login"]
4101      }
4102    }
4103  }
4104}
4105```
4106
4107## Terminal: Detect Virtual Environments {#terminal-detect_venv}
4108
4109- Description: Activate the [Python Virtual Environment](https://docs.python.org/3/library/venv.html), if one is found, in the terminal's working directory (as resolved by the working_directory and automatically activating the virtual environment.
4110- Setting: `detect_venv`
4111- Default:
4112
4113```json [settings]
4114{
4115  "terminal": {
4116    "detect_venv": {
4117      "on": {
4118        // Default directories to search for virtual environments, relative
4119        // to the current working directory. We recommend overriding this
4120        // in your project's settings, rather than globally.
4121        "directories": [".env", "env", ".venv", "venv"],
4122        // Can also be `csh`, `fish`, and `nushell`
4123        "activate_script": "default"
4124      }
4125    }
4126  }
4127}
4128```
4129
4130Disable with:
4131
4132```json [settings]
4133{
4134  "terminal": {
4135    "detect_venv": "off"
4136  }
4137}
4138```
4139
4140### Terminal: Scroll Multiplier
4141
4142- Description: The multiplier for scrolling speed in the terminal when using mouse wheel or trackpad.
4143- Setting: `scroll_multiplier`
4144- Default: `1.0`
4145
4146**Options**
4147
4148Positive floating point values. Values less than or equal to 0 will be clamped to a minimum of 0.01.
4149
4150**Example**
4151
4152```json
4153{
4154  "terminal": {
4155    "scroll_multiplier": 5.0
4156  }
4157}
4158```
4159
4160## Terminal: Toolbar
4161
4162- Description: Whether or not to show various elements in the terminal toolbar.
4163- Setting: `toolbar`
4164- Default:
4165
4166```json [settings]
4167{
4168  "terminal": {
4169    "toolbar": {
4170      "breadcrumbs": false
4171    }
4172  }
4173}
4174```
4175
4176**Options**
4177
4178At the moment, only the `breadcrumbs` option is available, it controls displaying of the terminal title that can be changed via `PROMPT_COMMAND`.
4179
4180If the terminal title is empty, the breadcrumbs won't be shown.
4181
4182The shell running in the terminal needs to be configured to emit the title.
4183
4184Example command to set the title: `echo -e "\e]2;New Title\007";`
4185
4186### Terminal: Button
4187
4188- Description: Control to show or hide the terminal button in the status bar
4189- Setting: `button`
4190- Default: `true`
4191
4192**Options**
4193
4194`boolean` values
4195
4196```json [settings]
4197{
4198  "terminal": {
4199    "button": false
4200  }
4201}
4202```
4203
4204### Terminal: Working Directory
4205
4206- Description: What working directory to use when launching the terminal.
4207- Setting: `working_directory`
4208- Default: `"current_project_directory"`
4209
4210**Options**
4211
42121. Use the current file's project directory. Fallback to the first project directory strategy if unsuccessful.
4213
4214```json [settings]
4215{
4216  "terminal": {
4217    "working_directory": "current_project_directory"
4218  }
4219}
4220```
4221
42222. Use the first project in this workspace's directory. Fallback to using this platform's home directory.
4223
4224```json [settings]
4225{
4226  "terminal": {
4227    "working_directory": "first_project_directory"
4228  }
4229}
4230```
4231
42323. Always use this platform's home directory if it can be found.
4233
4234```json [settings]
4235{
4236  "terminal": {
4237    "working_directory": "always_home"
4238  }
4239}
4240```
4241
42424. Always use a specific directory. This value will be shell expanded. If this path is not a valid directory the terminal will default to this platform's home directory.
4243
4244```json [settings]
4245{
4246  "terminal": {
4247    "working_directory": {
4248      "always": {
4249        "directory": "~/zed/projects/"
4250      }
4251    }
4252  }
4253}
4254```
4255
4256### Terminal: Path Hyperlink Regexes
4257
4258- Description: Regexes used to identify path hyperlinks. The regexes can be specified in two forms - a single regex string, or an array of strings (which will be collected into a single multi-line regex string).
4259- Setting: `path_hyperlink_regexes`
4260- Default:
4261
4262```json [settings]
4263{
4264  "terminal": {
4265    "path_hyperlink_regexes": [
4266      // Python-style diagnostics
4267      "File \"(?<path>[^\"]+)\", line (?<line>[0-9]+)",
4268      // Common path syntax with optional line, column, description, trailing punctuation, or
4269      // surrounding symbols or quotes
4270      [
4271        "(?x)",
4272        "# optionally starts with 0-2 opening prefix symbols",
4273        "[({\\[<]{0,2}",
4274        "# which may be followed by an opening quote",
4275        "(?<quote>[\"'`])?",
4276        "# `path` is the shortest sequence of any non-space character",
4277        "(?<link>(?<path>[^ ]+?",
4278        "    # which may end with a line and optionally a column,",
4279        "    (?<line_column>:+[0-9]+(:[0-9]+)?|:?\\([0-9]+([,:][0-9]+)?\\))?",
4280        "))",
4281        "# which must be followed by a matching quote",
4282        "(?(<quote>)\\k<quote>)",
4283        "# and optionally a single closing symbol",
4284        "[)}\\]>]?",
4285        "# if line/column matched, may be followed by a description",
4286        "(?(<line_column>):[^ 0-9][^ ]*)?",
4287        "# which may be followed by trailing punctuation",
4288        "[.,:)}\\]>]*",
4289        "# and always includes trailing whitespace or end of line",
4290        "([ ]+|$)"
4291      ]
4292    ]
4293  }
4294}
4295```
4296
4297### Terminal: Path Hyperlink Timeout (ms)
4298
4299- Description: Maximum time to search for a path hyperlink. When set to 0, path hyperlinks are disabled.
4300- Setting: `path_hyperlink_timeout_ms`
4301- Default: `1`
4302
4303## REPL
4304
4305- Description: Repl settings.
4306- Setting: `repl`
4307- Default:
4308
4309```json [settings]
4310"repl": {
4311  // Maximum number of columns to keep in REPL's scrollback buffer.
4312  // Clamped with [20, 512] range.
4313  "max_columns": 128,
4314  // Maximum number of lines to keep in REPL's scrollback buffer.
4315  // Clamped with [4, 256] range.
4316  "max_lines": 32
4317},
4318```
4319
4320## Theme
4321
4322- Description: The theme setting can be specified in two forms - either as the name of a theme or as an object containing the `mode`, `dark`, and `light` themes for the Zed UI.
4323- Setting: `theme`
4324- Default: `One Dark`
4325
4326### Theme Object
4327
4328- Description: Specify the theme using an object that includes the `mode`, `dark`, and `light` themes.
4329- Setting: `theme`
4330- Default:
4331
4332```json [settings]
4333"theme": {
4334  "mode": "system",
4335  "dark": "One Dark",
4336  "light": "One Light"
4337},
4338```
4339
4340### Mode
4341
4342- Description: Specify theme mode.
4343- Setting: `mode`
4344- Default: `system`
4345
4346**Options**
4347
43481. Set the theme to dark mode
4349
4350```json [settings]
4351{
4352  "mode": "dark"
4353}
4354```
4355
43562. Set the theme to light mode
4357
4358```json [settings]
4359{
4360  "mode": "light"
4361}
4362```
4363
43643. Set the theme to system mode
4365
4366```json [settings]
4367{
4368  "mode": "system"
4369}
4370```
4371
4372### Dark
4373
4374- Description: The name of the dark Zed theme to use for the UI.
4375- Setting: `dark`
4376- Default: `One Dark`
4377
4378**Options**
4379
4380Run the {#action theme_selector::Toggle} action in the command palette to see a current list of valid themes names.
4381
4382### Light
4383
4384- Description: The name of the light Zed theme to use for the UI.
4385- Setting: `light`
4386- Default: `One Light`
4387
4388**Options**
4389
4390Run the {#action theme_selector::Toggle} action in the command palette to see a current list of valid themes names.
4391
4392## Title Bar
4393
4394- Description: Whether or not to show various elements in the title bar
4395- Setting: `title_bar`
4396- Default:
4397
4398```json [settings]
4399"title_bar": {
4400  "show_branch_icon": false,
4401  "show_branch_name": true,
4402  "show_project_items": true,
4403  "show_onboarding_banner": true,
4404  "show_user_picture": true,
4405  "show_user_menu": true,
4406  "show_sign_in": true,
4407  "show_menus": false
4408}
4409```
4410
4411**Options**
4412
4413- `show_branch_icon`: Whether to show the branch icon beside branch switcher in the titlebar
4414- `show_branch_name`: Whether to show the branch name button in the titlebar
4415- `show_project_items`: Whether to show the project host and name in the titlebar
4416- `show_onboarding_banner`: Whether to show onboarding banners in the titlebar
4417- `show_user_picture`: Whether to show user picture in the titlebar
4418- `show_user_menu`: Whether to show the user menu button in the titlebar (the one that displays your avatar by default and contains options like Settings, Keymap, Themes, etc.)
4419- `show_sign_in`: Whether to show the sign in button in the titlebar
4420- `show_menus`: Whether to show the menus in the titlebar
4421
4422## Vim
4423
4424- Description: Whether or not to enable vim mode.
4425- Setting: `vim_mode`
4426- Default: `false`
4427
4428## When Closing With No Tabs
4429
4430- Description: Whether the window should be closed when using 'close active item' on a window with no tabs
4431- Setting: `when_closing_with_no_tabs`
4432- Default: `"platform_default"`
4433
4434**Options**
4435
44361. Use platform default behavior:
4437
4438```json [settings]
4439{
4440  "when_closing_with_no_tabs": "platform_default"
4441}
4442```
4443
44442. Always close the window:
4445
4446```json [settings]
4447{
4448  "when_closing_with_no_tabs": "close_window"
4449}
4450```
4451
44523. Never close the window:
4453
4454```json [settings]
4455{
4456  "when_closing_with_no_tabs": "keep_window_open"
4457}
4458```
4459
4460## Project Panel
4461
4462- Description: Customize project panel
4463- Setting: `project_panel`
4464- Default:
4465
4466```json [settings]
4467{
4468  "project_panel": {
4469    "button": true,
4470    "default_width": 240,
4471    "dock": "left",
4472    "entry_spacing": "comfortable",
4473    "file_icons": true,
4474    "folder_icons": true,
4475    "git_status": true,
4476    "indent_size": 20,
4477    "auto_reveal_entries": true,
4478    "auto_fold_dirs": true,
4479    "drag_and_drop": true,
4480    "scrollbar": {
4481      "show": null
4482    },
4483    "sticky_scroll": true,
4484    "show_diagnostics": "all",
4485    "indent_guides": {
4486      "show": "always"
4487    },
4488    "sort_mode": "directories_first",
4489    "hide_root": false,
4490    "hide_hidden": false,
4491    "starts_open": true,
4492    "auto_open": {
4493      "on_create": true,
4494      "on_paste": true,
4495      "on_drop": true
4496    }
4497  }
4498}
4499```
4500
4501### Dock
4502
4503- Description: Control the position of the dock
4504- Setting: `dock`
4505- Default: `left`
4506
4507**Options**
4508
45091. Default dock position to left
4510
4511```json [settings]
4512{
4513  "dock": "left"
4514}
4515```
4516
45172. Default dock position to right
4518
4519```json [settings]
4520{
4521  "dock": "right"
4522}
4523```
4524
4525### Entry Spacing
4526
4527- Description: Spacing between worktree entries
4528- Setting: `entry_spacing`
4529- Default: `comfortable`
4530
4531**Options**
4532
45331. Comfortable entry spacing
4534
4535```json [settings]
4536{
4537  "entry_spacing": "comfortable"
4538}
4539```
4540
45412. Standard entry spacing
4542
4543```json [settings]
4544{
4545  "entry_spacing": "standard"
4546}
4547```
4548
4549### Git Status
4550
4551- Description: Indicates newly created and updated files
4552- Setting: `git_status`
4553- Default: `true`
4554
4555**Options**
4556
45571. Default enable git status
4558
4559```json [settings]
4560{
4561  "git_status": true
4562}
4563```
4564
45652. Default disable git status
4566
4567```json [settings]
4568{
4569  "git_status": false
4570}
4571```
4572
4573### Default Width
4574
4575- Description: Customize default width taken by project panel
4576- Setting: `default_width`
4577- Default: `240`
4578
4579**Options**
4580
4581`float` values
4582
4583### Auto Reveal Entries
4584
4585- Description: Whether to reveal it in the project panel automatically, when a corresponding project entry becomes active. Gitignored entries are never auto revealed.
4586- Setting: `auto_reveal_entries`
4587- Default: `true`
4588
4589**Options**
4590
45911. Enable auto reveal entries
4592
4593```json [settings]
4594{
4595  "auto_reveal_entries": true
4596}
4597```
4598
45992. Disable auto reveal entries
4600
4601```json [settings]
4602{
4603  "auto_reveal_entries": false
4604}
4605```
4606
4607### Auto Fold Dirs
4608
4609- Description: Whether to fold directories automatically when directory has only one directory inside.
4610- Setting: `auto_fold_dirs`
4611- Default: `true`
4612
4613**Options**
4614
46151. Enable auto fold dirs
4616
4617```json [settings]
4618{
4619  "auto_fold_dirs": true
4620}
4621```
4622
46232. Disable auto fold dirs
4624
4625```json [settings]
4626{
4627  "auto_fold_dirs": false
4628}
4629```
4630
4631### Indent Size
4632
4633- Description: Amount of indentation (in pixels) for nested items.
4634- Setting: `indent_size`
4635- Default: `20`
4636
4637### Indent Guides: Show
4638
4639- Description: Whether to show indent guides in the project panel.
4640- Setting: `indent_guides`
4641- Default:
4642
4643```json [settings]
4644"indent_guides": {
4645  "show": "always"
4646}
4647```
4648
4649**Options**
4650
46511. Show indent guides in the project panel
4652
4653```json [settings]
4654{
4655  "indent_guides": {
4656    "show": "always"
4657  }
4658}
4659```
4660
46612. Hide indent guides in the project panel
4662
4663```json [settings]
4664{
4665  "indent_guides": {
4666    "show": "never"
4667  }
4668}
4669```
4670
4671### Scrollbar: Show
4672
4673- Description: Whether to show a scrollbar in the project panel. Possible values: null, "auto", "system", "always", "never". Inherits editor settings when absent, see its description for more details.
4674- Setting: `scrollbar`
4675- Default:
4676
4677```json [settings]
4678"scrollbar": {
4679  "show": null
4680}
4681```
4682
4683**Options**
4684
46851. Show scrollbar in the project panel
4686
4687```json [settings]
4688{
4689  "scrollbar": {
4690    "show": "always"
4691  }
4692}
4693```
4694
46952. Hide scrollbar in the project panel
4696
4697```json [settings]
4698{
4699  "scrollbar": {
4700    "show": "never"
4701  }
4702}
4703```
4704
4705### Sort Mode
4706
4707- Description: Sort order for entries in the project panel
4708- Setting: `sort_mode`
4709- Default: `directories_first`
4710
4711**Options**
4712
47131. Show directories first, then files
4714
4715```json [settings]
4716{
4717  "sort_mode": "directories_first"
4718}
4719```
4720
47212. Mix directories and files together
4722
4723```json [settings]
4724{
4725  "sort_mode": "mixed"
4726}
4727```
4728
47293. Show files first, then directories
4730
4731```json [settings]
4732{
4733  "sort_mode": "files_first"
4734}
4735```
4736
4737### Auto Open
4738
4739- Description: Control whether files are opened automatically after different creation flows in the project panel.
4740- Setting: `auto_open`
4741- Default:
4742
4743```json [settings]
4744"auto_open": {
4745  "on_create": true,
4746  "on_paste": true,
4747  "on_drop": true
4748}
4749```
4750
4751**Options**
4752
4753- `on_create`: Whether to automatically open newly created files in the editor.
4754- `on_paste`: Whether to automatically open files after pasting or duplicating them.
4755- `on_drop`: Whether to automatically open files dropped from external sources.
4756
4757## Agent
4758
4759Visit [the Configuration page](./ai/configuration.md) under the AI section to learn more about all the agent-related settings.
4760
4761## Collaboration Panel
4762
4763- Description: Customizations for the collaboration panel.
4764- Setting: `collaboration_panel`
4765- Default:
4766
4767```json [settings]
4768{
4769  "collaboration_panel": {
4770    "button": true,
4771    "dock": "left",
4772    "default_width": 240
4773  }
4774}
4775```
4776
4777**Options**
4778
4779- `button`: Whether to show the collaboration panel button in the status bar
4780- `dock`: Where to dock the collaboration panel. Can be `left` or `right`
4781- `default_width`: Default width of the collaboration panel
4782
4783## Debugger
4784
4785- Description: Configuration for debugger panel and settings
4786- Setting: `debugger`
4787- Default:
4788
4789```json [settings]
4790{
4791  "debugger": {
4792    "stepping_granularity": "line",
4793    "save_breakpoints": true,
4794    "dock": "bottom",
4795    "button": true
4796  }
4797}
4798```
4799
4800See the [debugger page](./debugger.md) for more information about debugging support within Zed.
4801
4802## Git Panel
4803
4804- Description: Setting to customize the behavior of the git panel.
4805- Setting: `git_panel`
4806- Default:
4807
4808```json [settings]
4809{
4810  "git_panel": {
4811    "button": true,
4812    "dock": "left",
4813    "default_width": 360,
4814    "status_style": "icon",
4815    "fallback_branch_name": "main",
4816    "sort_by_path": false,
4817    "collapse_untracked_diff": false,
4818    "scrollbar": {
4819      "show": null
4820    }
4821  }
4822}
4823```
4824
4825**Options**
4826
4827- `button`: Whether to show the git panel button in the status bar
4828- `dock`: Where to dock the git panel. Can be `left` or `right`
4829- `default_width`: Default width of the git panel
4830- `status_style`: How to display git status. Can be `label_color` or `icon`
4831- `fallback_branch_name`: What branch name to use if `init.defaultBranch` is not set
4832- `sort_by_path`: Whether to sort entries in the panel by path or by status (the default)
4833- `collapse_untracked_diff`: Whether to collapse untracked files in the diff panel
4834- `scrollbar`: When to show the scrollbar in the git panel
4835
4836## Git Hosting Providers
4837
4838- Description: Register self-hosted GitHub, GitLab, or Bitbucket instances so commit hashes, issue references, and permalinks resolve to the right host.
4839- Setting: `git_hosting_providers`
4840- Default: `[]`
4841
4842**Options**
4843
4844Each entry accepts:
4845
4846- `provider`: One of `github`, `gitlab`, or `bitbucket`
4847- `name`: Display name for the instance
4848- `base_url`: Base URL, e.g. `https://git.example.corp`
4849
4850You can define these in user or project settings; project settings are merged on top of user settings.
4851
4852```json [settings]
4853{
4854  "git_hosting_providers": [
4855    {
4856      "provider": "github",
4857      "name": "BigCorp GitHub",
4858      "base_url": "https://git.example.corp"
4859    }
4860  ]
4861}
4862```
4863
4864## Outline Panel
4865
4866- Description: Customize outline Panel
4867- Setting: `outline_panel`
4868- Default:
4869
4870```json [settings]
4871"outline_panel": {
4872  "button": true,
4873  "default_width": 300,
4874  "dock": "left",
4875  "file_icons": true,
4876  "folder_icons": true,
4877  "git_status": true,
4878  "indent_size": 20,
4879  "auto_reveal_entries": true,
4880  "auto_fold_dirs": true,
4881  "indent_guides": {
4882    "show": "always"
4883  },
4884  "scrollbar": {
4885    "show": null
4886  }
4887}
4888```
4889
4890## Calls
4891
4892- Description: Customize behavior when participating in a call
4893- Setting: `calls`
4894- Default:
4895
4896```json [settings]
4897"calls": {
4898  // Join calls with the microphone live by default
4899  "mute_on_join": false,
4900  // Share your project when you are the first to join a channel
4901  "share_on_join": false
4902},
4903```
4904
4905## Colorize Brackets
4906
4907- Description: Whether to use tree-sitter bracket queries to detect and colorize the brackets in the editor (also known as "rainbow brackets").
4908- Setting: `colorize_brackets`
4909- Default: `false`
4910
4911**Options**
4912
4913`boolean` values
4914
4915The colors that are used for different indentation levels are defined in the theme (theme key: `accents`). They can be customized by using theme overrides.
4916
4917## Unnecessary Code Fade
4918
4919- Description: How much to fade out unused code.
4920- Setting: `unnecessary_code_fade`
4921- Default: `0.3`
4922
4923**Options**
4924
4925Float values between `0.0` and `0.9`, where:
4926
4927- `0.0` means no fading (unused code looks the same as used code)
4928- `0.9` means maximum fading (unused code is very faint but still visible)
4929
4930**Example**
4931
4932```json [settings]
4933{
4934  "unnecessary_code_fade": 0.5
4935}
4936```
4937
4938## UI Font Family
4939
4940- Description: The name of the font to use for text in the UI.
4941- Setting: `ui_font_family`
4942- Default: `.ZedSans`. This currently aliases to [IBM Plex](https://www.ibm.com/plex/).
4943
4944**Options**
4945
4946The name of any font family installed on the system, `".ZedSans"` to use the Zed-provided default, or `".SystemUIFont"` to use the system's default UI font (on macOS and Windows).
4947
4948## UI Font Features
4949
4950- Description: The OpenType features to enable for text in the UI.
4951- Setting: `ui_font_features`
4952- Default:
4953
4954```json [settings]
4955"ui_font_features": {
4956  "calt": false
4957}
4958```
4959
4960- Platform: macOS and Windows.
4961
4962**Options**
4963
4964Zed supports all OpenType features that can be enabled or disabled for a given UI font, as well as setting values for font features.
4965
4966For example, to disable font ligatures, add the following to your settings:
4967
4968```json [settings]
4969{
4970  "ui_font_features": {
4971    "calt": false
4972  }
4973}
4974```
4975
4976You can also set other OpenType features, like setting `cv01` to `7`:
4977
4978```json [settings]
4979{
4980  "ui_font_features": {
4981    "cv01": 7
4982  }
4983}
4984```
4985
4986## UI Font Fallbacks
4987
4988- Description: The font fallbacks to use for text in the UI.
4989- Setting: `ui_font_fallbacks`
4990- Default: `null`
4991- Platform: macOS and Windows.
4992
4993**Options**
4994
4995For example, to use `Nerd Font` as a fallback, add the following to your settings:
4996
4997```json [settings]
4998{
4999  "ui_font_fallbacks": ["Nerd Font"]
5000}
5001```
5002
5003## UI Font Size
5004
5005- Description: The default font size for text in the UI.
5006- Setting: `ui_font_size`
5007- Default: `16`
5008
5009**Options**
5010
5011`integer` values from `6` to `100` pixels (inclusive)
5012
5013## UI Font Weight
5014
5015- Description: The default font weight for text in the UI.
5016- Setting: `ui_font_weight`
5017- Default: `400`
5018
5019**Options**
5020
5021`integer` values between `100` and `900`
5022
5023## Settings Profiles
5024
5025- Description: Configure any number of settings profiles that are temporarily applied on top of your existing user settings when selected from `settings profile selector: toggle`.
5026- Setting: `profiles`
5027- Default: `{}`
5028
5029In your `settings.json` file, add the `profiles` object.
5030Each key within this object is the name of a settings profile, and each value is an object that can include any of Zed's settings.
5031
5032Example:
5033
5034```json [settings]
5035"profiles": {
5036  "Presenting (Dark)": {
5037    "agent_buffer_font_size": 18.0,
5038    "buffer_font_size": 18.0,
5039    "theme": "One Dark",
5040    "ui_font_size": 18.0
5041  },
5042  "Presenting (Light)": {
5043    "agent_buffer_font_size": 18.0,
5044    "buffer_font_size": 18.0,
5045    "theme": "One Light",
5046    "ui_font_size": 18.0
5047  },
5048  "Writing": {
5049    "agent_buffer_font_size": 15.0,
5050    "buffer_font_size": 15.0,
5051    "theme": "Catppuccin Frappé - No Italics",
5052    "ui_font_size": 15.0,
5053    "tab_bar": { "show": false },
5054    "toolbar": { "breadcrumbs": false }
5055  }
5056}
5057```
5058
5059To preview and enable a settings profile, open the command palette via {#kb command_palette::Toggle} and search for `settings profile selector: toggle`.
5060
5061## An example configuration:
5062
5063```json [settings]
5064// ~/.config/zed/settings.json
5065{
5066  "theme": "cave-light",
5067  "tab_size": 2,
5068  "preferred_line_length": 80,
5069  "soft_wrap": "none",
5070
5071  "buffer_font_size": 18,
5072  "buffer_font_family": ".ZedMono",
5073
5074  "autosave": "on_focus_change",
5075  "format_on_save": "off",
5076  "vim_mode": false,
5077  "projects_online_by_default": true,
5078  "terminal": {
5079    "font_family": "FiraCode Nerd Font Mono",
5080    "blinking": "off"
5081  },
5082  "languages": {
5083    "C": {
5084      "format_on_save": "on",
5085      "formatter": "language_server",
5086      "preferred_line_length": 64,
5087      "soft_wrap": "preferred_line_length"
5088    }
5089  }
5090}
5091```