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 files
   8
   9<!--
  10TBD: Settings files. Rewrite with "remote settings" in mind (e.g. `local settings` on the remote host).
  11Consider renaming `zed: Open Local Settings` to `zed: Open Project Settings`.
  12
  13TBD: 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.
  14-->
  15
  16Your settings file can be opened with {#kb zed::OpenSettings}. By 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.
  17
  18This configuration is merged with any local configuration inside your projects. You can open the project settings by running {#action zed::OpenProjectSettings} from the command palette. This will create a `.zed` directory containing`.zed/settings.json`.
  19
  20Although most projects will only need one settings file at the root, you can add more local settings files for subdirectories as needed. Not all settings can be set in local files, just those that impact the behavior of the editor and language tooling. For example you can set `tab_size`, `formatter` etc. but not `theme`, `vim_mode` and similar.
  21
  22The syntax for configuration files is a super-set of JSON that allows `//` comments.
  23
  24## Default settings
  25
  26You can find the default settings for your current Zed by running {#action zed::OpenDefaultSettings} from the command palette.
  27
  28Extensions that provide language servers may also provide default settings for those language servers.
  29
  30# Settings
  31
  32## Active Pane Modifiers
  33
  34- Description: Styling settings applied to the active pane.
  35- Setting: `active_pane_modifiers`
  36- Default:
  37
  38```json
  39{
  40  "active_pane_modifiers": {
  41    "border_size": 0.0,
  42    "inactive_opacity": 1.0
  43  }
  44}
  45```
  46
  47### Border size
  48
  49- 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.
  50- Setting: `border_size`
  51- Default: `0.0`
  52
  53**Options**
  54
  55Non-negative `float` values
  56
  57### Inactive Opacity
  58
  59- 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.
  60- Setting: `inactive_opacity`
  61- Default: `1.0`
  62
  63**Options**
  64
  65`float` values
  66
  67## Bottom Dock Layout
  68
  69- Description: Control the layout of the bottom dock, relative to the left and right docks
  70- Setting: `bottom_dock_layout`
  71- Default: `"contained"`
  72
  73**Options**
  74
  751. Contain the bottom dock, giving the full height of the window to the left and right docks
  76
  77```json
  78{
  79  "bottom_dock_layout": "contained"
  80}
  81```
  82
  832. Give the bottom dock the full width of the window, truncating the left and right docks
  84
  85```json
  86{
  87  "bottom_dock_layout": "full"
  88}
  89```
  90
  913. Left align the bottom dock, truncating the left dock and giving the right dock the full height of the window
  92
  93```json
  94{
  95  "bottom_dock_layout": "left_aligned"
  96}
  97```
  98
  993. Right align the bottom dock, giving the left dock the full height of the window and truncating the right dock.
 100
 101```json
 102{
 103  "bottom_dock_layout": "right_aligned"
 104}
 105```
 106
 107## Auto Install extensions
 108
 109- Description: Define extensions to be autoinstalled or never be installed.
 110- Setting: `auto_install_extension`
 111- Default: `{ "html": true }`
 112
 113**Options**
 114
 115You can find the names of your currently installed extensions by listing the subfolders under the [extension installation location](./extensions/installing-extensions.md#installation-location):
 116
 117On MacOS:
 118
 119```sh
 120ls ~/Library/Application\ Support/Zed/extensions/installed/
 121```
 122
 123On Linux:
 124
 125```sh
 126ls ~/.local/share/zed/extensions/installed
 127```
 128
 129Define extensions which should be installed (`true`) or never installed (`false`).
 130
 131```json
 132{
 133  "auto_install_extensions": {
 134    "html": true,
 135    "dockerfile": true,
 136    "docker-compose": false
 137  }
 138}
 139```
 140
 141## Autosave
 142
 143- Description: When to automatically save edited buffers.
 144- Setting: `autosave`
 145- Default: `off`
 146
 147**Options**
 148
 1491. To disable autosave, set it to `off`:
 150
 151```json
 152{
 153  "autosave": "off"
 154}
 155```
 156
 1572. To autosave when focus changes, use `on_focus_change`:
 158
 159```json
 160{
 161  "autosave": "on_focus_change"
 162}
 163```
 164
 1653. To autosave when the active window changes, use `on_window_change`:
 166
 167```json
 168{
 169  "autosave": "on_window_change"
 170}
 171```
 172
 1734. To autosave after an inactivity period, use `after_delay`:
 174
 175```json
 176{
 177  "autosave": {
 178    "after_delay": {
 179      "milliseconds": 1000
 180    }
 181  }
 182}
 183```
 184
 185## Restore on Startup
 186
 187- Description: Controls session restoration on startup.
 188- Setting: `restore_on_startup`
 189- Default: `last_session`
 190
 191**Options**
 192
 1931. Restore all workspaces that were open when quitting Zed:
 194
 195```json
 196{
 197  "restore_on_startup": "last_session"
 198}
 199```
 200
 2012. Restore the workspace that was closed last:
 202
 203```json
 204{
 205  "restore_on_startup": "last_workspace"
 206}
 207```
 208
 2093. Always start with an empty editor:
 210
 211```json
 212{
 213  "restore_on_startup": "none"
 214}
 215```
 216
 217## Autoscroll on Clicks
 218
 219- Description: Whether to scroll when clicking near the edge of the visible text area.
 220- Setting: `autoscroll_on_clicks`
 221- Default: `false`
 222
 223**Options**
 224
 225`boolean` values
 226
 227## Auto Update
 228
 229- Description: Whether or not to automatically check for updates.
 230- Setting: `auto_update`
 231- Default: `true`
 232
 233**Options**
 234
 235`boolean` values
 236
 237## Base Keymap
 238
 239- Description: Base key bindings scheme. Base keymaps can be overridden with user keymaps.
 240- Setting: `base_keymap`
 241- Default: `VSCode`
 242
 243**Options**
 244
 2451. VSCode
 246
 247```json
 248{
 249  "base_keymap": "VSCode"
 250}
 251```
 252
 2532. Atom
 254
 255```json
 256{
 257  "base_keymap": "Atom"
 258}
 259```
 260
 2613. JetBrains
 262
 263```json
 264{
 265  "base_keymap": "JetBrains"
 266}
 267```
 268
 2694. None
 270
 271```json
 272{
 273  "base_keymap": "None"
 274}
 275```
 276
 2775. SublimeText
 278
 279```json
 280{
 281  "base_keymap": "SublimeText"
 282}
 283```
 284
 2856. TextMate
 286
 287```json
 288{
 289  "base_keymap": "TextMate"
 290}
 291```
 292
 293## Buffer Font Family
 294
 295- Description: The name of a font to use for rendering text in the editor.
 296- Setting: `buffer_font_family`
 297- Default: `Zed Plex Mono`
 298
 299**Options**
 300
 301The name of any font family installed on the user's system
 302
 303## Buffer Font Features
 304
 305- Description: The OpenType features to enable for text in the editor.
 306- Setting: `buffer_font_features`
 307- Default: `null`
 308- Platform: macOS and Windows.
 309
 310**Options**
 311
 312Zed 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.
 313
 314For example, to disable font ligatures, add the following to your settings:
 315
 316```json
 317{
 318  "buffer_font_features": {
 319    "calt": false
 320  }
 321}
 322```
 323
 324You can also set other OpenType features, like setting `cv01` to `7`:
 325
 326```json
 327{
 328  "buffer_font_features": {
 329    "cv01": 7
 330  }
 331}
 332```
 333
 334## Buffer Font Fallbacks
 335
 336- Description: Set the buffer text's font fallbacks, this will be merged with the platform's default fallbacks.
 337- Setting: `buffer_font_fallbacks`
 338- Default: `null`
 339- Platform: macOS and Windows.
 340
 341**Options**
 342
 343For example, to use `Nerd Font` as a fallback, add the following to your settings:
 344
 345```json
 346{
 347  "buffer_font_fallbacks": ["Nerd Font"]
 348}
 349```
 350
 351## Buffer Font Size
 352
 353- Description: The default font size for text in the editor.
 354- Setting: `buffer_font_size`
 355- Default: `15`
 356
 357**Options**
 358
 359`integer` values from `6` to `100` pixels (inclusive)
 360
 361## Buffer Font Weight
 362
 363- Description: The default font weight for text in the editor.
 364- Setting: `buffer_font_weight`
 365- Default: `400`
 366
 367**Options**
 368
 369`integer` values between `100` and `900`
 370
 371## Buffer Line Height
 372
 373- Description: The default line height for text in the editor.
 374- Setting: `buffer_line_height`
 375- Default: `"comfortable"`
 376
 377**Options**
 378
 379`"standard"`, `"comfortable"` or `{ "custom": float }` (`1` is compact, `2` is loose)
 380
 381## Close on File Delete
 382
 383- Description: Whether to automatically close editor tabs when their corresponding files are deleted from disk.
 384- Setting: `close_on_file_delete`
 385- Default: `false`
 386
 387**Options**
 388
 389`boolean` values
 390
 391When 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.
 392
 393Note: Dirty files (files with unsaved changes) will not be automatically closed even when this setting is enabled, ensuring you don't lose unsaved work.
 394
 395## Confirm Quit
 396
 397- Description: Whether or not to prompt the user to confirm before closing the application.
 398- Setting: `confirm_quit`
 399- Default: `false`
 400
 401**Options**
 402
 403`boolean` values
 404
 405## Centered Layout
 406
 407- Description: Configuration for the centered layout mode.
 408- Setting: `centered_layout`
 409- Default:
 410
 411```json
 412"centered_layout": {
 413  "left_padding": 0.2,
 414  "right_padding": 0.2,
 415}
 416```
 417
 418**Options**
 419
 420The `left_padding` and `right_padding` options define the relative width of the
 421left 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`.
 422
 423## Direnv Integration
 424
 425- Description: Settings for [direnv](https://direnv.net/) integration. Requires `direnv` to be installed.
 426  `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.
 427  It also allows for those environment variables to be used in tasks.
 428- Setting: `load_direnv`
 429- Default: `"direct"`
 430
 431**Options**
 432
 433There are two options to choose from:
 434
 4351. `shell_hook`: Use the shell hook to load direnv. This relies on direnv to activate upon entering the directory. Supports POSIX shells and fish.
 4362. `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.
 437
 438## Edit Predictions
 439
 440- Description: Settings for edit predictions.
 441- Setting: `edit_predictions`
 442- Default:
 443
 444```json
 445  "edit_predictions": {
 446    "disabled_globs": [
 447      "**/.env*",
 448      "**/*.pem",
 449      "**/*.key",
 450      "**/*.cert",
 451      "**/*.crt",
 452      "**/.dev.vars",
 453      "**/secrets.yml"
 454    ]
 455  }
 456```
 457
 458**Options**
 459
 460### Disabled Globs
 461
 462- 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.
 463- Setting: `disabled_globs`
 464- Default: `["**/.env*", "**/*.pem", "**/*.key", "**/*.cert", "**/*.crt", "**/.dev.vars", "**/secrets.yml"]`
 465
 466**Options**
 467
 468List of `string` values.
 469
 470## Edit Predictions Disabled in
 471
 472- Description: A list of language scopes in which edit predictions should be disabled.
 473- Setting: `edit_predictions_disabled_in`
 474- Default: `[]`
 475
 476**Options**
 477
 478List of `string` values
 479
 4801. Don't show edit predictions in comments:
 481
 482```json
 483"disabled_in": ["comment"]
 484```
 485
 4862. Don't show edit predictions in strings and comments:
 487
 488```json
 489"disabled_in": ["comment", "string"]
 490```
 491
 4923. Only in Go, don't show edit predictions in strings and comments:
 493
 494```json
 495{
 496  "languages": {
 497    "Go": {
 498      "edit_predictions_disabled_in": ["comment", "string"]
 499    }
 500  }
 501}
 502```
 503
 504## Current Line Highlight
 505
 506- Description: How to highlight the current line in the editor.
 507- Setting: `current_line_highlight`
 508- Default: `all`
 509
 510**Options**
 511
 5121. Don't highlight the current line:
 513
 514```json
 515"current_line_highlight": "none"
 516```
 517
 5182. Highlight the gutter area:
 519
 520```json
 521"current_line_highlight": "gutter"
 522```
 523
 5243. Highlight the editor area:
 525
 526```json
 527"current_line_highlight": "line"
 528```
 529
 5304. Highlight the full line:
 531
 532```json
 533"current_line_highlight": "all"
 534```
 535
 536## Selection Highlight
 537
 538- Description: Whether to highlight all occurrences of the selected text in an editor.
 539- Setting: `selection_highlight`
 540- Default: `true`
 541
 542## LSP Highlight Debounce
 543
 544- Description: The debounce delay before querying highlights from the language server based on the current cursor location.
 545- Setting: `lsp_highlight_debounce`
 546- Default: `75`
 547
 548## Cursor Blink
 549
 550- Description: Whether or not the cursor blinks.
 551- Setting: `cursor_blink`
 552- Default: `true`
 553
 554**Options**
 555
 556`boolean` values
 557
 558## Cursor Shape
 559
 560- Description: Cursor shape for the default editor.
 561- Setting: `cursor_shape`
 562- Default: `bar`
 563
 564**Options**
 565
 5661. A vertical bar:
 567
 568```json
 569"cursor_shape": "bar"
 570```
 571
 5722. A block that surrounds the following character:
 573
 574```json
 575"cursor_shape": "block"
 576```
 577
 5783. An underline / underscore that runs along the following character:
 579
 580```json
 581"cursor_shape": "underline"
 582```
 583
 5844. An box drawn around the following character:
 585
 586```json
 587"cursor_shape": "hollow"
 588```
 589
 590## Hide Mouse
 591
 592- Description: Determines when the mouse cursor should be hidden in an editor or input box.
 593- Setting: `hide_mouse`
 594- Default: `on_typing_and_movement`
 595
 596**Options**
 597
 5981. Never hide the mouse cursor:
 599
 600```json
 601"hide_mouse": "never"
 602```
 603
 6042. Hide only when typing:
 605
 606```json
 607"hide_mouse": "on_typing"
 608```
 609
 6103. Hide on both typing and cursor movement:
 611
 612```json
 613"hide_mouse": "on_typing_and_movement"
 614```
 615
 616## Snippet Sort Order
 617
 618- Description: Determines how snippets are sorted relative to other completion items.
 619- Setting: `snippet_sort_order`
 620- Default: `inline`
 621
 622**Options**
 623
 6241. Place snippets at the top of the completion list:
 625
 626```json
 627"snippet_sort_order": "top"
 628```
 629
 6302. Place snippets normally without any preference:
 631
 632```json
 633"snippet_sort_order": "inline"
 634```
 635
 6363. Place snippets at the bottom of the completion list:
 637
 638```json
 639"snippet_sort_order": "bottom"
 640```
 641
 642## Editor Scrollbar
 643
 644- Description: Whether or not to show the editor scrollbar and various elements in it.
 645- Setting: `scrollbar`
 646- Default:
 647
 648```json
 649"scrollbar": {
 650  "show": "auto",
 651  "cursors": true,
 652  "git_diff": true,
 653  "search_results": true,
 654  "selected_text": true,
 655  "selected_symbol": true,
 656  "diagnostics": "all",
 657  "axes": {
 658    "horizontal": true,
 659    "vertical": true,
 660  },
 661},
 662```
 663
 664### Show Mode
 665
 666- Description: When to show the editor scrollbar.
 667- Setting: `show`
 668- Default: `auto`
 669
 670**Options**
 671
 6721. Show the scrollbar if there's important information or follow the system's configured behavior:
 673
 674```json
 675"scrollbar": {
 676  "show": "auto"
 677}
 678```
 679
 6802. Match the system's configured behavior:
 681
 682```json
 683"scrollbar": {
 684  "show": "system"
 685}
 686```
 687
 6883. Always show the scrollbar:
 689
 690```json
 691"scrollbar": {
 692  "show": "always"
 693}
 694```
 695
 6964. Never show the scrollbar:
 697
 698```json
 699"scrollbar": {
 700  "show": "never"
 701}
 702```
 703
 704### Cursor Indicators
 705
 706- Description: Whether to show cursor positions in the scrollbar.
 707- Setting: `cursors`
 708- Default: `true`
 709
 710**Options**
 711
 712`boolean` values
 713
 714### Git Diff Indicators
 715
 716- Description: Whether to show git diff indicators in the scrollbar.
 717- Setting: `git_diff`
 718- Default: `true`
 719
 720**Options**
 721
 722`boolean` values
 723
 724### Search Results Indicators
 725
 726- Description: Whether to show buffer search results in the scrollbar.
 727- Setting: `search_results`
 728- Default: `true`
 729
 730**Options**
 731
 732`boolean` values
 733
 734### Selected Text Indicators
 735
 736- Description: Whether to show selected text occurrences in the scrollbar.
 737- Setting: `selected_text`
 738- Default: `true`
 739
 740**Options**
 741
 742`boolean` values
 743
 744### Selected Symbols Indicators
 745
 746- Description: Whether to show selected symbol occurrences in the scrollbar.
 747- Setting: `selected_symbol`
 748- Default: `true`
 749
 750**Options**
 751
 752`boolean` values
 753
 754### Diagnostics
 755
 756- Description: Which diagnostic indicators to show in the scrollbar.
 757- Setting: `diagnostics`
 758- Default: `all`
 759
 760**Options**
 761
 7621. Show all diagnostics:
 763
 764```json
 765{
 766  "diagnostics": "all"
 767}
 768```
 769
 7702. Do not show any diagnostics:
 771
 772```json
 773{
 774  "diagnostics": "none"
 775}
 776```
 777
 7783. Show only errors:
 779
 780```json
 781{
 782  "diagnostics": "error"
 783}
 784```
 785
 7864. Show only errors and warnings:
 787
 788```json
 789{
 790  "diagnostics": "warning"
 791}
 792```
 793
 7945. Show only errors, warnings, and information:
 795
 796```json
 797{
 798  "diagnostics": "information"
 799}
 800```
 801
 802### Axes
 803
 804- Description: Forcefully enable or disable the scrollbar for each axis
 805- Setting: `axes`
 806- Default:
 807
 808```json
 809"scrollbar": {
 810  "axes": {
 811    "horizontal": true,
 812    "vertical": true,
 813  },
 814}
 815```
 816
 817#### Horizontal
 818
 819- Description: When false, forcefully disables the horizontal scrollbar. Otherwise, obey other settings.
 820- Setting: `horizontal`
 821- Default: `true`
 822
 823**Options**
 824
 825`boolean` values
 826
 827#### Vertical
 828
 829- Description: When false, forcefully disables the vertical scrollbar. Otherwise, obey other settings.
 830- Setting: `vertical`
 831- Default: `true`
 832
 833**Options**
 834
 835`boolean` values
 836
 837## Minimap
 838
 839- Description: Settings related to the editor's minimap, which provides an overview of your document.
 840- Setting: `minimap`
 841- Default:
 842
 843```json
 844{
 845  "minimap": {
 846    "show": "never",
 847    "thumb": "always",
 848    "thumb_border": "left_open",
 849    "current_line_highlight": null
 850  }
 851}
 852```
 853
 854### Show Mode
 855
 856- Description: When to show the minimap in the editor.
 857- Setting: `show`
 858- Default: `never`
 859
 860**Options**
 861
 8621. Always show the minimap:
 863
 864```json
 865{
 866  "show": "always"
 867}
 868```
 869
 8702. Show the minimap if the editor's scrollbars are visible:
 871
 872```json
 873{
 874  "show": "auto"
 875}
 876```
 877
 8783. Never show the minimap:
 879
 880```json
 881{
 882  "show": "never"
 883}
 884```
 885
 886### Thumb Display
 887
 888- Description: When to show the minimap thumb (the visible editor area) in the minimap.
 889- Setting: `thumb`
 890- Default: `always`
 891
 892**Options**
 893
 8941. Show the minimap thumb when hovering over the minimap:
 895
 896```json
 897{
 898  "thumb": "hover"
 899}
 900```
 901
 9022. Always show the minimap thumb:
 903
 904```json
 905{
 906  "thumb": "always"
 907}
 908```
 909
 910### Thumb Border
 911
 912- Description: How the minimap thumb border should look.
 913- Setting: `thumb_border`
 914- Default: `left_open`
 915
 916**Options**
 917
 9181. Display a border on all sides of the thumb:
 919
 920```json
 921{
 922  "thumb_border": "full"
 923}
 924```
 925
 9262. Display a border on all sides except the left side:
 927
 928```json
 929{
 930  "thumb_border": "left_open"
 931}
 932```
 933
 9343. Display a border on all sides except the right side:
 935
 936```json
 937{
 938  "thumb_border": "right_open"
 939}
 940```
 941
 9424. Display a border only on the left side:
 943
 944```json
 945{
 946  "thumb_border": "left_only"
 947}
 948```
 949
 9505. Display the thumb without any border:
 951
 952```json
 953{
 954  "thumb_border": "none"
 955}
 956```
 957
 958### Current Line Highlight
 959
 960- Description: How to highlight the current line in the minimap.
 961- Setting: `current_line_highlight`
 962- Default: `null`
 963
 964**Options**
 965
 9661. Inherit the editor's current line highlight setting:
 967
 968```json
 969{
 970  "minimap": {
 971    "current_line_highlight": null
 972  }
 973}
 974```
 975
 9762. Highlight the current line in the minimap:
 977
 978```json
 979{
 980  "minimap": {
 981    "current_line_highlight": "line"
 982  }
 983}
 984```
 985
 986or
 987
 988```json
 989{
 990  "minimap": {
 991    "current_line_highlight": "all"
 992  }
 993}
 994```
 995
 9963. Do not highlight the current line in the minimap:
 997
 998```json
 999{
1000  "minimap": {
1001    "current_line_highlight": "gutter"
1002  }
1003}
1004```
1005
1006or
1007
1008```json
1009{
1010  "minimap": {
1011    "current_line_highlight": "none"
1012  }
1013}
1014```
1015
1016## Editor Tab Bar
1017
1018- Description: Settings related to the editor's tab bar.
1019- Settings: `tab_bar`
1020- Default:
1021
1022```json
1023"tab_bar": {
1024  "show": true,
1025  "show_nav_history_buttons": true,
1026  "show_tab_bar_buttons": true
1027}
1028```
1029
1030### Show
1031
1032- Description: Whether or not to show the tab bar in the editor.
1033- Setting: `show`
1034- Default: `true`
1035
1036**Options**
1037
1038`boolean` values
1039
1040### Navigation History Buttons
1041
1042- Description: Whether or not to show the navigation history buttons.
1043- Setting: `show_nav_history_buttons`
1044- Default: `true`
1045
1046**Options**
1047
1048`boolean` values
1049
1050### Tab Bar Buttons
1051
1052- Description: Whether or not to show the tab bar buttons.
1053- Setting: `show_tab_bar_buttons`
1054- Default: `true`
1055
1056**Options**
1057
1058`boolean` values
1059
1060## Editor Tabs
1061
1062- Description: Configuration for the editor tabs.
1063- Setting: `tabs`
1064- Default:
1065
1066```json
1067"tabs": {
1068  "close_position": "right",
1069  "file_icons": false,
1070  "git_status": false,
1071  "activate_on_close": "history",
1072  "show_close_button": "hover",
1073  "show_diagnostics": "off"
1074},
1075```
1076
1077### Close Position
1078
1079- Description: Where to display close button within a tab.
1080- Setting: `close_position`
1081- Default: `right`
1082
1083**Options**
1084
10851. Display the close button on the right:
1086
1087```json
1088{
1089  "close_position": "right"
1090}
1091```
1092
10932. Display the close button on the left:
1094
1095```json
1096{
1097  "close_position": "left"
1098}
1099```
1100
1101### File Icons
1102
1103- Description: Whether to show the file icon for a tab.
1104- Setting: `file_icons`
1105- Default: `false`
1106
1107### Git Status
1108
1109- Description: Whether or not to show Git file status in tab.
1110- Setting: `git_status`
1111- Default: `false`
1112
1113### Activate on close
1114
1115- Description: What to do after closing the current tab.
1116- Setting: `activate_on_close`
1117- Default: `history`
1118
1119**Options**
1120
11211.  Activate the tab that was open previously:
1122
1123```json
1124{
1125  "activate_on_close": "history"
1126}
1127```
1128
11292. Activate the right neighbour tab if present:
1130
1131```json
1132{
1133  "activate_on_close": "neighbour"
1134}
1135```
1136
11373. Activate the left neighbour tab if present:
1138
1139```json
1140{
1141  "activate_on_close": "left_neighbour"
1142}
1143```
1144
1145### Show close button
1146
1147- Description: Controls the appearance behavior of the tab's close button.
1148- Setting: `show_close_button`
1149- Default: `hover`
1150
1151**Options**
1152
11531.  Show it just upon hovering the tab:
1154
1155```json
1156{
1157  "show_close_button": "hover"
1158}
1159```
1160
11612. Show it persistently:
1162
1163```json
1164{
1165  "show_close_button": "always"
1166}
1167```
1168
11693. Never show it, even if hovering it:
1170
1171```json
1172{
1173  "show_close_button": "hidden"
1174}
1175```
1176
1177### Show Diagnostics
1178
1179- 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.
1180- Setting: `show_diagnostics`
1181- Default: `off`
1182
1183**Options**
1184
11851. Do not mark any files:
1186
1187```json
1188{
1189  "show_diagnostics": "off"
1190}
1191```
1192
11932. Only mark files with errors:
1194
1195```json
1196{
1197  "show_diagnostics": "errors"
1198}
1199```
1200
12013. Mark files with errors and warnings:
1202
1203```json
1204{
1205  "show_diagnostics": "all"
1206}
1207```
1208
1209### Show Inline Code Actions
1210
1211- Description: Whether to show code action button at start of buffer line.
1212- Setting: `inline_code_actions`
1213- Default: `true`
1214
1215**Options**
1216
1217`boolean` values
1218
1219## Editor Toolbar
1220
1221- Description: Whether or not to show various elements in the editor toolbar.
1222- Setting: `toolbar`
1223- Default:
1224
1225```json
1226"toolbar": {
1227  "breadcrumbs": true,
1228  "quick_actions": true,
1229  "selections_menu": true,
1230  "agent_review": true,
1231  "code_actions": false
1232},
1233```
1234
1235**Options**
1236
1237Each option controls displaying of a particular toolbar element. If all elements are hidden, the editor toolbar is not displayed.
1238
1239## Enable Language Server
1240
1241- Description: Whether or not to use language servers to provide code intelligence.
1242- Setting: `enable_language_server`
1243- Default: `true`
1244
1245**Options**
1246
1247`boolean` values
1248
1249## Ensure Final Newline On Save
1250
1251- Description: Removes any lines containing only whitespace at the end of the file and ensures just one newline at the end.
1252- Setting: `ensure_final_newline_on_save`
1253- Default: `true`
1254
1255**Options**
1256
1257`boolean` values
1258
1259## LSP
1260
1261- Description: Configuration for language servers.
1262- Setting: `lsp`
1263- Default: `null`
1264
1265**Options**
1266
1267The following settings can be overridden for specific language servers:
1268
1269- `initialization_options`
1270- `settings`
1271
1272To override configuration for a language server, add an entry for that language server's name to the `lsp` value.
1273
1274Some 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.
1275
1276For example to pass the `check` option to `rust-analyzer`, use the following configuration:
1277
1278```json
1279"lsp": {
1280  "rust-analyzer": {
1281    "initialization_options": {
1282      "check": {
1283        "command": "clippy" // rust-analyzer.check.command (default: "check")
1284      }
1285    }
1286  }
1287}
1288```
1289
1290While other options may be changed at a runtime and should be placed under `settings`:
1291
1292```json
1293"lsp": {
1294  "yaml-language-server": {
1295    "settings": {
1296      "yaml": {
1297        "keyOrdering": true // Enforces alphabetical ordering of keys in maps
1298      }
1299    }
1300  }
1301}
1302```
1303
1304## LSP Highlight Debounce
1305
1306- Description: The debounce delay in milliseconds before querying highlights from the language server based on the current cursor location.
1307- Setting: `lsp_highlight_debounce`
1308- Default: `75`
1309
1310**Options**
1311
1312`integer` values representing milliseconds
1313
1314## Format On Save
1315
1316- Description: Whether or not to perform a buffer format before saving.
1317- Setting: `format_on_save`
1318- Default: `on`
1319
1320**Options**
1321
13221. `on`, enables format on save obeying `formatter` setting:
1323
1324```json
1325{
1326  "format_on_save": "on"
1327}
1328```
1329
13302. `off`, disables format on save:
1331
1332```json
1333{
1334  "format_on_save": "off"
1335}
1336```
1337
1338## Formatter
1339
1340- Description: How to perform a buffer format.
1341- Setting: `formatter`
1342- Default: `auto`
1343
1344**Options**
1345
13461. To use the current language server, use `"language_server"`:
1347
1348```json
1349{
1350  "formatter": "language_server"
1351}
1352```
1353
13542. 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):
1355
1356```json
1357{
1358  "formatter": {
1359    "external": {
1360      "command": "sed",
1361      "arguments": ["-e", "s/ *$//"]
1362    }
1363  }
1364}
1365```
1366
13673. 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.
1368
1369WARNING: `{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.
1370
1371```json
1372  "formatter": {
1373    "external": {
1374      "command": "prettier",
1375      "arguments": ["--stdin-filepath", "{buffer_path}"]
1376    }
1377  }
1378```
1379
13804. Or to use code actions provided by the connected language servers, use `"code_actions"`:
1381
1382```json
1383{
1384  "formatter": {
1385    "code_actions": {
1386      // Use ESLint's --fix:
1387      "source.fixAll.eslint": true,
1388      // Organize imports on save:
1389      "source.organizeImports": true
1390    }
1391  }
1392}
1393```
1394
13955. Or to use multiple formatters consecutively, use an array of formatters:
1396
1397```json
1398{
1399  "formatter": [
1400    { "language_server": { "name": "rust-analyzer" } },
1401    {
1402      "external": {
1403        "command": "sed",
1404        "arguments": ["-e", "s/ *$//"]
1405      }
1406    }
1407  ]
1408}
1409```
1410
1411Here `rust-analyzer` will be used first to format the code, followed by a call of sed.
1412If any of the formatters fails, the subsequent ones will still be executed.
1413
1414## Code Actions On Format
1415
1416- Description: The code actions to perform with the primary language server when formatting the buffer.
1417- Setting: `code_actions_on_format`
1418- Default: `{}`, except for Go it's `{ "source.organizeImports": true }`
1419
1420**Examples**
1421
1422<!--
1423TBD: Add Python Ruff source.organizeImports example
1424-->
1425
14261. Organize imports on format in TypeScript and TSX buffers:
1427
1428```json
1429{
1430  "languages": {
1431    "TypeScript": {
1432      "code_actions_on_format": {
1433        "source.organizeImports": true
1434      }
1435    },
1436    "TSX": {
1437      "code_actions_on_format": {
1438        "source.organizeImports": true
1439      }
1440    }
1441  }
1442}
1443```
1444
14452. Run ESLint `fixAll` code action when formatting:
1446
1447```json
1448{
1449  "languages": {
1450    "JavaScript": {
1451      "code_actions_on_format": {
1452        "source.fixAll.eslint": true
1453      }
1454    }
1455  }
1456}
1457```
1458
14593. Run only a single ESLint rule when using `fixAll`:
1460
1461```json
1462{
1463  "languages": {
1464    "JavaScript": {
1465      "code_actions_on_format": {
1466        "source.fixAll.eslint": true
1467      }
1468    }
1469  },
1470  "lsp": {
1471    "eslint": {
1472      "settings": {
1473        "codeActionOnSave": {
1474          "rules": ["import/order"]
1475        }
1476      }
1477    }
1478  }
1479}
1480```
1481
1482## Auto close
1483
1484- Description: Whether to automatically add matching closing characters when typing opening parenthesis, bracket, brace, single or double quote characters.
1485- Setting: `use_autoclose`
1486- Default: `true`
1487
1488**Options**
1489
1490`boolean` values
1491
1492## Always Treat Brackets As Autoclosed
1493
1494- Description: Controls how the editor handles the autoclosed characters.
1495- Setting: `always_treat_brackets_as_autoclosed`
1496- Default: `false`
1497
1498**Options**
1499
1500`boolean` values
1501
1502**Example**
1503
1504If the setting is set to `true`:
1505
15061. Enter in the editor: `)))`
15072. Move the cursor to the start: `^)))`
15083. Enter again: `)))`
1509
1510The result is still `)))` and not `))))))`, which is what it would be by default.
1511
1512## File Scan Exclusions
1513
1514- Setting: `file_scan_exclusions`
1515- 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`.
1516- Default:
1517
1518```json
1519"file_scan_exclusions": [
1520  "**/.git",
1521  "**/.svn",
1522  "**/.hg",
1523  "**/.jj",
1524  "**/CVS",
1525  "**/.DS_Store",
1526  "**/Thumbs.db",
1527  "**/.classpath",
1528  "**/.settings"
1529],
1530```
1531
1532Note, 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.
1533
1534## File Scan Inclusions
1535
1536- Setting: `file_scan_inclusions`
1537- 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.
1538- Default:
1539
1540```json
1541"file_scan_inclusions": [".env*"],
1542```
1543
1544## File Types
1545
1546- Setting: `file_types`
1547- Description: Configure how Zed selects a language for a file based on its filename or extension. Supports glob entries.
1548- Default:
1549
1550```json
1551"file_types": {
1552  "JSONC": ["**/.zed/**/*.json", "**/zed/**/*.json", "**/Zed/**/*.json", "**/.vscode/**/*.json"],
1553  "Shell Script": [".env.*"]
1554}
1555```
1556
1557**Examples**
1558
1559To interpret all `.c` files as C++, files called `MyLockFile` as TOML and files starting with `Dockerfile` as Dockerfile:
1560
1561```json
1562{
1563  "file_types": {
1564    "C++": ["c"],
1565    "TOML": ["MyLockFile"],
1566    "Dockerfile": ["Dockerfile*"]
1567  }
1568}
1569```
1570
1571## Diagnostics
1572
1573- Description: Configuration for diagnostics-related features.
1574- Setting: `diagnostics`
1575- Default:
1576
1577```json
1578{
1579  "diagnostics": {
1580    "include_warnings": true,
1581    "inline": {
1582      "enabled": false
1583    },
1584    "update_with_cursor": false,
1585    "primary_only": false,
1586    "use_rendered": false
1587  }
1588}
1589```
1590
1591### Inline Diagnostics
1592
1593- Description: Whether or not to show diagnostics information inline.
1594- Setting: `inline`
1595- Default:
1596
1597```json
1598{
1599  "diagnostics": {
1600    "inline": {
1601      "enabled": false,
1602      "update_debounce_ms": 150,
1603      "padding": 4,
1604      "min_column": 0,
1605      "max_severity": null
1606    }
1607  }
1608}
1609```
1610
1611**Options**
1612
16131. Enable inline diagnostics.
1614
1615```json
1616{
1617  "diagnostics": {
1618    "inline": {
1619      "enabled": true
1620    }
1621  }
1622}
1623```
1624
16252. Delay diagnostic updates until some time after the last diagnostic update.
1626
1627```json
1628{
1629  "diagnostics": {
1630    "inline": {
1631      "enabled": true,
1632      "update_debounce_ms": 150
1633    }
1634  }
1635}
1636```
1637
16383. Set padding between the end of the source line and the start of the diagnostic.
1639
1640```json
1641{
1642  "diagnostics": {
1643    "inline": {
1644      "enabled": true,
1645      "padding": 4
1646    }
1647  }
1648}
1649```
1650
16514. Horizontally align inline diagnostics at the given column.
1652
1653```json
1654{
1655  "diagnostics": {
1656    "inline": {
1657      "enabled": true,
1658      "min_column": 80
1659    }
1660  }
1661}
1662```
1663
16645. Show only warning and error diagnostics.
1665
1666```json
1667{
1668  "diagnostics": {
1669    "inline": {
1670      "enabled": true,
1671      "max_severity": "warning"
1672    }
1673  }
1674}
1675```
1676
1677## Git
1678
1679- Description: Configuration for git-related features.
1680- Setting: `git`
1681- Default:
1682
1683```json
1684{
1685  "git": {
1686    "git_gutter": "tracked_files",
1687    "inline_blame": {
1688      "enabled": true
1689    },
1690    "hunk_style": "staged_hollow"
1691  }
1692}
1693```
1694
1695### Git Gutter
1696
1697- Description: Whether or not to show the git gutter.
1698- Setting: `git_gutter`
1699- Default: `tracked_files`
1700
1701**Options**
1702
17031. Show git gutter in tracked files
1704
1705```json
1706{
1707  "git": {
1708    "git_gutter": "tracked_files"
1709  }
1710}
1711```
1712
17132. Hide git gutter
1714
1715```json
1716{
1717  "git": {
1718    "git_gutter": "hide"
1719  }
1720}
1721```
1722
1723### Gutter Debounce
1724
1725- Description: Sets the debounce threshold (in milliseconds) after which changes are reflected in the git gutter.
1726- Setting: `gutter_debounce`
1727- Default: `null`
1728
1729**Options**
1730
1731`integer` values representing milliseconds
1732
1733Example:
1734
1735```json
1736{
1737  "git": {
1738    "gutter_debounce": 100
1739  }
1740}
1741```
1742
1743### Inline Git Blame
1744
1745- Description: Whether or not to show git blame information inline, on the currently focused line.
1746- Setting: `inline_blame`
1747- Default:
1748
1749```json
1750{
1751  "git": {
1752    "inline_blame": {
1753      "enabled": true
1754    }
1755  }
1756}
1757```
1758
1759**Options**
1760
17611. Disable inline git blame:
1762
1763```json
1764{
1765  "git": {
1766    "inline_blame": {
1767      "enabled": false
1768    }
1769  }
1770}
1771```
1772
17732. Only show inline git blame after a delay (that starts after cursor stops moving):
1774
1775```json
1776{
1777  "git": {
1778    "inline_blame": {
1779      "enabled": true,
1780      "delay_ms": 500
1781    }
1782  }
1783}
1784```
1785
17863. Show a commit summary next to the commit date and author:
1787
1788```json
1789{
1790  "git": {
1791    "inline_blame": {
1792      "enabled": true,
1793      "show_commit_summary": true
1794    }
1795  }
1796}
1797```
1798
17994. Use this as the minimum column at which to display inline blame information:
1800
1801```json
1802{
1803  "git": {
1804    "inline_blame": {
1805      "enabled": true,
1806      "min_column": 80
1807    }
1808  }
1809}
1810```
1811
1812### Hunk Style
1813
1814- Description: What styling we should use for the diff hunks.
1815- Setting: `hunk_style`
1816- Default:
1817
1818```json
1819{
1820  "git": {
1821    "hunk_style": "staged_hollow"
1822  }
1823}
1824```
1825
1826**Options**
1827
18281. Show the staged hunks faded out and with a border:
1829
1830```json
1831{
1832  "git": {
1833    "hunk_style": "staged_hollow"
1834  }
1835}
1836```
1837
18382. Show unstaged hunks faded out and with a border:
1839
1840```json
1841{
1842  "git": {
1843    "hunk_style": "unstaged_hollow"
1844  }
1845}
1846```
1847
1848## Indent Guides
1849
1850- Description: Configuration related to indent guides. Indent guides can be configured separately for each language.
1851- Setting: `indent_guides`
1852- Default:
1853
1854```json
1855{
1856  "indent_guides": {
1857    "enabled": true,
1858    "line_width": 1,
1859    "active_line_width": 1,
1860    "coloring": "fixed",
1861    "background_coloring": "disabled"
1862  }
1863}
1864```
1865
1866**Options**
1867
18681. Disable indent guides
1869
1870```json
1871{
1872  "indent_guides": {
1873    "enabled": false
1874  }
1875}
1876```
1877
18782. Enable indent guides for a specific language.
1879
1880```json
1881{
1882  "languages": {
1883    "Python": {
1884      "indent_guides": {
1885        "enabled": true
1886      }
1887    }
1888  }
1889}
1890```
1891
18923. Enable indent aware coloring ("rainbow indentation").
1893   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.
1894
1895```json
1896{
1897  "indent_guides": {
1898    "enabled": true,
1899    "coloring": "indent_aware"
1900  }
1901}
1902```
1903
19044. Enable indent aware background coloring ("rainbow indentation").
1905   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.
1906
1907```json
1908{
1909  "indent_guides": {
1910    "enabled": true,
1911    "coloring": "indent_aware",
1912    "background_coloring": "indent_aware"
1913  }
1914}
1915```
1916
1917## Hard Tabs
1918
1919- Description: Whether to indent lines using tab characters or multiple spaces.
1920- Setting: `hard_tabs`
1921- Default: `false`
1922
1923**Options**
1924
1925`boolean` values
1926
1927## Hover Popover Enabled
1928
1929- Description: Whether or not to show the informational hover box when moving the mouse over symbols in the editor.
1930- Setting: `hover_popover_enabled`
1931- Default: `true`
1932
1933**Options**
1934
1935`boolean` values
1936
1937## Hover Popover Delay
1938
1939- Description: Time to wait in milliseconds before showing the informational hover box.
1940- Setting: `hover_popover_delay`
1941- Default: `300`
1942
1943**Options**
1944
1945`integer` values representing milliseconds
1946
1947## Icon Theme
1948
1949- 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.
1950- Setting: `icon_theme`
1951- Default: `Zed (Default)`
1952
1953### Icon Theme Object
1954
1955- Description: Specify the icon theme using an object that includes the `mode`, `dark`, and `light`.
1956- Setting: `icon_theme`
1957- Default:
1958
1959```json
1960"icon_theme": {
1961  "mode": "system",
1962  "dark": "Zed (Default)",
1963  "light": "Zed (Default)"
1964},
1965```
1966
1967### Mode
1968
1969- Description: Specify the icon theme mode.
1970- Setting: `mode`
1971- Default: `system`
1972
1973**Options**
1974
19751. Set the icon theme to dark mode
1976
1977```json
1978{
1979  "mode": "dark"
1980}
1981```
1982
19832. Set the icon theme to light mode
1984
1985```json
1986{
1987  "mode": "light"
1988}
1989```
1990
19913. Set the icon theme to system mode
1992
1993```json
1994{
1995  "mode": "system"
1996}
1997```
1998
1999### Dark
2000
2001- Description: The name of the dark icon theme.
2002- Setting: `dark`
2003- Default: `Zed (Default)`
2004
2005**Options**
2006
2007Run the `icon theme selector: toggle` action in the command palette to see a current list of valid icon themes names.
2008
2009### Light
2010
2011- Description: The name of the light icon theme.
2012- Setting: `light`
2013- Default: `Zed (Default)`
2014
2015**Options**
2016
2017Run the `icon theme selector: toggle` action in the command palette to see a current list of valid icon themes names.
2018
2019## Inlay hints
2020
2021- Description: Configuration for displaying extra text with hints in the editor.
2022- Setting: `inlay_hints`
2023- Default:
2024
2025```json
2026"inlay_hints": {
2027  "enabled": false,
2028  "show_type_hints": true,
2029  "show_parameter_hints": true,
2030  "show_other_hints": true,
2031  "show_background": false,
2032  "edit_debounce_ms": 700,
2033  "scroll_debounce_ms": 50,
2034  "toggle_on_modifiers_press": null
2035}
2036```
2037
2038**Options**
2039
2040Inlay hints querying consists of two parts: editor (client) and LSP server.
2041With 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.
2042At 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.
2043
2044The following languages have inlay hints preconfigured by Zed:
2045
2046- [Go](https://docs.zed.dev/languages/go)
2047- [Rust](https://docs.zed.dev/languages/rust)
2048- [Svelte](https://docs.zed.dev/languages/svelte)
2049- [Typescript](https://docs.zed.dev/languages/typescript)
2050
2051Use the `lsp` section for the server configuration. Examples are provided in the corresponding language documentation.
2052
2053Hints are not instantly queried in Zed, two kinds of debounces are used, either may be set to 0 to be disabled.
2054Settings-related hint updates are not debounced.
2055
2056All possible config values for `toggle_on_modifiers_press` are:
2057
2058```json
2059"inlay_hints": {
2060  "toggle_on_modifiers_press": {
2061    "control": true,
2062    "shift": true,
2063    "alt": true,
2064    "platform": true,
2065    "function": true
2066  }
2067}
2068```
2069
2070Unspecified values have a `false` value, hints won't be toggled if all the modifiers are `false` or not all the modifiers are pressed.
2071
2072## Journal
2073
2074- Description: Configuration for the journal.
2075- Setting: `journal`
2076- Default:
2077
2078```json
2079"journal": {
2080  "path": "~",
2081  "hour_format": "hour12"
2082}
2083```
2084
2085### Path
2086
2087- Description: The path of the directory where journal entries are stored.
2088- Setting: `path`
2089- Default: `~`
2090
2091**Options**
2092
2093`string` values
2094
2095### Hour Format
2096
2097- Description: The format to use for displaying hours in the journal.
2098- Setting: `hour_format`
2099- Default: `hour12`
2100
2101**Options**
2102
21031. 12-hour format:
2104
2105```json
2106{
2107  "hour_format": "hour12"
2108}
2109```
2110
21112. 24-hour format:
2112
2113```json
2114{
2115  "hour_format": "hour24"
2116}
2117```
2118
2119## Languages
2120
2121- Description: Configuration for specific languages.
2122- Setting: `languages`
2123- Default: `null`
2124
2125**Options**
2126
2127To override settings for a language, add an entry for that languages name to the `languages` value. Example:
2128
2129```json
2130"languages": {
2131  "C": {
2132    "format_on_save": "off",
2133    "preferred_line_length": 64,
2134    "soft_wrap": "preferred_line_length"
2135  },
2136  "JSON": {
2137    "tab_size": 4
2138  }
2139}
2140```
2141
2142The following settings can be overridden for each specific language:
2143
2144- [`enable_language_server`](#enable-language-server)
2145- [`ensure_final_newline_on_save`](#ensure-final-newline-on-save)
2146- [`format_on_save`](#format-on-save)
2147- [`formatter`](#formatter)
2148- [`hard_tabs`](#hard-tabs)
2149- [`preferred_line_length`](#preferred-line-length)
2150- [`remove_trailing_whitespace_on_save`](#remove-trailing-whitespace-on-save)
2151- [`show_edit_predictions`](#show-edit-predictions)
2152- [`show_whitespaces`](#show-whitespaces)
2153- [`soft_wrap`](#soft-wrap)
2154- [`tab_size`](#tab-size)
2155- [`use_autoclose`](#use-autoclose)
2156- [`always_treat_brackets_as_autoclosed`](#always-treat-brackets-as-autoclosed)
2157
2158These values take in the same options as the root-level settings with the same name.
2159
2160## Network Proxy
2161
2162- Description: Configure a network proxy for Zed.
2163- Setting: `proxy`
2164- Default: `null`
2165
2166**Options**
2167
2168The proxy setting must contain a URL to the proxy.
2169
2170The following URI schemes are supported:
2171
2172- `http`
2173- `https`
2174- `socks4` - SOCKS4 proxy with local DNS
2175- `socks4a` - SOCKS4 proxy with remote DNS
2176- `socks5` - SOCKS5 proxy with local DNS
2177- `socks5h` - SOCKS5 proxy with remote DNS
2178
2179`http` will be used when no scheme is specified.
2180
2181By 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`.
2182
2183For example, to set an `http` proxy, add the following to your settings:
2184
2185```json
2186{
2187  "proxy": "http://127.0.0.1:10809"
2188}
2189```
2190
2191Or to set a `socks5` proxy:
2192
2193```json
2194{
2195  "proxy": "socks5h://localhost:10808"
2196}
2197```
2198
2199## Preview tabs
2200
2201- Description:
2202  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. \
2203   There are several ways to convert a preview tab into a regular tab:
2204
2205  - Double-clicking on the file
2206  - Double-clicking on the tab header
2207  - Using the `project_panel::OpenPermanent` action
2208  - Editing the file
2209  - Dragging the file to a different pane
2210
2211- Setting: `preview_tabs`
2212- Default:
2213
2214```json
2215"preview_tabs": {
2216  "enabled": true,
2217  "enable_preview_from_file_finder": false,
2218  "enable_preview_from_code_navigation": false,
2219}
2220```
2221
2222### Enable preview from file finder
2223
2224- Description: Determines whether to open files in preview mode when selected from the file finder.
2225- Setting: `enable_preview_from_file_finder`
2226- Default: `false`
2227
2228**Options**
2229
2230`boolean` values
2231
2232### Enable preview from code navigation
2233
2234- Description: Determines whether a preview tab gets replaced when code navigation is used to navigate away from the tab.
2235- Setting: `enable_preview_from_code_navigation`
2236- Default: `false`
2237
2238**Options**
2239
2240`boolean` values
2241
2242## File Finder
2243
2244### File Icons
2245
2246- Description: Whether to show file icons in the file finder.
2247- Setting: `file_icons`
2248- Default: `true`
2249
2250### Modal Max Width
2251
2252- Description: Max-width of the file finder modal. It can take one of these values: `small`, `medium`, `large`, `xlarge`, and `full`.
2253- Setting: `modal_max_width`
2254- Default: `small`
2255
2256### Skip Focus For Active In Search
2257
2258- Description: Determines whether the file finder should skip focus for the active file in search results.
2259- Setting: `skip_focus_for_active_in_search`
2260- Default: `true`
2261
2262## Preferred Line Length
2263
2264- Description: The column at which to soft-wrap lines, for buffers where soft-wrap is enabled.
2265- Setting: `preferred_line_length`
2266- Default: `80`
2267
2268**Options**
2269
2270`integer` values
2271
2272## Projects Online By Default
2273
2274- Description: Whether or not to show the online projects view by default.
2275- Setting: `projects_online_by_default`
2276- Default: `true`
2277
2278**Options**
2279
2280`boolean` values
2281
2282## Remove Trailing Whitespace On Save
2283
2284- Description: Whether or not to remove any trailing whitespace from lines of a buffer before saving it.
2285- Setting: `remove_trailing_whitespace_on_save`
2286- Default: `true`
2287
2288**Options**
2289
2290`boolean` values
2291
2292## Search
2293
2294- Description: Search options to enable by default when opening new project and buffer searches.
2295- Setting: `search`
2296- Default:
2297
2298```json
2299"search": {
2300  "whole_word": false,
2301  "case_sensitive": false,
2302  "include_ignored": false,
2303  "regex": false
2304},
2305```
2306
2307## Seed Search Query From Cursor
2308
2309- Description: When to populate a new search's query based on the text under the cursor.
2310- Setting: `seed_search_query_from_cursor`
2311- Default: `always`
2312
2313**Options**
2314
23151. `always` always populate the search query with the word under the cursor
23162. `selection` only populate the search query when there is text selected
23173. `never` never populate the search query
2318
2319## Use Smartcase Search
2320
2321- 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. \
2322  This applies to both in-file searches and project-wide searches.
2323- Setting: `use_smartcase_search`
2324- Default: `false`
2325
2326**Options**
2327
2328`boolean` values
2329
2330Examples:
2331
2332- Searching for "function" would match "function", "Function", "FUNCTION", etc.
2333- Searching for "Function" would only match "Function", not "function" or "FUNCTION"
2334
2335## Show Call Status Icon
2336
2337- Description: Whether or not to show the call status icon in the status bar.
2338- Setting: `show_call_status_icon`
2339- Default: `true`
2340
2341**Options**
2342
2343`boolean` values
2344
2345## Completions
2346
2347- Description: Controls how completions are processed for this language.
2348- Setting: `completions`
2349- Default:
2350
2351```json
2352{
2353  "completions": {
2354    "words": "fallback",
2355    "lsp": true,
2356    "lsp_fetch_timeout_ms": 0,
2357    "lsp_insert_mode": "replace_suffix"
2358  }
2359}
2360```
2361
2362### Words
2363
2364- Description: Controls how words are completed. For large documents, not all words may be fetched for completion.
2365- Setting: `words`
2366- Default: `fallback`
2367
2368**Options**
2369
23701. `enabled` - Always fetch document's words for completions along with LSP completions
23712. `fallback` - Only if LSP response errors or times out, use document's words to show completions
23723. `disabled` - Never fetch or complete document's words for completions (word-based completions can still be queried via a separate action)
2373
2374### LSP
2375
2376- Description: Whether to fetch LSP completions or not.
2377- Setting: `lsp`
2378- Default: `true`
2379
2380**Options**
2381
2382`boolean` values
2383
2384### LSP Fetch Timeout (ms)
2385
2386- Description: When fetching LSP completions, determines how long to wait for a response of a particular server. When set to 0, waits indefinitely.
2387- Setting: `lsp_fetch_timeout_ms`
2388- Default: `0`
2389
2390**Options**
2391
2392`integer` values representing milliseconds
2393
2394### LSP Insert Mode
2395
2396- Description: Controls what range to replace when accepting LSP completions.
2397- Setting: `lsp_insert_mode`
2398- Default: `replace_suffix`
2399
2400**Options**
2401
24021. `insert` - Replaces text before the cursor, using the `insert` range described in the LSP specification
24032. `replace` - Replaces text before and after the cursor, using the `replace` range described in the LSP specification
24043. `replace_subsequence` - Behaves like `"replace"` if the text that would be replaced is a subsequence of the completion text, and like `"insert"` otherwise
24054. `replace_suffix` - Behaves like `"replace"` if the text after the cursor is a suffix of the completion, and like `"insert"` otherwise
2406
2407## Show Completions On Input
2408
2409- Description: Whether or not to show completions as you type.
2410- Setting: `show_completions_on_input`
2411- Default: `true`
2412
2413**Options**
2414
2415`boolean` values
2416
2417## Show Completion Documentation
2418
2419- Description: Whether to display inline and alongside documentation for items in the completions menu.
2420- Setting: `show_completion_documentation`
2421- Default: `true`
2422
2423**Options**
2424
2425`boolean` values
2426
2427## Show Edit Predictions
2428
2429- Description: Whether to show edit predictions as you type or manually by triggering `editor::ShowEditPrediction`.
2430- Setting: `show_edit_predictions`
2431- Default: `true`
2432
2433**Options**
2434
2435`boolean` values
2436
2437## Show Whitespaces
2438
2439- Description: Whether or not to render whitespace characters in the editor.
2440- Setting: `show_whitespaces`
2441- Default: `selection`
2442
2443**Options**
2444
24451. `all`
24462. `selection`
24473. `none`
24484. `boundary`
2449
2450## Soft Wrap
2451
2452- Description: Whether or not to automatically wrap lines of text to fit editor / preferred width.
2453- Setting: `soft_wrap`
2454- Default: `none`
2455
2456**Options**
2457
24581. `none` to avoid wrapping generally, unless the line is too long
24592. `prefer_line` (deprecated, same as `none`)
24603. `editor_width` to wrap lines that overflow the editor width
24614. `preferred_line_length` to wrap lines that overflow `preferred_line_length` config value
24625. `bounded` to wrap lines at the minimum of `editor_width` and `preferred_line_length`
2463
2464## Wrap Guides (Vertical Rulers)
2465
2466- Description: Where to display vertical rulers as wrap-guides. Disable by setting `show_wrap_guides` to `false`.
2467- Setting: `wrap_guides`
2468- Default: []
2469
2470**Options**
2471
2472List of `integer` column numbers
2473
2474## Tab Size
2475
2476- Description: The number of spaces to use for each tab character.
2477- Setting: `tab_size`
2478- Default: `4`
2479
2480**Options**
2481
2482`integer` values
2483
2484## Telemetry
2485
2486- Description: Control what info is collected by Zed.
2487- Setting: `telemetry`
2488- Default:
2489
2490```json
2491"telemetry": {
2492  "diagnostics": true,
2493  "metrics": true
2494},
2495```
2496
2497**Options**
2498
2499### Diagnostics
2500
2501- Description: Setting for sending debug-related data, such as crash reports.
2502- Setting: `diagnostics`
2503- Default: `true`
2504
2505**Options**
2506
2507`boolean` values
2508
2509### Metrics
2510
2511- Description: Setting for sending anonymized usage data, such what languages you're using Zed with.
2512- Setting: `metrics`
2513- Default: `true`
2514
2515**Options**
2516
2517`boolean` values
2518
2519## Terminal
2520
2521- Description: Configuration for the terminal.
2522- Setting: `terminal`
2523- Default:
2524
2525```json
2526{
2527  "terminal": {
2528    "alternate_scroll": "off",
2529    "blinking": "terminal_controlled",
2530    "copy_on_select": false,
2531    "dock": "bottom",
2532    "default_width": 640,
2533    "default_height": 320,
2534    "detect_venv": {
2535      "on": {
2536        "directories": [".env", "env", ".venv", "venv"],
2537        "activate_script": "default"
2538      }
2539    },
2540    "env": {},
2541    "font_family": null,
2542    "font_features": null,
2543    "font_size": null,
2544    "line_height": "comfortable",
2545    "option_as_meta": false,
2546    "button": true,
2547    "shell": "system",
2548    "toolbar": {
2549      "breadcrumbs": true
2550    },
2551    "working_directory": "current_project_directory",
2552    "scrollbar": {
2553      "show": null
2554    }
2555  }
2556}
2557```
2558
2559### Terminal: Dock
2560
2561- Description: Control the position of the dock
2562- Setting: `dock`
2563- Default: `bottom`
2564
2565**Options**
2566
2567`"bottom"`, `"left"` or `"right"`
2568
2569### Terminal: Alternate Scroll
2570
2571- 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.
2572- Setting: `alternate_scroll`
2573- Default: `off`
2574
2575**Options**
2576
25771. Default alternate scroll mode to off
2578
2579```json
2580{
2581  "terminal": {
2582    "alternate_scroll": "off"
2583  }
2584}
2585```
2586
25872. Default alternate scroll mode to on
2588
2589```json
2590{
2591  "terminal": {
2592    "alternate_scroll": "on"
2593  }
2594}
2595```
2596
2597### Terminal: Blinking
2598
2599- Description: Set the cursor blinking behavior in the terminal
2600- Setting: `blinking`
2601- Default: `terminal_controlled`
2602
2603**Options**
2604
26051. Never blink the cursor, ignore the terminal mode
2606
2607```json
2608{
2609  "terminal": {
2610    "blinking": "off"
2611  }
2612}
2613```
2614
26152. Default the cursor blink to off, but allow the terminal to turn blinking on
2616
2617```json
2618{
2619  "terminal": {
2620    "blinking": "terminal_controlled"
2621  }
2622}
2623```
2624
26253. Always blink the cursor, ignore the terminal mode
2626
2627```json
2628{
2629  "terminal": {
2630    "blinking": "on"
2631  }
2632}
2633```
2634
2635### Terminal: Copy On Select
2636
2637- Description: Whether or not selecting text in the terminal will automatically copy to the system clipboard.
2638- Setting: `copy_on_select`
2639- Default: `false`
2640
2641**Options**
2642
2643`boolean` values
2644
2645**Example**
2646
2647```json
2648{
2649  "terminal": {
2650    "copy_on_select": true
2651  }
2652}
2653```
2654
2655### Terminal: Env
2656
2657- 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
2658- Setting: `env`
2659- Default: `{}`
2660
2661**Example**
2662
2663```json
2664{
2665  "terminal": {
2666    "env": {
2667      "ZED": "1",
2668      "KEY": "value1:value2"
2669    }
2670  }
2671}
2672```
2673
2674### Terminal: Font Size
2675
2676- Description: What font size to use for the terminal. When not set defaults to matching the editor's font size
2677- Setting: `font_size`
2678- Default: `null`
2679
2680**Options**
2681
2682`integer` values
2683
2684```json
2685{
2686  "terminal": {
2687    "font_size": 15
2688  }
2689}
2690```
2691
2692### Terminal: Font Family
2693
2694- Description: What font to use for the terminal. When not set, defaults to matching the editor's font.
2695- Setting: `font_family`
2696- Default: `null`
2697
2698**Options**
2699
2700The name of any font family installed on the user's system
2701
2702```json
2703{
2704  "terminal": {
2705    "font_family": "Berkeley Mono"
2706  }
2707}
2708```
2709
2710### Terminal: Font Features
2711
2712- Description: What font features to use for the terminal. When not set, defaults to matching the editor's font features.
2713- Setting: `font_features`
2714- Default: `null`
2715- Platform: macOS and Windows.
2716
2717**Options**
2718
2719See Buffer Font Features
2720
2721```json
2722{
2723  "terminal": {
2724    "font_features": {
2725      "calt": false
2726      // See Buffer Font Features for more features
2727    }
2728  }
2729}
2730```
2731
2732### Terminal: Line Height
2733
2734- Description: Set the terminal's line height.
2735- Setting: `line_height`
2736- Default: `comfortable`
2737
2738**Options**
2739
27401. Use a line height that's `comfortable` for reading, 1.618. (default)
2741
2742```json
2743{
2744  "terminal": {
2745    "line_height": "comfortable"
2746  }
2747}
2748```
2749
27502. Use a `standard` line height, 1.3. This option is useful for TUIs, particularly if they use box characters
2751
2752```json
2753{
2754  "terminal": {
2755    "line_height": "standard"
2756  }
2757}
2758```
2759
27603.  Use a custom line height.
2761
2762```json
2763{
2764  "terminal": {
2765    "line_height": {
2766      "custom": 2
2767    }
2768  }
2769}
2770```
2771
2772### Terminal: Option As Meta
2773
2774- Description: Re-interprets the option keys to act like a 'meta' key, like in Emacs.
2775- Setting: `option_as_meta`
2776- Default: `false`
2777
2778**Options**
2779
2780`boolean` values
2781
2782```json
2783{
2784  "terminal": {
2785    "option_as_meta": true
2786  }
2787}
2788```
2789
2790### Terminal: Shell
2791
2792- Description: What shell to use when launching the terminal.
2793- Setting: `shell`
2794- Default: `system`
2795
2796**Options**
2797
27981. Use the system's default terminal configuration (usually the `/etc/passwd` file).
2799
2800```json
2801{
2802  "terminal": {
2803    "shell": "system"
2804  }
2805}
2806```
2807
28082. A program to launch:
2809
2810```json
2811{
2812  "terminal": {
2813    "shell": {
2814      "program": "sh"
2815    }
2816  }
2817}
2818```
2819
28203. A program with arguments:
2821
2822```json
2823{
2824  "terminal": {
2825    "shell": {
2826      "with_arguments": {
2827        "program": "/bin/bash",
2828        "args": ["--login"]
2829      }
2830    }
2831  }
2832}
2833```
2834
2835## Terminal: Detect Virtual Environments {#terminal-detect_venv}
2836
2837- 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.
2838- Setting: `detect_venv`
2839- Default:
2840
2841```json
2842{
2843  "terminal": {
2844    "detect_venv": {
2845      "on": {
2846        // Default directories to search for virtual environments, relative
2847        // to the current working directory. We recommend overriding this
2848        // in your project's settings, rather than globally.
2849        "directories": [".env", "env", ".venv", "venv"],
2850        // Can also be `csh`, `fish`, and `nushell`
2851        "activate_script": "default"
2852      }
2853    }
2854  }
2855}
2856```
2857
2858Disable with:
2859
2860```json
2861{
2862  "terminal": {
2863    "detect_venv": "off"
2864  }
2865}
2866```
2867
2868## Terminal: Toolbar
2869
2870- Description: Whether or not to show various elements in the terminal toolbar.
2871- Setting: `toolbar`
2872- Default:
2873
2874```json
2875{
2876  "terminal": {
2877    "toolbar": {
2878      "breadcrumbs": true
2879    }
2880  }
2881}
2882```
2883
2884**Options**
2885
2886At the moment, only the `breadcrumbs` option is available, it controls displaying of the terminal title that can be changed via `PROMPT_COMMAND`.
2887
2888If the terminal title is empty, the breadcrumbs won't be shown.
2889
2890The shell running in the terminal needs to be configured to emit the title.
2891
2892Example command to set the title: `echo -e "\e]2;New Title\007";`
2893
2894### Terminal: Button
2895
2896- Description: Control to show or hide the terminal button in the status bar
2897- Setting: `button`
2898- Default: `true`
2899
2900**Options**
2901
2902`boolean` values
2903
2904```json
2905{
2906  "terminal": {
2907    "button": false
2908  }
2909}
2910```
2911
2912### Terminal: Working Directory
2913
2914- Description: What working directory to use when launching the terminal.
2915- Setting: `working_directory`
2916- Default: `"current_project_directory"`
2917
2918**Options**
2919
29201. Use the current file's project directory. Will Fallback to the first project directory strategy if unsuccessful
2921
2922```json
2923{
2924  "terminal": {
2925    "working_directory": "current_project_directory"
2926  }
2927}
2928```
2929
29302. Use the first project in this workspace's directory. Will fallback to using this platform's home directory.
2931
2932```json
2933{
2934  "terminal": {
2935    "working_directory": "first_project_directory"
2936  }
2937}
2938```
2939
29403. Always use this platform's home directory (if we can find it)
2941
2942```json
2943{
2944  "terminal": {
2945    "working_directory": "always_home"
2946  }
2947}
2948```
2949
29504. 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.
2951
2952```json
2953{
2954  "terminal": {
2955    "working_directory": {
2956      "always": {
2957        "directory": "~/zed/projects/"
2958      }
2959    }
2960  }
2961}
2962```
2963
2964## Theme
2965
2966- 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.
2967- Setting: `theme`
2968- Default: `One Dark`
2969
2970### Theme Object
2971
2972- Description: Specify the theme using an object that includes the `mode`, `dark`, and `light` themes.
2973- Setting: `theme`
2974- Default:
2975
2976```json
2977"theme": {
2978  "mode": "system",
2979  "dark": "One Dark",
2980  "light": "One Light"
2981},
2982```
2983
2984### Mode
2985
2986- Description: Specify theme mode.
2987- Setting: `mode`
2988- Default: `system`
2989
2990**Options**
2991
29921. Set the theme to dark mode
2993
2994```json
2995{
2996  "mode": "dark"
2997}
2998```
2999
30002. Set the theme to light mode
3001
3002```json
3003{
3004  "mode": "light"
3005}
3006```
3007
30083. Set the theme to system mode
3009
3010```json
3011{
3012  "mode": "system"
3013}
3014```
3015
3016### Dark
3017
3018- Description: The name of the dark Zed theme to use for the UI.
3019- Setting: `dark`
3020- Default: `One Dark`
3021
3022**Options**
3023
3024Run the `theme selector: toggle` action in the command palette to see a current list of valid themes names.
3025
3026### Light
3027
3028- Description: The name of the light Zed theme to use for the UI.
3029- Setting: `light`
3030- Default: `One Light`
3031
3032**Options**
3033
3034Run the `theme selector: toggle` action in the command palette to see a current list of valid themes names.
3035
3036## Vim
3037
3038- Description: Whether or not to enable vim mode (work in progress).
3039- Setting: `vim_mode`
3040- Default: `false`
3041
3042## Project Panel
3043
3044- Description: Customize project panel
3045- Setting: `project_panel`
3046- Default:
3047
3048```json
3049{
3050  "project_panel": {
3051    "button": true,
3052    "default_width": 240,
3053    "dock": "left",
3054    "entry_spacing": "comfortable",
3055    "file_icons": true,
3056    "folder_icons": true,
3057    "git_status": true,
3058    "indent_size": 20,
3059    "auto_reveal_entries": true,
3060    "auto_fold_dirs": true,
3061    "scrollbar": {
3062      "show": null
3063    },
3064    "show_diagnostics": "all",
3065    "indent_guides": {
3066      "show": "always"
3067    }
3068  }
3069}
3070```
3071
3072### Dock
3073
3074- Description: Control the position of the dock
3075- Setting: `dock`
3076- Default: `left`
3077
3078**Options**
3079
30801. Default dock position to left
3081
3082```json
3083{
3084  "dock": "left"
3085}
3086```
3087
30882. Default dock position to right
3089
3090```json
3091{
3092  "dock": "right"
3093}
3094```
3095
3096### Entry Spacing
3097
3098- Description: Spacing between worktree entries
3099- Setting: `entry_spacing`
3100- Default: `comfortable`
3101
3102**Options**
3103
31041. Comfortable entry spacing
3105
3106```json
3107{
3108  "entry_spacing": "comfortable"
3109}
3110```
3111
31122. Standard entry spacing
3113
3114```json
3115{
3116  "entry_spacing": "standard"
3117}
3118```
3119
3120### Git Status
3121
3122- Description: Indicates newly created and updated files
3123- Setting: `git_status`
3124- Default: `true`
3125
3126**Options**
3127
31281. Default enable git status
3129
3130```json
3131{
3132  "git_status": true
3133}
3134```
3135
31362. Default disable git status
3137
3138```json
3139{
3140  "git_status": false
3141}
3142```
3143
3144### Default Width
3145
3146- Description: Customize default width taken by project panel
3147- Setting: `default_width`
3148- Default: `240`
3149
3150**Options**
3151
3152`float` values
3153
3154### Auto Reveal Entries
3155
3156- Description: Whether to reveal it in the project panel automatically, when a corresponding project entry becomes active. Gitignored entries are never auto revealed.
3157- Setting: `auto_reveal_entries`
3158- Default: `true`
3159
3160**Options**
3161
31621. Enable auto reveal entries
3163
3164```json
3165{
3166  "auto_reveal_entries": true
3167}
3168```
3169
31702. Disable auto reveal entries
3171
3172```json
3173{
3174  "auto_reveal_entries": false
3175}
3176```
3177
3178### Auto Fold Dirs
3179
3180- Description: Whether to fold directories automatically when directory has only one directory inside.
3181- Setting: `auto_fold_dirs`
3182- Default: `true`
3183
3184**Options**
3185
31861. Enable auto fold dirs
3187
3188```json
3189{
3190  "auto_fold_dirs": true
3191}
3192```
3193
31942. Disable auto fold dirs
3195
3196```json
3197{
3198  "auto_fold_dirs": false
3199}
3200```
3201
3202### Indent Size
3203
3204- Description: Amount of indentation (in pixels) for nested items.
3205- Setting: `indent_size`
3206- Default: `20`
3207
3208### Indent Guides: Show
3209
3210- Description: Whether to show indent guides in the project panel.
3211- Setting: `indent_guides`
3212- Default:
3213
3214```json
3215"indent_guides": {
3216  "show": "always"
3217}
3218```
3219
3220**Options**
3221
32221. Show indent guides in the project panel
3223
3224```json
3225{
3226  "indent_guides": {
3227    "show": "always"
3228  }
3229}
3230```
3231
32322. Hide indent guides in the project panel
3233
3234```json
3235{
3236  "indent_guides": {
3237    "show": "never"
3238  }
3239}
3240```
3241
3242### Scrollbar: Show
3243
3244- 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.
3245- Setting: `scrollbar`
3246- Default:
3247
3248```json
3249"scrollbar": {
3250  "show": null
3251}
3252```
3253
3254**Options**
3255
32561. Show scrollbar in the project panel
3257
3258```json
3259{
3260  "scrollbar": {
3261    "show": "always"
3262  }
3263}
3264```
3265
32662. Hide scrollbar in the project panel
3267
3268```json
3269{
3270  "scrollbar": {
3271    "show": "never"
3272  }
3273}
3274```
3275
3276## Agent
3277
3278- Description: Customize agent behavior
3279- Setting: `agent`
3280- Default:
3281
3282```json
3283"agent": {
3284  "version": "2",
3285  "enabled": true,
3286  "button": true,
3287  "dock": "right",
3288  "default_width": 640,
3289  "default_height": 320,
3290  "default_view": "thread",
3291  "default_model": {
3292    "provider": "zed.dev",
3293    "model": "claude-sonnet-4"
3294  },
3295  "single_file_review": true,
3296}
3297```
3298
3299## Outline Panel
3300
3301- Description: Customize outline Panel
3302- Setting: `outline_panel`
3303- Default:
3304
3305```json
3306"outline_panel": {
3307  "button": true,
3308  "default_width": 300,
3309  "dock": "left",
3310  "file_icons": true,
3311  "folder_icons": true,
3312  "git_status": true,
3313  "indent_size": 20,
3314  "auto_reveal_entries": true,
3315  "auto_fold_dirs": true,
3316  "indent_guides": {
3317    "show": "always"
3318  },
3319  "scrollbar": {
3320    "show": null
3321  }
3322}
3323```
3324
3325## Calls
3326
3327- Description: Customize behavior when participating in a call
3328- Setting: `calls`
3329- Default:
3330
3331```json
3332"calls": {
3333  // Join calls with the microphone live by default
3334  "mute_on_join": false,
3335  // Share your project when you are the first to join a channel
3336  "share_on_join": false
3337},
3338```
3339
3340## Unnecessary Code Fade
3341
3342- Description: How much to fade out unused code.
3343- Setting: `unnecessary_code_fade`
3344- Default: `0.3`
3345
3346**Options**
3347
3348Float values between `0.0` and `0.9`, where:
3349
3350- `0.0` means no fading (unused code looks the same as used code)
3351- `0.9` means maximum fading (unused code is very faint but still visible)
3352
3353**Example**
3354
3355```json
3356{
3357  "unnecessary_code_fade": 0.5
3358}
3359```
3360
3361## UI Font Family
3362
3363- Description: The name of the font to use for text in the UI.
3364- Setting: `ui_font_family`
3365- Default: `Zed Plex Sans`
3366
3367**Options**
3368
3369The name of any font family installed on the system.
3370
3371## UI Font Features
3372
3373- Description: The OpenType features to enable for text in the UI.
3374- Setting: `ui_font_features`
3375- Default:
3376
3377```json
3378"ui_font_features": {
3379  "calt": false
3380}
3381```
3382
3383- Platform: macOS and Windows.
3384
3385**Options**
3386
3387Zed supports all OpenType features that can be enabled or disabled for a given UI font, as well as setting values for font features.
3388
3389For example, to disable font ligatures, add the following to your settings:
3390
3391```json
3392{
3393  "ui_font_features": {
3394    "calt": false
3395  }
3396}
3397```
3398
3399You can also set other OpenType features, like setting `cv01` to `7`:
3400
3401```json
3402{
3403  "ui_font_features": {
3404    "cv01": 7
3405  }
3406}
3407```
3408
3409## UI Font Fallbacks
3410
3411- Description: The font fallbacks to use for text in the UI.
3412- Setting: `ui_font_fallbacks`
3413- Default: `null`
3414- Platform: macOS and Windows.
3415
3416**Options**
3417
3418For example, to use `Nerd Font` as a fallback, add the following to your settings:
3419
3420```json
3421{
3422  "ui_font_fallbacks": ["Nerd Font"]
3423}
3424```
3425
3426## UI Font Size
3427
3428- Description: The default font size for text in the UI.
3429- Setting: `ui_font_size`
3430- Default: `16`
3431
3432**Options**
3433
3434`integer` values from `6` to `100` pixels (inclusive)
3435
3436## UI Font Weight
3437
3438- Description: The default font weight for text in the UI.
3439- Setting: `ui_font_weight`
3440- Default: `400`
3441
3442**Options**
3443
3444`integer` values between `100` and `900`
3445
3446## An example configuration:
3447
3448```json
3449// ~/.config/zed/settings.json
3450{
3451  "theme": "cave-light",
3452  "tab_size": 2,
3453  "preferred_line_length": 80,
3454  "soft_wrap": "none",
3455
3456  "buffer_font_size": 18,
3457  "buffer_font_family": "Zed Plex Mono",
3458
3459  "autosave": "on_focus_change",
3460  "format_on_save": "off",
3461  "vim_mode": false,
3462  "projects_online_by_default": true,
3463  "terminal": {
3464    "font_family": "FiraCode Nerd Font Mono",
3465    "blinking": "off"
3466  },
3467  "languages": {
3468    "C": {
3469      "format_on_save": "language_server",
3470      "preferred_line_length": 64,
3471      "soft_wrap": "preferred_line_length"
3472    }
3473  }
3474}
3475```