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
 6424. Do not show snippets in the completion list at all:
 643
 644```json
 645"snippet_sort_order": "none"
 646```
 647
 648## Editor Scrollbar
 649
 650- Description: Whether or not to show the editor scrollbar and various elements in it.
 651- Setting: `scrollbar`
 652- Default:
 653
 654```json
 655"scrollbar": {
 656  "show": "auto",
 657  "cursors": true,
 658  "git_diff": true,
 659  "search_results": true,
 660  "selected_text": true,
 661  "selected_symbol": true,
 662  "diagnostics": "all",
 663  "axes": {
 664    "horizontal": true,
 665    "vertical": true,
 666  },
 667},
 668```
 669
 670### Show Mode
 671
 672- Description: When to show the editor scrollbar.
 673- Setting: `show`
 674- Default: `auto`
 675
 676**Options**
 677
 6781. Show the scrollbar if there's important information or follow the system's configured behavior:
 679
 680```json
 681"scrollbar": {
 682  "show": "auto"
 683}
 684```
 685
 6862. Match the system's configured behavior:
 687
 688```json
 689"scrollbar": {
 690  "show": "system"
 691}
 692```
 693
 6943. Always show the scrollbar:
 695
 696```json
 697"scrollbar": {
 698  "show": "always"
 699}
 700```
 701
 7024. Never show the scrollbar:
 703
 704```json
 705"scrollbar": {
 706  "show": "never"
 707}
 708```
 709
 710### Cursor Indicators
 711
 712- Description: Whether to show cursor positions in the scrollbar.
 713- Setting: `cursors`
 714- Default: `true`
 715
 716**Options**
 717
 718`boolean` values
 719
 720### Git Diff Indicators
 721
 722- Description: Whether to show git diff indicators in the scrollbar.
 723- Setting: `git_diff`
 724- Default: `true`
 725
 726**Options**
 727
 728`boolean` values
 729
 730### Search Results Indicators
 731
 732- Description: Whether to show buffer search results in the scrollbar.
 733- Setting: `search_results`
 734- Default: `true`
 735
 736**Options**
 737
 738`boolean` values
 739
 740### Selected Text Indicators
 741
 742- Description: Whether to show selected text occurrences in the scrollbar.
 743- Setting: `selected_text`
 744- Default: `true`
 745
 746**Options**
 747
 748`boolean` values
 749
 750### Selected Symbols Indicators
 751
 752- Description: Whether to show selected symbol occurrences in the scrollbar.
 753- Setting: `selected_symbol`
 754- Default: `true`
 755
 756**Options**
 757
 758`boolean` values
 759
 760### Diagnostics
 761
 762- Description: Which diagnostic indicators to show in the scrollbar.
 763- Setting: `diagnostics`
 764- Default: `all`
 765
 766**Options**
 767
 7681. Show all diagnostics:
 769
 770```json
 771{
 772  "diagnostics": "all"
 773}
 774```
 775
 7762. Do not show any diagnostics:
 777
 778```json
 779{
 780  "diagnostics": "none"
 781}
 782```
 783
 7843. Show only errors:
 785
 786```json
 787{
 788  "diagnostics": "error"
 789}
 790```
 791
 7924. Show only errors and warnings:
 793
 794```json
 795{
 796  "diagnostics": "warning"
 797}
 798```
 799
 8005. Show only errors, warnings, and information:
 801
 802```json
 803{
 804  "diagnostics": "information"
 805}
 806```
 807
 808### Axes
 809
 810- Description: Forcefully enable or disable the scrollbar for each axis
 811- Setting: `axes`
 812- Default:
 813
 814```json
 815"scrollbar": {
 816  "axes": {
 817    "horizontal": true,
 818    "vertical": true,
 819  },
 820}
 821```
 822
 823#### Horizontal
 824
 825- Description: When false, forcefully disables the horizontal scrollbar. Otherwise, obey other settings.
 826- Setting: `horizontal`
 827- Default: `true`
 828
 829**Options**
 830
 831`boolean` values
 832
 833#### Vertical
 834
 835- Description: When false, forcefully disables the vertical scrollbar. Otherwise, obey other settings.
 836- Setting: `vertical`
 837- Default: `true`
 838
 839**Options**
 840
 841`boolean` values
 842
 843## Minimap
 844
 845- Description: Settings related to the editor's minimap, which provides an overview of your document.
 846- Setting: `minimap`
 847- Default:
 848
 849```json
 850{
 851  "minimap": {
 852    "show": "never",
 853    "thumb": "always",
 854    "thumb_border": "left_open",
 855    "current_line_highlight": null
 856  }
 857}
 858```
 859
 860### Show Mode
 861
 862- Description: When to show the minimap in the editor.
 863- Setting: `show`
 864- Default: `never`
 865
 866**Options**
 867
 8681. Always show the minimap:
 869
 870```json
 871{
 872  "show": "always"
 873}
 874```
 875
 8762. Show the minimap if the editor's scrollbars are visible:
 877
 878```json
 879{
 880  "show": "auto"
 881}
 882```
 883
 8843. Never show the minimap:
 885
 886```json
 887{
 888  "show": "never"
 889}
 890```
 891
 892### Thumb Display
 893
 894- Description: When to show the minimap thumb (the visible editor area) in the minimap.
 895- Setting: `thumb`
 896- Default: `always`
 897
 898**Options**
 899
 9001. Show the minimap thumb when hovering over the minimap:
 901
 902```json
 903{
 904  "thumb": "hover"
 905}
 906```
 907
 9082. Always show the minimap thumb:
 909
 910```json
 911{
 912  "thumb": "always"
 913}
 914```
 915
 916### Thumb Border
 917
 918- Description: How the minimap thumb border should look.
 919- Setting: `thumb_border`
 920- Default: `left_open`
 921
 922**Options**
 923
 9241. Display a border on all sides of the thumb:
 925
 926```json
 927{
 928  "thumb_border": "full"
 929}
 930```
 931
 9322. Display a border on all sides except the left side:
 933
 934```json
 935{
 936  "thumb_border": "left_open"
 937}
 938```
 939
 9403. Display a border on all sides except the right side:
 941
 942```json
 943{
 944  "thumb_border": "right_open"
 945}
 946```
 947
 9484. Display a border only on the left side:
 949
 950```json
 951{
 952  "thumb_border": "left_only"
 953}
 954```
 955
 9565. Display the thumb without any border:
 957
 958```json
 959{
 960  "thumb_border": "none"
 961}
 962```
 963
 964### Current Line Highlight
 965
 966- Description: How to highlight the current line in the minimap.
 967- Setting: `current_line_highlight`
 968- Default: `null`
 969
 970**Options**
 971
 9721. Inherit the editor's current line highlight setting:
 973
 974```json
 975{
 976  "minimap": {
 977    "current_line_highlight": null
 978  }
 979}
 980```
 981
 9822. Highlight the current line in the minimap:
 983
 984```json
 985{
 986  "minimap": {
 987    "current_line_highlight": "line"
 988  }
 989}
 990```
 991
 992or
 993
 994```json
 995{
 996  "minimap": {
 997    "current_line_highlight": "all"
 998  }
 999}
1000```
1001
10023. Do not highlight the current line in the minimap:
1003
1004```json
1005{
1006  "minimap": {
1007    "current_line_highlight": "gutter"
1008  }
1009}
1010```
1011
1012or
1013
1014```json
1015{
1016  "minimap": {
1017    "current_line_highlight": "none"
1018  }
1019}
1020```
1021
1022## Editor Tab Bar
1023
1024- Description: Settings related to the editor's tab bar.
1025- Settings: `tab_bar`
1026- Default:
1027
1028```json
1029"tab_bar": {
1030  "show": true,
1031  "show_nav_history_buttons": true,
1032  "show_tab_bar_buttons": true
1033}
1034```
1035
1036### Show
1037
1038- Description: Whether or not to show the tab bar in the editor.
1039- Setting: `show`
1040- Default: `true`
1041
1042**Options**
1043
1044`boolean` values
1045
1046### Navigation History Buttons
1047
1048- Description: Whether or not to show the navigation history buttons.
1049- Setting: `show_nav_history_buttons`
1050- Default: `true`
1051
1052**Options**
1053
1054`boolean` values
1055
1056### Tab Bar Buttons
1057
1058- Description: Whether or not to show the tab bar buttons.
1059- Setting: `show_tab_bar_buttons`
1060- Default: `true`
1061
1062**Options**
1063
1064`boolean` values
1065
1066## Editor Tabs
1067
1068- Description: Configuration for the editor tabs.
1069- Setting: `tabs`
1070- Default:
1071
1072```json
1073"tabs": {
1074  "close_position": "right",
1075  "file_icons": false,
1076  "git_status": false,
1077  "activate_on_close": "history",
1078  "show_close_button": "hover",
1079  "show_diagnostics": "off"
1080},
1081```
1082
1083### Close Position
1084
1085- Description: Where to display close button within a tab.
1086- Setting: `close_position`
1087- Default: `right`
1088
1089**Options**
1090
10911. Display the close button on the right:
1092
1093```json
1094{
1095  "close_position": "right"
1096}
1097```
1098
10992. Display the close button on the left:
1100
1101```json
1102{
1103  "close_position": "left"
1104}
1105```
1106
1107### File Icons
1108
1109- Description: Whether to show the file icon for a tab.
1110- Setting: `file_icons`
1111- Default: `false`
1112
1113### Git Status
1114
1115- Description: Whether or not to show Git file status in tab.
1116- Setting: `git_status`
1117- Default: `false`
1118
1119### Activate on close
1120
1121- Description: What to do after closing the current tab.
1122- Setting: `activate_on_close`
1123- Default: `history`
1124
1125**Options**
1126
11271.  Activate the tab that was open previously:
1128
1129```json
1130{
1131  "activate_on_close": "history"
1132}
1133```
1134
11352. Activate the right neighbour tab if present:
1136
1137```json
1138{
1139  "activate_on_close": "neighbour"
1140}
1141```
1142
11433. Activate the left neighbour tab if present:
1144
1145```json
1146{
1147  "activate_on_close": "left_neighbour"
1148}
1149```
1150
1151### Show close button
1152
1153- Description: Controls the appearance behavior of the tab's close button.
1154- Setting: `show_close_button`
1155- Default: `hover`
1156
1157**Options**
1158
11591.  Show it just upon hovering the tab:
1160
1161```json
1162{
1163  "show_close_button": "hover"
1164}
1165```
1166
11672. Show it persistently:
1168
1169```json
1170{
1171  "show_close_button": "always"
1172}
1173```
1174
11753. Never show it, even if hovering it:
1176
1177```json
1178{
1179  "show_close_button": "hidden"
1180}
1181```
1182
1183### Show Diagnostics
1184
1185- 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.
1186- Setting: `show_diagnostics`
1187- Default: `off`
1188
1189**Options**
1190
11911. Do not mark any files:
1192
1193```json
1194{
1195  "show_diagnostics": "off"
1196}
1197```
1198
11992. Only mark files with errors:
1200
1201```json
1202{
1203  "show_diagnostics": "errors"
1204}
1205```
1206
12073. Mark files with errors and warnings:
1208
1209```json
1210{
1211  "show_diagnostics": "all"
1212}
1213```
1214
1215### Show Inline Code Actions
1216
1217- Description: Whether to show code action button at start of buffer line.
1218- Setting: `inline_code_actions`
1219- Default: `true`
1220
1221**Options**
1222
1223`boolean` values
1224
1225### Drag And Drop Selection
1226
1227- 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.
1228- Setting: `drag_and_drop_selection`
1229- Default:
1230
1231```json
1232"drag_and_drop_selection": {
1233  "enabled": true,
1234  "delay": 300
1235}
1236```
1237
1238## Editor Toolbar
1239
1240- Description: Whether or not to show various elements in the editor toolbar.
1241- Setting: `toolbar`
1242- Default:
1243
1244```json
1245"toolbar": {
1246  "breadcrumbs": true,
1247  "quick_actions": true,
1248  "selections_menu": true,
1249  "agent_review": true,
1250  "code_actions": false
1251},
1252```
1253
1254**Options**
1255
1256Each option controls displaying of a particular toolbar element. If all elements are hidden, the editor toolbar is not displayed.
1257
1258## Enable Language Server
1259
1260- Description: Whether or not to use language servers to provide code intelligence.
1261- Setting: `enable_language_server`
1262- Default: `true`
1263
1264**Options**
1265
1266`boolean` values
1267
1268## Ensure Final Newline On Save
1269
1270- Description: Removes any lines containing only whitespace at the end of the file and ensures just one newline at the end.
1271- Setting: `ensure_final_newline_on_save`
1272- Default: `true`
1273
1274**Options**
1275
1276`boolean` values
1277
1278## LSP
1279
1280- Description: Configuration for language servers.
1281- Setting: `lsp`
1282- Default: `null`
1283
1284**Options**
1285
1286The following settings can be overridden for specific language servers:
1287
1288- `initialization_options`
1289- `settings`
1290
1291To override configuration for a language server, add an entry for that language server's name to the `lsp` value.
1292
1293Some 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.
1294
1295For example to pass the `check` option to `rust-analyzer`, use the following configuration:
1296
1297```json
1298"lsp": {
1299  "rust-analyzer": {
1300    "initialization_options": {
1301      "check": {
1302        "command": "clippy" // rust-analyzer.check.command (default: "check")
1303      }
1304    }
1305  }
1306}
1307```
1308
1309While other options may be changed at a runtime and should be placed under `settings`:
1310
1311```json
1312"lsp": {
1313  "yaml-language-server": {
1314    "settings": {
1315      "yaml": {
1316        "keyOrdering": true // Enforces alphabetical ordering of keys in maps
1317      }
1318    }
1319  }
1320}
1321```
1322
1323## LSP Highlight Debounce
1324
1325- Description: The debounce delay in milliseconds before querying highlights from the language server based on the current cursor location.
1326- Setting: `lsp_highlight_debounce`
1327- Default: `75`
1328
1329**Options**
1330
1331`integer` values representing milliseconds
1332
1333## Format On Save
1334
1335- Description: Whether or not to perform a buffer format before saving.
1336- Setting: `format_on_save`
1337- Default: `on`
1338
1339**Options**
1340
13411. `on`, enables format on save obeying `formatter` setting:
1342
1343```json
1344{
1345  "format_on_save": "on"
1346}
1347```
1348
13492. `off`, disables format on save:
1350
1351```json
1352{
1353  "format_on_save": "off"
1354}
1355```
1356
1357## Formatter
1358
1359- Description: How to perform a buffer format.
1360- Setting: `formatter`
1361- Default: `auto`
1362
1363**Options**
1364
13651. To use the current language server, use `"language_server"`:
1366
1367```json
1368{
1369  "formatter": "language_server"
1370}
1371```
1372
13732. 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):
1374
1375```json
1376{
1377  "formatter": {
1378    "external": {
1379      "command": "sed",
1380      "arguments": ["-e", "s/ *$//"]
1381    }
1382  }
1383}
1384```
1385
13863. 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.
1387
1388WARNING: `{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.
1389
1390```json
1391  "formatter": {
1392    "external": {
1393      "command": "prettier",
1394      "arguments": ["--stdin-filepath", "{buffer_path}"]
1395    }
1396  }
1397```
1398
13994. Or to use code actions provided by the connected language servers, use `"code_actions"`:
1400
1401```json
1402{
1403  "formatter": {
1404    "code_actions": {
1405      // Use ESLint's --fix:
1406      "source.fixAll.eslint": true,
1407      // Organize imports on save:
1408      "source.organizeImports": true
1409    }
1410  }
1411}
1412```
1413
14145. Or to use multiple formatters consecutively, use an array of formatters:
1415
1416```json
1417{
1418  "formatter": [
1419    { "language_server": { "name": "rust-analyzer" } },
1420    {
1421      "external": {
1422        "command": "sed",
1423        "arguments": ["-e", "s/ *$//"]
1424      }
1425    }
1426  ]
1427}
1428```
1429
1430Here `rust-analyzer` will be used first to format the code, followed by a call of sed.
1431If any of the formatters fails, the subsequent ones will still be executed.
1432
1433## Code Actions On Format
1434
1435- Description: The code actions to perform with the primary language server when formatting the buffer.
1436- Setting: `code_actions_on_format`
1437- Default: `{}`, except for Go it's `{ "source.organizeImports": true }`
1438
1439**Examples**
1440
1441<!--
1442TBD: Add Python Ruff source.organizeImports example
1443-->
1444
14451. Organize imports on format in TypeScript and TSX buffers:
1446
1447```json
1448{
1449  "languages": {
1450    "TypeScript": {
1451      "code_actions_on_format": {
1452        "source.organizeImports": true
1453      }
1454    },
1455    "TSX": {
1456      "code_actions_on_format": {
1457        "source.organizeImports": true
1458      }
1459    }
1460  }
1461}
1462```
1463
14642. Run ESLint `fixAll` code action when formatting:
1465
1466```json
1467{
1468  "languages": {
1469    "JavaScript": {
1470      "code_actions_on_format": {
1471        "source.fixAll.eslint": true
1472      }
1473    }
1474  }
1475}
1476```
1477
14783. Run only a single ESLint rule when using `fixAll`:
1479
1480```json
1481{
1482  "languages": {
1483    "JavaScript": {
1484      "code_actions_on_format": {
1485        "source.fixAll.eslint": true
1486      }
1487    }
1488  },
1489  "lsp": {
1490    "eslint": {
1491      "settings": {
1492        "codeActionOnSave": {
1493          "rules": ["import/order"]
1494        }
1495      }
1496    }
1497  }
1498}
1499```
1500
1501## Auto close
1502
1503- Description: Whether to automatically add matching closing characters when typing opening parenthesis, bracket, brace, single or double quote characters.
1504- Setting: `use_autoclose`
1505- Default: `true`
1506
1507**Options**
1508
1509`boolean` values
1510
1511## Always Treat Brackets As Autoclosed
1512
1513- Description: Controls how the editor handles the autoclosed characters.
1514- Setting: `always_treat_brackets_as_autoclosed`
1515- Default: `false`
1516
1517**Options**
1518
1519`boolean` values
1520
1521**Example**
1522
1523If the setting is set to `true`:
1524
15251. Enter in the editor: `)))`
15262. Move the cursor to the start: `^)))`
15273. Enter again: `)))`
1528
1529The result is still `)))` and not `))))))`, which is what it would be by default.
1530
1531## File Scan Exclusions
1532
1533- Setting: `file_scan_exclusions`
1534- 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`.
1535- Default:
1536
1537```json
1538"file_scan_exclusions": [
1539  "**/.git",
1540  "**/.svn",
1541  "**/.hg",
1542  "**/.jj",
1543  "**/CVS",
1544  "**/.DS_Store",
1545  "**/Thumbs.db",
1546  "**/.classpath",
1547  "**/.settings"
1548],
1549```
1550
1551Note, 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.
1552
1553## File Scan Inclusions
1554
1555- Setting: `file_scan_inclusions`
1556- 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.
1557- Default:
1558
1559```json
1560"file_scan_inclusions": [".env*"],
1561```
1562
1563## File Types
1564
1565- Setting: `file_types`
1566- Description: Configure how Zed selects a language for a file based on its filename or extension. Supports glob entries.
1567- Default:
1568
1569```json
1570"file_types": {
1571  "JSONC": ["**/.zed/**/*.json", "**/zed/**/*.json", "**/Zed/**/*.json", "**/.vscode/**/*.json"],
1572  "Shell Script": [".env.*"]
1573}
1574```
1575
1576**Examples**
1577
1578To interpret all `.c` files as C++, files called `MyLockFile` as TOML and files starting with `Dockerfile` as Dockerfile:
1579
1580```json
1581{
1582  "file_types": {
1583    "C++": ["c"],
1584    "TOML": ["MyLockFile"],
1585    "Dockerfile": ["Dockerfile*"]
1586  }
1587}
1588```
1589
1590## Diagnostics
1591
1592- Description: Configuration for diagnostics-related features.
1593- Setting: `diagnostics`
1594- Default:
1595
1596```json
1597{
1598  "diagnostics": {
1599    "include_warnings": true,
1600    "inline": {
1601      "enabled": false
1602    },
1603    "update_with_cursor": false,
1604    "primary_only": false,
1605    "use_rendered": false
1606  }
1607}
1608```
1609
1610### Inline Diagnostics
1611
1612- Description: Whether or not to show diagnostics information inline.
1613- Setting: `inline`
1614- Default:
1615
1616```json
1617{
1618  "diagnostics": {
1619    "inline": {
1620      "enabled": false,
1621      "update_debounce_ms": 150,
1622      "padding": 4,
1623      "min_column": 0,
1624      "max_severity": null
1625    }
1626  }
1627}
1628```
1629
1630**Options**
1631
16321. Enable inline diagnostics.
1633
1634```json
1635{
1636  "diagnostics": {
1637    "inline": {
1638      "enabled": true
1639    }
1640  }
1641}
1642```
1643
16442. Delay diagnostic updates until some time after the last diagnostic update.
1645
1646```json
1647{
1648  "diagnostics": {
1649    "inline": {
1650      "enabled": true,
1651      "update_debounce_ms": 150
1652    }
1653  }
1654}
1655```
1656
16573. Set padding between the end of the source line and the start of the diagnostic.
1658
1659```json
1660{
1661  "diagnostics": {
1662    "inline": {
1663      "enabled": true,
1664      "padding": 4
1665    }
1666  }
1667}
1668```
1669
16704. Horizontally align inline diagnostics at the given column.
1671
1672```json
1673{
1674  "diagnostics": {
1675    "inline": {
1676      "enabled": true,
1677      "min_column": 80
1678    }
1679  }
1680}
1681```
1682
16835. Show only warning and error diagnostics.
1684
1685```json
1686{
1687  "diagnostics": {
1688    "inline": {
1689      "enabled": true,
1690      "max_severity": "warning"
1691    }
1692  }
1693}
1694```
1695
1696## Git
1697
1698- Description: Configuration for git-related features.
1699- Setting: `git`
1700- Default:
1701
1702```json
1703{
1704  "git": {
1705    "git_gutter": "tracked_files",
1706    "inline_blame": {
1707      "enabled": true
1708    },
1709    "hunk_style": "staged_hollow"
1710  }
1711}
1712```
1713
1714### Git Gutter
1715
1716- Description: Whether or not to show the git gutter.
1717- Setting: `git_gutter`
1718- Default: `tracked_files`
1719
1720**Options**
1721
17221. Show git gutter in tracked files
1723
1724```json
1725{
1726  "git": {
1727    "git_gutter": "tracked_files"
1728  }
1729}
1730```
1731
17322. Hide git gutter
1733
1734```json
1735{
1736  "git": {
1737    "git_gutter": "hide"
1738  }
1739}
1740```
1741
1742### Gutter Debounce
1743
1744- Description: Sets the debounce threshold (in milliseconds) after which changes are reflected in the git gutter.
1745- Setting: `gutter_debounce`
1746- Default: `null`
1747
1748**Options**
1749
1750`integer` values representing milliseconds
1751
1752Example:
1753
1754```json
1755{
1756  "git": {
1757    "gutter_debounce": 100
1758  }
1759}
1760```
1761
1762### Inline Git Blame
1763
1764- Description: Whether or not to show git blame information inline, on the currently focused line.
1765- Setting: `inline_blame`
1766- Default:
1767
1768```json
1769{
1770  "git": {
1771    "inline_blame": {
1772      "enabled": true
1773    }
1774  }
1775}
1776```
1777
1778**Options**
1779
17801. Disable inline git blame:
1781
1782```json
1783{
1784  "git": {
1785    "inline_blame": {
1786      "enabled": false
1787    }
1788  }
1789}
1790```
1791
17922. Only show inline git blame after a delay (that starts after cursor stops moving):
1793
1794```json
1795{
1796  "git": {
1797    "inline_blame": {
1798      "enabled": true,
1799      "delay_ms": 500
1800    }
1801  }
1802}
1803```
1804
18053. Show a commit summary next to the commit date and author:
1806
1807```json
1808{
1809  "git": {
1810    "inline_blame": {
1811      "enabled": true,
1812      "show_commit_summary": true
1813    }
1814  }
1815}
1816```
1817
18184. Use this as the minimum column at which to display inline blame information:
1819
1820```json
1821{
1822  "git": {
1823    "inline_blame": {
1824      "enabled": true,
1825      "min_column": 80
1826    }
1827  }
1828}
1829```
1830
1831### Hunk Style
1832
1833- Description: What styling we should use for the diff hunks.
1834- Setting: `hunk_style`
1835- Default:
1836
1837```json
1838{
1839  "git": {
1840    "hunk_style": "staged_hollow"
1841  }
1842}
1843```
1844
1845**Options**
1846
18471. Show the staged hunks faded out and with a border:
1848
1849```json
1850{
1851  "git": {
1852    "hunk_style": "staged_hollow"
1853  }
1854}
1855```
1856
18572. Show unstaged hunks faded out and with a border:
1858
1859```json
1860{
1861  "git": {
1862    "hunk_style": "unstaged_hollow"
1863  }
1864}
1865```
1866
1867## Indent Guides
1868
1869- Description: Configuration related to indent guides. Indent guides can be configured separately for each language.
1870- Setting: `indent_guides`
1871- Default:
1872
1873```json
1874{
1875  "indent_guides": {
1876    "enabled": true,
1877    "line_width": 1,
1878    "active_line_width": 1,
1879    "coloring": "fixed",
1880    "background_coloring": "disabled"
1881  }
1882}
1883```
1884
1885**Options**
1886
18871. Disable indent guides
1888
1889```json
1890{
1891  "indent_guides": {
1892    "enabled": false
1893  }
1894}
1895```
1896
18972. Enable indent guides for a specific language.
1898
1899```json
1900{
1901  "languages": {
1902    "Python": {
1903      "indent_guides": {
1904        "enabled": true
1905      }
1906    }
1907  }
1908}
1909```
1910
19113. Enable indent aware coloring ("rainbow indentation").
1912   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.
1913
1914```json
1915{
1916  "indent_guides": {
1917    "enabled": true,
1918    "coloring": "indent_aware"
1919  }
1920}
1921```
1922
19234. Enable indent aware background coloring ("rainbow indentation").
1924   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.
1925
1926```json
1927{
1928  "indent_guides": {
1929    "enabled": true,
1930    "coloring": "indent_aware",
1931    "background_coloring": "indent_aware"
1932  }
1933}
1934```
1935
1936## Hard Tabs
1937
1938- Description: Whether to indent lines using tab characters or multiple spaces.
1939- Setting: `hard_tabs`
1940- Default: `false`
1941
1942**Options**
1943
1944`boolean` values
1945
1946## Multi Cursor Modifier
1947
1948- 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.
1949- Setting: `multi_cursor_modifier`
1950- Default: `alt`
1951
1952**Options**
1953
19541. Maps to `Alt` on Linux and Windows and to `Option` on MacOS:
1955
1956```json
1957{
1958  "multi_cursor_modifier": "alt"
1959}
1960```
1961
19622. Maps `Control` on Linux and Windows and to `Command` on MacOS:
1963
1964```json
1965{
1966  "multi_cursor_modifier": "cmd_or_ctrl" // alias: "cmd", "ctrl"
1967}
1968```
1969
1970## Hover Popover Enabled
1971
1972- Description: Whether or not to show the informational hover box when moving the mouse over symbols in the editor.
1973- Setting: `hover_popover_enabled`
1974- Default: `true`
1975
1976**Options**
1977
1978`boolean` values
1979
1980## Hover Popover Delay
1981
1982- Description: Time to wait in milliseconds before showing the informational hover box.
1983- Setting: `hover_popover_delay`
1984- Default: `300`
1985
1986**Options**
1987
1988`integer` values representing milliseconds
1989
1990## Icon Theme
1991
1992- 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.
1993- Setting: `icon_theme`
1994- Default: `Zed (Default)`
1995
1996### Icon Theme Object
1997
1998- Description: Specify the icon theme using an object that includes the `mode`, `dark`, and `light`.
1999- Setting: `icon_theme`
2000- Default:
2001
2002```json
2003"icon_theme": {
2004  "mode": "system",
2005  "dark": "Zed (Default)",
2006  "light": "Zed (Default)"
2007},
2008```
2009
2010### Mode
2011
2012- Description: Specify the icon theme mode.
2013- Setting: `mode`
2014- Default: `system`
2015
2016**Options**
2017
20181. Set the icon theme to dark mode
2019
2020```json
2021{
2022  "mode": "dark"
2023}
2024```
2025
20262. Set the icon theme to light mode
2027
2028```json
2029{
2030  "mode": "light"
2031}
2032```
2033
20343. Set the icon theme to system mode
2035
2036```json
2037{
2038  "mode": "system"
2039}
2040```
2041
2042### Dark
2043
2044- Description: The name of the dark icon theme.
2045- Setting: `dark`
2046- Default: `Zed (Default)`
2047
2048**Options**
2049
2050Run the `icon theme selector: toggle` action in the command palette to see a current list of valid icon themes names.
2051
2052### Light
2053
2054- Description: The name of the light icon theme.
2055- Setting: `light`
2056- Default: `Zed (Default)`
2057
2058**Options**
2059
2060Run the `icon theme selector: toggle` action in the command palette to see a current list of valid icon themes names.
2061
2062## Inlay hints
2063
2064- Description: Configuration for displaying extra text with hints in the editor.
2065- Setting: `inlay_hints`
2066- Default:
2067
2068```json
2069"inlay_hints": {
2070  "enabled": false,
2071  "show_type_hints": true,
2072  "show_parameter_hints": true,
2073  "show_other_hints": true,
2074  "show_background": false,
2075  "edit_debounce_ms": 700,
2076  "scroll_debounce_ms": 50,
2077  "toggle_on_modifiers_press": null
2078}
2079```
2080
2081**Options**
2082
2083Inlay hints querying consists of two parts: editor (client) and LSP server.
2084With 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.
2085At 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.
2086
2087The following languages have inlay hints preconfigured by Zed:
2088
2089- [Go](https://docs.zed.dev/languages/go)
2090- [Rust](https://docs.zed.dev/languages/rust)
2091- [Svelte](https://docs.zed.dev/languages/svelte)
2092- [Typescript](https://docs.zed.dev/languages/typescript)
2093
2094Use the `lsp` section for the server configuration. Examples are provided in the corresponding language documentation.
2095
2096Hints are not instantly queried in Zed, two kinds of debounces are used, either may be set to 0 to be disabled.
2097Settings-related hint updates are not debounced.
2098
2099All possible config values for `toggle_on_modifiers_press` are:
2100
2101```json
2102"inlay_hints": {
2103  "toggle_on_modifiers_press": {
2104    "control": true,
2105    "shift": true,
2106    "alt": true,
2107    "platform": true,
2108    "function": true
2109  }
2110}
2111```
2112
2113Unspecified values have a `false` value, hints won't be toggled if all the modifiers are `false` or not all the modifiers are pressed.
2114
2115## Journal
2116
2117- Description: Configuration for the journal.
2118- Setting: `journal`
2119- Default:
2120
2121```json
2122"journal": {
2123  "path": "~",
2124  "hour_format": "hour12"
2125}
2126```
2127
2128### Path
2129
2130- Description: The path of the directory where journal entries are stored.
2131- Setting: `path`
2132- Default: `~`
2133
2134**Options**
2135
2136`string` values
2137
2138### Hour Format
2139
2140- Description: The format to use for displaying hours in the journal.
2141- Setting: `hour_format`
2142- Default: `hour12`
2143
2144**Options**
2145
21461. 12-hour format:
2147
2148```json
2149{
2150  "hour_format": "hour12"
2151}
2152```
2153
21542. 24-hour format:
2155
2156```json
2157{
2158  "hour_format": "hour24"
2159}
2160```
2161
2162## Languages
2163
2164- Description: Configuration for specific languages.
2165- Setting: `languages`
2166- Default: `null`
2167
2168**Options**
2169
2170To override settings for a language, add an entry for that languages name to the `languages` value. Example:
2171
2172```json
2173"languages": {
2174  "C": {
2175    "format_on_save": "off",
2176    "preferred_line_length": 64,
2177    "soft_wrap": "preferred_line_length"
2178  },
2179  "JSON": {
2180    "tab_size": 4
2181  }
2182}
2183```
2184
2185The following settings can be overridden for each specific language:
2186
2187- [`enable_language_server`](#enable-language-server)
2188- [`ensure_final_newline_on_save`](#ensure-final-newline-on-save)
2189- [`format_on_save`](#format-on-save)
2190- [`formatter`](#formatter)
2191- [`hard_tabs`](#hard-tabs)
2192- [`preferred_line_length`](#preferred-line-length)
2193- [`remove_trailing_whitespace_on_save`](#remove-trailing-whitespace-on-save)
2194- [`show_edit_predictions`](#show-edit-predictions)
2195- [`show_whitespaces`](#show-whitespaces)
2196- [`soft_wrap`](#soft-wrap)
2197- [`tab_size`](#tab-size)
2198- [`use_autoclose`](#use-autoclose)
2199- [`always_treat_brackets_as_autoclosed`](#always-treat-brackets-as-autoclosed)
2200
2201These values take in the same options as the root-level settings with the same name.
2202
2203## Network Proxy
2204
2205- Description: Configure a network proxy for Zed.
2206- Setting: `proxy`
2207- Default: `null`
2208
2209**Options**
2210
2211The proxy setting must contain a URL to the proxy.
2212
2213The following URI schemes are supported:
2214
2215- `http`
2216- `https`
2217- `socks4` - SOCKS4 proxy with local DNS
2218- `socks4a` - SOCKS4 proxy with remote DNS
2219- `socks5` - SOCKS5 proxy with local DNS
2220- `socks5h` - SOCKS5 proxy with remote DNS
2221
2222`http` will be used when no scheme is specified.
2223
2224By 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`.
2225
2226For example, to set an `http` proxy, add the following to your settings:
2227
2228```json
2229{
2230  "proxy": "http://127.0.0.1:10809"
2231}
2232```
2233
2234Or to set a `socks5` proxy:
2235
2236```json
2237{
2238  "proxy": "socks5h://localhost:10808"
2239}
2240```
2241
2242If 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.
2243
2244## Preview tabs
2245
2246- Description:
2247  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. \
2248   There are several ways to convert a preview tab into a regular tab:
2249
2250  - Double-clicking on the file
2251  - Double-clicking on the tab header
2252  - Using the `project_panel::OpenPermanent` action
2253  - Editing the file
2254  - Dragging the file to a different pane
2255
2256- Setting: `preview_tabs`
2257- Default:
2258
2259```json
2260"preview_tabs": {
2261  "enabled": true,
2262  "enable_preview_from_file_finder": false,
2263  "enable_preview_from_code_navigation": false,
2264}
2265```
2266
2267### Enable preview from file finder
2268
2269- Description: Determines whether to open files in preview mode when selected from the file finder.
2270- Setting: `enable_preview_from_file_finder`
2271- Default: `false`
2272
2273**Options**
2274
2275`boolean` values
2276
2277### Enable preview from code navigation
2278
2279- Description: Determines whether a preview tab gets replaced when code navigation is used to navigate away from the tab.
2280- Setting: `enable_preview_from_code_navigation`
2281- Default: `false`
2282
2283**Options**
2284
2285`boolean` values
2286
2287## File Finder
2288
2289### File Icons
2290
2291- Description: Whether to show file icons in the file finder.
2292- Setting: `file_icons`
2293- Default: `true`
2294
2295### Modal Max Width
2296
2297- Description: Max-width of the file finder modal. It can take one of these values: `small`, `medium`, `large`, `xlarge`, and `full`.
2298- Setting: `modal_max_width`
2299- Default: `small`
2300
2301### Skip Focus For Active In Search
2302
2303- Description: Determines whether the file finder should skip focus for the active file in search results.
2304- Setting: `skip_focus_for_active_in_search`
2305- Default: `true`
2306
2307## Preferred Line Length
2308
2309- Description: The column at which to soft-wrap lines, for buffers where soft-wrap is enabled.
2310- Setting: `preferred_line_length`
2311- Default: `80`
2312
2313**Options**
2314
2315`integer` values
2316
2317## Projects Online By Default
2318
2319- Description: Whether or not to show the online projects view by default.
2320- Setting: `projects_online_by_default`
2321- Default: `true`
2322
2323**Options**
2324
2325`boolean` values
2326
2327## Remove Trailing Whitespace On Save
2328
2329- Description: Whether or not to remove any trailing whitespace from lines of a buffer before saving it.
2330- Setting: `remove_trailing_whitespace_on_save`
2331- Default: `true`
2332
2333**Options**
2334
2335`boolean` values
2336
2337## Search
2338
2339- Description: Search options to enable by default when opening new project and buffer searches.
2340- Setting: `search`
2341- Default:
2342
2343```json
2344"search": {
2345  "whole_word": false,
2346  "case_sensitive": false,
2347  "include_ignored": false,
2348  "regex": false
2349},
2350```
2351
2352## Seed Search Query From Cursor
2353
2354- Description: When to populate a new search's query based on the text under the cursor.
2355- Setting: `seed_search_query_from_cursor`
2356- Default: `always`
2357
2358**Options**
2359
23601. `always` always populate the search query with the word under the cursor
23612. `selection` only populate the search query when there is text selected
23623. `never` never populate the search query
2363
2364## Use Smartcase Search
2365
2366- 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. \
2367  This applies to both in-file searches and project-wide searches.
2368- Setting: `use_smartcase_search`
2369- Default: `false`
2370
2371**Options**
2372
2373`boolean` values
2374
2375Examples:
2376
2377- Searching for "function" would match "function", "Function", "FUNCTION", etc.
2378- Searching for "Function" would only match "Function", not "function" or "FUNCTION"
2379
2380## Show Call Status Icon
2381
2382- Description: Whether or not to show the call status icon in the status bar.
2383- Setting: `show_call_status_icon`
2384- Default: `true`
2385
2386**Options**
2387
2388`boolean` values
2389
2390## Completions
2391
2392- Description: Controls how completions are processed for this language.
2393- Setting: `completions`
2394- Default:
2395
2396```json
2397{
2398  "completions": {
2399    "words": "fallback",
2400    "lsp": true,
2401    "lsp_fetch_timeout_ms": 0,
2402    "lsp_insert_mode": "replace_suffix"
2403  }
2404}
2405```
2406
2407### Words
2408
2409- Description: Controls how words are completed. For large documents, not all words may be fetched for completion.
2410- Setting: `words`
2411- Default: `fallback`
2412
2413**Options**
2414
24151. `enabled` - Always fetch document's words for completions along with LSP completions
24162. `fallback` - Only if LSP response errors or times out, use document's words to show completions
24173. `disabled` - Never fetch or complete document's words for completions (word-based completions can still be queried via a separate action)
2418
2419### LSP
2420
2421- Description: Whether to fetch LSP completions or not.
2422- Setting: `lsp`
2423- Default: `true`
2424
2425**Options**
2426
2427`boolean` values
2428
2429### LSP Fetch Timeout (ms)
2430
2431- Description: When fetching LSP completions, determines how long to wait for a response of a particular server. When set to 0, waits indefinitely.
2432- Setting: `lsp_fetch_timeout_ms`
2433- Default: `0`
2434
2435**Options**
2436
2437`integer` values representing milliseconds
2438
2439### LSP Insert Mode
2440
2441- Description: Controls what range to replace when accepting LSP completions.
2442- Setting: `lsp_insert_mode`
2443- Default: `replace_suffix`
2444
2445**Options**
2446
24471. `insert` - Replaces text before the cursor, using the `insert` range described in the LSP specification
24482. `replace` - Replaces text before and after the cursor, using the `replace` range described in the LSP specification
24493. `replace_subsequence` - Behaves like `"replace"` if the text that would be replaced is a subsequence of the completion text, and like `"insert"` otherwise
24504. `replace_suffix` - Behaves like `"replace"` if the text after the cursor is a suffix of the completion, and like `"insert"` otherwise
2451
2452## Show Completions On Input
2453
2454- Description: Whether or not to show completions as you type.
2455- Setting: `show_completions_on_input`
2456- Default: `true`
2457
2458**Options**
2459
2460`boolean` values
2461
2462## Show Completion Documentation
2463
2464- Description: Whether to display inline and alongside documentation for items in the completions menu.
2465- Setting: `show_completion_documentation`
2466- Default: `true`
2467
2468**Options**
2469
2470`boolean` values
2471
2472## Show Edit Predictions
2473
2474- Description: Whether to show edit predictions as you type or manually by triggering `editor::ShowEditPrediction`.
2475- Setting: `show_edit_predictions`
2476- Default: `true`
2477
2478**Options**
2479
2480`boolean` values
2481
2482## Show Whitespaces
2483
2484- Description: Whether or not to render whitespace characters in the editor.
2485- Setting: `show_whitespaces`
2486- Default: `selection`
2487
2488**Options**
2489
24901. `all`
24912. `selection`
24923. `none`
24934. `boundary`
2494
2495## Soft Wrap
2496
2497- Description: Whether or not to automatically wrap lines of text to fit editor / preferred width.
2498- Setting: `soft_wrap`
2499- Default: `none`
2500
2501**Options**
2502
25031. `none` to avoid wrapping generally, unless the line is too long
25042. `prefer_line` (deprecated, same as `none`)
25053. `editor_width` to wrap lines that overflow the editor width
25064. `preferred_line_length` to wrap lines that overflow `preferred_line_length` config value
25075. `bounded` to wrap lines at the minimum of `editor_width` and `preferred_line_length`
2508
2509## Wrap Guides (Vertical Rulers)
2510
2511- Description: Where to display vertical rulers as wrap-guides. Disable by setting `show_wrap_guides` to `false`.
2512- Setting: `wrap_guides`
2513- Default: []
2514
2515**Options**
2516
2517List of `integer` column numbers
2518
2519## Tab Size
2520
2521- Description: The number of spaces to use for each tab character.
2522- Setting: `tab_size`
2523- Default: `4`
2524
2525**Options**
2526
2527`integer` values
2528
2529## Telemetry
2530
2531- Description: Control what info is collected by Zed.
2532- Setting: `telemetry`
2533- Default:
2534
2535```json
2536"telemetry": {
2537  "diagnostics": true,
2538  "metrics": true
2539},
2540```
2541
2542**Options**
2543
2544### Diagnostics
2545
2546- Description: Setting for sending debug-related data, such as crash reports.
2547- Setting: `diagnostics`
2548- Default: `true`
2549
2550**Options**
2551
2552`boolean` values
2553
2554### Metrics
2555
2556- Description: Setting for sending anonymized usage data, such what languages you're using Zed with.
2557- Setting: `metrics`
2558- Default: `true`
2559
2560**Options**
2561
2562`boolean` values
2563
2564## Terminal
2565
2566- Description: Configuration for the terminal.
2567- Setting: `terminal`
2568- Default:
2569
2570```json
2571{
2572  "terminal": {
2573    "alternate_scroll": "off",
2574    "blinking": "terminal_controlled",
2575    "copy_on_select": false,
2576    "keep_selection_on_copy": false,
2577    "dock": "bottom",
2578    "default_width": 640,
2579    "default_height": 320,
2580    "detect_venv": {
2581      "on": {
2582        "directories": [".env", "env", ".venv", "venv"],
2583        "activate_script": "default"
2584      }
2585    },
2586    "env": {},
2587    "font_family": null,
2588    "font_features": null,
2589    "font_size": null,
2590    "line_height": "comfortable",
2591    "option_as_meta": false,
2592    "button": true,
2593    "shell": "system",
2594    "toolbar": {
2595      "breadcrumbs": true
2596    },
2597    "working_directory": "current_project_directory",
2598    "scrollbar": {
2599      "show": null
2600    }
2601  }
2602}
2603```
2604
2605### Terminal: Dock
2606
2607- Description: Control the position of the dock
2608- Setting: `dock`
2609- Default: `bottom`
2610
2611**Options**
2612
2613`"bottom"`, `"left"` or `"right"`
2614
2615### Terminal: Alternate Scroll
2616
2617- 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.
2618- Setting: `alternate_scroll`
2619- Default: `off`
2620
2621**Options**
2622
26231. Default alternate scroll mode to off
2624
2625```json
2626{
2627  "terminal": {
2628    "alternate_scroll": "off"
2629  }
2630}
2631```
2632
26332. Default alternate scroll mode to on
2634
2635```json
2636{
2637  "terminal": {
2638    "alternate_scroll": "on"
2639  }
2640}
2641```
2642
2643### Terminal: Blinking
2644
2645- Description: Set the cursor blinking behavior in the terminal
2646- Setting: `blinking`
2647- Default: `terminal_controlled`
2648
2649**Options**
2650
26511. Never blink the cursor, ignore the terminal mode
2652
2653```json
2654{
2655  "terminal": {
2656    "blinking": "off"
2657  }
2658}
2659```
2660
26612. Default the cursor blink to off, but allow the terminal to turn blinking on
2662
2663```json
2664{
2665  "terminal": {
2666    "blinking": "terminal_controlled"
2667  }
2668}
2669```
2670
26713. Always blink the cursor, ignore the terminal mode
2672
2673```json
2674{
2675  "terminal": {
2676    "blinking": "on"
2677  }
2678}
2679```
2680
2681### Terminal: Copy On Select
2682
2683- Description: Whether or not selecting text in the terminal will automatically copy to the system clipboard.
2684- Setting: `copy_on_select`
2685- Default: `false`
2686
2687**Options**
2688
2689`boolean` values
2690
2691**Example**
2692
2693```json
2694{
2695  "terminal": {
2696    "copy_on_select": true
2697  }
2698}
2699```
2700
2701### Terminal: Cursor Shape
2702
2703- Description: Whether or not selecting text in the terminal will automatically copy to the system clipboard.
2704- Setting: `cursor_shape`
2705- Default: `null` (defaults to block)
2706
2707**Options**
2708
27091. A block that surrounds the following character
2710
2711```json
2712{
2713  "terminal": {
2714    "cursor_shape": "block"
2715  }
2716}
2717```
2718
27192. A vertical bar
2720
2721```json
2722{
2723  "terminal": {
2724    "cursor_shape": "bar"
2725  }
2726}
2727```
2728
27293. An underline / underscore that runs along the following character
2730
2731```json
2732{
2733  "terminal": {
2734    "cursor_shape": "underline"
2735  }
2736}
2737```
2738
27394. A box drawn around the following character
2740
2741```json
2742{
2743  "terminal": {
2744    "cursor_shape": "hollow"
2745  }
2746}
2747```
2748
2749### Terminal: Keep Selection On Copy
2750
2751- Description: Whether or not to keep the selection in the terminal after copying text.
2752- Setting: `keep_selection_on_copy`
2753- Default: `false`
2754
2755**Options**
2756
2757`boolean` values
2758
2759**Example**
2760
2761```json
2762{
2763  "terminal": {
2764    "keep_selection_on_copy": true
2765  }
2766}
2767```
2768
2769### Terminal: Env
2770
2771- 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
2772- Setting: `env`
2773- Default: `{}`
2774
2775**Example**
2776
2777```json
2778{
2779  "terminal": {
2780    "env": {
2781      "ZED": "1",
2782      "KEY": "value1:value2"
2783    }
2784  }
2785}
2786```
2787
2788### Terminal: Font Size
2789
2790- Description: What font size to use for the terminal. When not set defaults to matching the editor's font size
2791- Setting: `font_size`
2792- Default: `null`
2793
2794**Options**
2795
2796`integer` values
2797
2798```json
2799{
2800  "terminal": {
2801    "font_size": 15
2802  }
2803}
2804```
2805
2806### Terminal: Font Family
2807
2808- Description: What font to use for the terminal. When not set, defaults to matching the editor's font.
2809- Setting: `font_family`
2810- Default: `null`
2811
2812**Options**
2813
2814The name of any font family installed on the user's system
2815
2816```json
2817{
2818  "terminal": {
2819    "font_family": "Berkeley Mono"
2820  }
2821}
2822```
2823
2824### Terminal: Font Features
2825
2826- Description: What font features to use for the terminal. When not set, defaults to matching the editor's font features.
2827- Setting: `font_features`
2828- Default: `null`
2829- Platform: macOS and Windows.
2830
2831**Options**
2832
2833See Buffer Font Features
2834
2835```json
2836{
2837  "terminal": {
2838    "font_features": {
2839      "calt": false
2840      // See Buffer Font Features for more features
2841    }
2842  }
2843}
2844```
2845
2846### Terminal: Line Height
2847
2848- Description: Set the terminal's line height.
2849- Setting: `line_height`
2850- Default: `comfortable`
2851
2852**Options**
2853
28541. Use a line height that's `comfortable` for reading, 1.618. (default)
2855
2856```json
2857{
2858  "terminal": {
2859    "line_height": "comfortable"
2860  }
2861}
2862```
2863
28642. Use a `standard` line height, 1.3. This option is useful for TUIs, particularly if they use box characters
2865
2866```json
2867{
2868  "terminal": {
2869    "line_height": "standard"
2870  }
2871}
2872```
2873
28743.  Use a custom line height.
2875
2876```json
2877{
2878  "terminal": {
2879    "line_height": {
2880      "custom": 2
2881    }
2882  }
2883}
2884```
2885
2886### Terminal: Option As Meta
2887
2888- Description: Re-interprets the option keys to act like a 'meta' key, like in Emacs.
2889- Setting: `option_as_meta`
2890- Default: `false`
2891
2892**Options**
2893
2894`boolean` values
2895
2896```json
2897{
2898  "terminal": {
2899    "option_as_meta": true
2900  }
2901}
2902```
2903
2904### Terminal: Shell
2905
2906- Description: What shell to use when launching the terminal.
2907- Setting: `shell`
2908- Default: `system`
2909
2910**Options**
2911
29121. Use the system's default terminal configuration (usually the `/etc/passwd` file).
2913
2914```json
2915{
2916  "terminal": {
2917    "shell": "system"
2918  }
2919}
2920```
2921
29222. A program to launch:
2923
2924```json
2925{
2926  "terminal": {
2927    "shell": {
2928      "program": "sh"
2929    }
2930  }
2931}
2932```
2933
29343. A program with arguments:
2935
2936```json
2937{
2938  "terminal": {
2939    "shell": {
2940      "with_arguments": {
2941        "program": "/bin/bash",
2942        "args": ["--login"]
2943      }
2944    }
2945  }
2946}
2947```
2948
2949## Terminal: Detect Virtual Environments {#terminal-detect_venv}
2950
2951- 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.
2952- Setting: `detect_venv`
2953- Default:
2954
2955```json
2956{
2957  "terminal": {
2958    "detect_venv": {
2959      "on": {
2960        // Default directories to search for virtual environments, relative
2961        // to the current working directory. We recommend overriding this
2962        // in your project's settings, rather than globally.
2963        "directories": [".env", "env", ".venv", "venv"],
2964        // Can also be `csh`, `fish`, and `nushell`
2965        "activate_script": "default"
2966      }
2967    }
2968  }
2969}
2970```
2971
2972Disable with:
2973
2974```json
2975{
2976  "terminal": {
2977    "detect_venv": "off"
2978  }
2979}
2980```
2981
2982## Terminal: Toolbar
2983
2984- Description: Whether or not to show various elements in the terminal toolbar.
2985- Setting: `toolbar`
2986- Default:
2987
2988```json
2989{
2990  "terminal": {
2991    "toolbar": {
2992      "breadcrumbs": true
2993    }
2994  }
2995}
2996```
2997
2998**Options**
2999
3000At the moment, only the `breadcrumbs` option is available, it controls displaying of the terminal title that can be changed via `PROMPT_COMMAND`.
3001
3002If the terminal title is empty, the breadcrumbs won't be shown.
3003
3004The shell running in the terminal needs to be configured to emit the title.
3005
3006Example command to set the title: `echo -e "\e]2;New Title\007";`
3007
3008### Terminal: Button
3009
3010- Description: Control to show or hide the terminal button in the status bar
3011- Setting: `button`
3012- Default: `true`
3013
3014**Options**
3015
3016`boolean` values
3017
3018```json
3019{
3020  "terminal": {
3021    "button": false
3022  }
3023}
3024```
3025
3026### Terminal: Working Directory
3027
3028- Description: What working directory to use when launching the terminal.
3029- Setting: `working_directory`
3030- Default: `"current_project_directory"`
3031
3032**Options**
3033
30341. Use the current file's project directory. Will Fallback to the first project directory strategy if unsuccessful
3035
3036```json
3037{
3038  "terminal": {
3039    "working_directory": "current_project_directory"
3040  }
3041}
3042```
3043
30442. Use the first project in this workspace's directory. Will fallback to using this platform's home directory.
3045
3046```json
3047{
3048  "terminal": {
3049    "working_directory": "first_project_directory"
3050  }
3051}
3052```
3053
30543. Always use this platform's home directory (if we can find it)
3055
3056```json
3057{
3058  "terminal": {
3059    "working_directory": "always_home"
3060  }
3061}
3062```
3063
30644. 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.
3065
3066```json
3067{
3068  "terminal": {
3069    "working_directory": {
3070      "always": {
3071        "directory": "~/zed/projects/"
3072      }
3073    }
3074  }
3075}
3076```
3077
3078## Theme
3079
3080- 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.
3081- Setting: `theme`
3082- Default: `One Dark`
3083
3084### Theme Object
3085
3086- Description: Specify the theme using an object that includes the `mode`, `dark`, and `light` themes.
3087- Setting: `theme`
3088- Default:
3089
3090```json
3091"theme": {
3092  "mode": "system",
3093  "dark": "One Dark",
3094  "light": "One Light"
3095},
3096```
3097
3098### Mode
3099
3100- Description: Specify theme mode.
3101- Setting: `mode`
3102- Default: `system`
3103
3104**Options**
3105
31061. Set the theme to dark mode
3107
3108```json
3109{
3110  "mode": "dark"
3111}
3112```
3113
31142. Set the theme to light mode
3115
3116```json
3117{
3118  "mode": "light"
3119}
3120```
3121
31223. Set the theme to system mode
3123
3124```json
3125{
3126  "mode": "system"
3127}
3128```
3129
3130### Dark
3131
3132- Description: The name of the dark Zed theme to use for the UI.
3133- Setting: `dark`
3134- Default: `One Dark`
3135
3136**Options**
3137
3138Run the `theme selector: toggle` action in the command palette to see a current list of valid themes names.
3139
3140### Light
3141
3142- Description: The name of the light Zed theme to use for the UI.
3143- Setting: `light`
3144- Default: `One Light`
3145
3146**Options**
3147
3148Run the `theme selector: toggle` action in the command palette to see a current list of valid themes names.
3149
3150## Vim
3151
3152- Description: Whether or not to enable vim mode (work in progress).
3153- Setting: `vim_mode`
3154- Default: `false`
3155
3156## Project Panel
3157
3158- Description: Customize project panel
3159- Setting: `project_panel`
3160- Default:
3161
3162```json
3163{
3164  "project_panel": {
3165    "button": true,
3166    "default_width": 240,
3167    "dock": "left",
3168    "entry_spacing": "comfortable",
3169    "file_icons": true,
3170    "folder_icons": true,
3171    "git_status": true,
3172    "indent_size": 20,
3173    "auto_reveal_entries": true,
3174    "auto_fold_dirs": true,
3175    "scrollbar": {
3176      "show": null
3177    },
3178    "show_diagnostics": "all",
3179    "indent_guides": {
3180      "show": "always"
3181    },
3182    "hide_root": false
3183  }
3184}
3185```
3186
3187### Dock
3188
3189- Description: Control the position of the dock
3190- Setting: `dock`
3191- Default: `left`
3192
3193**Options**
3194
31951. Default dock position to left
3196
3197```json
3198{
3199  "dock": "left"
3200}
3201```
3202
32032. Default dock position to right
3204
3205```json
3206{
3207  "dock": "right"
3208}
3209```
3210
3211### Entry Spacing
3212
3213- Description: Spacing between worktree entries
3214- Setting: `entry_spacing`
3215- Default: `comfortable`
3216
3217**Options**
3218
32191. Comfortable entry spacing
3220
3221```json
3222{
3223  "entry_spacing": "comfortable"
3224}
3225```
3226
32272. Standard entry spacing
3228
3229```json
3230{
3231  "entry_spacing": "standard"
3232}
3233```
3234
3235### Git Status
3236
3237- Description: Indicates newly created and updated files
3238- Setting: `git_status`
3239- Default: `true`
3240
3241**Options**
3242
32431. Default enable git status
3244
3245```json
3246{
3247  "git_status": true
3248}
3249```
3250
32512. Default disable git status
3252
3253```json
3254{
3255  "git_status": false
3256}
3257```
3258
3259### Default Width
3260
3261- Description: Customize default width taken by project panel
3262- Setting: `default_width`
3263- Default: `240`
3264
3265**Options**
3266
3267`float` values
3268
3269### Auto Reveal Entries
3270
3271- Description: Whether to reveal it in the project panel automatically, when a corresponding project entry becomes active. Gitignored entries are never auto revealed.
3272- Setting: `auto_reveal_entries`
3273- Default: `true`
3274
3275**Options**
3276
32771. Enable auto reveal entries
3278
3279```json
3280{
3281  "auto_reveal_entries": true
3282}
3283```
3284
32852. Disable auto reveal entries
3286
3287```json
3288{
3289  "auto_reveal_entries": false
3290}
3291```
3292
3293### Auto Fold Dirs
3294
3295- Description: Whether to fold directories automatically when directory has only one directory inside.
3296- Setting: `auto_fold_dirs`
3297- Default: `true`
3298
3299**Options**
3300
33011. Enable auto fold dirs
3302
3303```json
3304{
3305  "auto_fold_dirs": true
3306}
3307```
3308
33092. Disable auto fold dirs
3310
3311```json
3312{
3313  "auto_fold_dirs": false
3314}
3315```
3316
3317### Indent Size
3318
3319- Description: Amount of indentation (in pixels) for nested items.
3320- Setting: `indent_size`
3321- Default: `20`
3322
3323### Indent Guides: Show
3324
3325- Description: Whether to show indent guides in the project panel.
3326- Setting: `indent_guides`
3327- Default:
3328
3329```json
3330"indent_guides": {
3331  "show": "always"
3332}
3333```
3334
3335**Options**
3336
33371. Show indent guides in the project panel
3338
3339```json
3340{
3341  "indent_guides": {
3342    "show": "always"
3343  }
3344}
3345```
3346
33472. Hide indent guides in the project panel
3348
3349```json
3350{
3351  "indent_guides": {
3352    "show": "never"
3353  }
3354}
3355```
3356
3357### Scrollbar: Show
3358
3359- 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.
3360- Setting: `scrollbar`
3361- Default:
3362
3363```json
3364"scrollbar": {
3365  "show": null
3366}
3367```
3368
3369**Options**
3370
33711. Show scrollbar in the project panel
3372
3373```json
3374{
3375  "scrollbar": {
3376    "show": "always"
3377  }
3378}
3379```
3380
33812. Hide scrollbar in the project panel
3382
3383```json
3384{
3385  "scrollbar": {
3386    "show": "never"
3387  }
3388}
3389```
3390
3391## Agent
3392
3393Visit [the Configuration page](/ai/configuration.md) under the AI section to learn more about all the agent-related settings.
3394
3395## Outline Panel
3396
3397- Description: Customize outline Panel
3398- Setting: `outline_panel`
3399- Default:
3400
3401```json
3402"outline_panel": {
3403  "button": true,
3404  "default_width": 300,
3405  "dock": "left",
3406  "file_icons": true,
3407  "folder_icons": true,
3408  "git_status": true,
3409  "indent_size": 20,
3410  "auto_reveal_entries": true,
3411  "auto_fold_dirs": true,
3412  "indent_guides": {
3413    "show": "always"
3414  },
3415  "scrollbar": {
3416    "show": null
3417  }
3418}
3419```
3420
3421## Calls
3422
3423- Description: Customize behavior when participating in a call
3424- Setting: `calls`
3425- Default:
3426
3427```json
3428"calls": {
3429  // Join calls with the microphone live by default
3430  "mute_on_join": false,
3431  // Share your project when you are the first to join a channel
3432  "share_on_join": false
3433},
3434```
3435
3436## Unnecessary Code Fade
3437
3438- Description: How much to fade out unused code.
3439- Setting: `unnecessary_code_fade`
3440- Default: `0.3`
3441
3442**Options**
3443
3444Float values between `0.0` and `0.9`, where:
3445
3446- `0.0` means no fading (unused code looks the same as used code)
3447- `0.9` means maximum fading (unused code is very faint but still visible)
3448
3449**Example**
3450
3451```json
3452{
3453  "unnecessary_code_fade": 0.5
3454}
3455```
3456
3457## UI Font Family
3458
3459- Description: The name of the font to use for text in the UI.
3460- Setting: `ui_font_family`
3461- Default: `Zed Plex Sans`
3462
3463**Options**
3464
3465The name of any font family installed on the system.
3466
3467## UI Font Features
3468
3469- Description: The OpenType features to enable for text in the UI.
3470- Setting: `ui_font_features`
3471- Default:
3472
3473```json
3474"ui_font_features": {
3475  "calt": false
3476}
3477```
3478
3479- Platform: macOS and Windows.
3480
3481**Options**
3482
3483Zed supports all OpenType features that can be enabled or disabled for a given UI font, as well as setting values for font features.
3484
3485For example, to disable font ligatures, add the following to your settings:
3486
3487```json
3488{
3489  "ui_font_features": {
3490    "calt": false
3491  }
3492}
3493```
3494
3495You can also set other OpenType features, like setting `cv01` to `7`:
3496
3497```json
3498{
3499  "ui_font_features": {
3500    "cv01": 7
3501  }
3502}
3503```
3504
3505## UI Font Fallbacks
3506
3507- Description: The font fallbacks to use for text in the UI.
3508- Setting: `ui_font_fallbacks`
3509- Default: `null`
3510- Platform: macOS and Windows.
3511
3512**Options**
3513
3514For example, to use `Nerd Font` as a fallback, add the following to your settings:
3515
3516```json
3517{
3518  "ui_font_fallbacks": ["Nerd Font"]
3519}
3520```
3521
3522## UI Font Size
3523
3524- Description: The default font size for text in the UI.
3525- Setting: `ui_font_size`
3526- Default: `16`
3527
3528**Options**
3529
3530`integer` values from `6` to `100` pixels (inclusive)
3531
3532## UI Font Weight
3533
3534- Description: The default font weight for text in the UI.
3535- Setting: `ui_font_weight`
3536- Default: `400`
3537
3538**Options**
3539
3540`integer` values between `100` and `900`
3541
3542## An example configuration:
3543
3544```json
3545// ~/.config/zed/settings.json
3546{
3547  "theme": "cave-light",
3548  "tab_size": 2,
3549  "preferred_line_length": 80,
3550  "soft_wrap": "none",
3551
3552  "buffer_font_size": 18,
3553  "buffer_font_family": "Zed Plex Mono",
3554
3555  "autosave": "on_focus_change",
3556  "format_on_save": "off",
3557  "vim_mode": false,
3558  "projects_online_by_default": true,
3559  "terminal": {
3560    "font_family": "FiraCode Nerd Font Mono",
3561    "blinking": "off"
3562  },
3563  "languages": {
3564    "C": {
3565      "format_on_save": "language_server",
3566      "preferred_line_length": 64,
3567      "soft_wrap": "preferred_line_length"
3568    }
3569  }
3570}
3571```