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    "minimum_contrast": 45,
2592    "option_as_meta": false,
2593    "button": true,
2594    "shell": "system",
2595    "toolbar": {
2596      "breadcrumbs": true
2597    },
2598    "working_directory": "current_project_directory",
2599    "scrollbar": {
2600      "show": null
2601    }
2602  }
2603}
2604```
2605
2606### Terminal: Dock
2607
2608- Description: Control the position of the dock
2609- Setting: `dock`
2610- Default: `bottom`
2611
2612**Options**
2613
2614`"bottom"`, `"left"` or `"right"`
2615
2616### Terminal: Alternate Scroll
2617
2618- 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.
2619- Setting: `alternate_scroll`
2620- Default: `off`
2621
2622**Options**
2623
26241. Default alternate scroll mode to off
2625
2626```json
2627{
2628  "terminal": {
2629    "alternate_scroll": "off"
2630  }
2631}
2632```
2633
26342. Default alternate scroll mode to on
2635
2636```json
2637{
2638  "terminal": {
2639    "alternate_scroll": "on"
2640  }
2641}
2642```
2643
2644### Terminal: Blinking
2645
2646- Description: Set the cursor blinking behavior in the terminal
2647- Setting: `blinking`
2648- Default: `terminal_controlled`
2649
2650**Options**
2651
26521. Never blink the cursor, ignore the terminal mode
2653
2654```json
2655{
2656  "terminal": {
2657    "blinking": "off"
2658  }
2659}
2660```
2661
26622. Default the cursor blink to off, but allow the terminal to turn blinking on
2663
2664```json
2665{
2666  "terminal": {
2667    "blinking": "terminal_controlled"
2668  }
2669}
2670```
2671
26723. Always blink the cursor, ignore the terminal mode
2673
2674```json
2675{
2676  "terminal": {
2677    "blinking": "on"
2678  }
2679}
2680```
2681
2682### Terminal: Copy On Select
2683
2684- Description: Whether or not selecting text in the terminal will automatically copy to the system clipboard.
2685- Setting: `copy_on_select`
2686- Default: `false`
2687
2688**Options**
2689
2690`boolean` values
2691
2692**Example**
2693
2694```json
2695{
2696  "terminal": {
2697    "copy_on_select": true
2698  }
2699}
2700```
2701
2702### Terminal: Cursor Shape
2703
2704- Description: Whether or not selecting text in the terminal will automatically copy to the system clipboard.
2705- Setting: `cursor_shape`
2706- Default: `null` (defaults to block)
2707
2708**Options**
2709
27101. A block that surrounds the following character
2711
2712```json
2713{
2714  "terminal": {
2715    "cursor_shape": "block"
2716  }
2717}
2718```
2719
27202. A vertical bar
2721
2722```json
2723{
2724  "terminal": {
2725    "cursor_shape": "bar"
2726  }
2727}
2728```
2729
27303. An underline / underscore that runs along the following character
2731
2732```json
2733{
2734  "terminal": {
2735    "cursor_shape": "underline"
2736  }
2737}
2738```
2739
27404. A box drawn around the following character
2741
2742```json
2743{
2744  "terminal": {
2745    "cursor_shape": "hollow"
2746  }
2747}
2748```
2749
2750### Terminal: Keep Selection On Copy
2751
2752- Description: Whether or not to keep the selection in the terminal after copying text.
2753- Setting: `keep_selection_on_copy`
2754- Default: `false`
2755
2756**Options**
2757
2758`boolean` values
2759
2760**Example**
2761
2762```json
2763{
2764  "terminal": {
2765    "keep_selection_on_copy": true
2766  }
2767}
2768```
2769
2770### Terminal: Env
2771
2772- 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
2773- Setting: `env`
2774- Default: `{}`
2775
2776**Example**
2777
2778```json
2779{
2780  "terminal": {
2781    "env": {
2782      "ZED": "1",
2783      "KEY": "value1:value2"
2784    }
2785  }
2786}
2787```
2788
2789### Terminal: Font Size
2790
2791- Description: What font size to use for the terminal. When not set defaults to matching the editor's font size
2792- Setting: `font_size`
2793- Default: `null`
2794
2795**Options**
2796
2797`integer` values
2798
2799```json
2800{
2801  "terminal": {
2802    "font_size": 15
2803  }
2804}
2805```
2806
2807### Terminal: Font Family
2808
2809- Description: What font to use for the terminal. When not set, defaults to matching the editor's font.
2810- Setting: `font_family`
2811- Default: `null`
2812
2813**Options**
2814
2815The name of any font family installed on the user's system
2816
2817```json
2818{
2819  "terminal": {
2820    "font_family": "Berkeley Mono"
2821  }
2822}
2823```
2824
2825### Terminal: Font Features
2826
2827- Description: What font features to use for the terminal. When not set, defaults to matching the editor's font features.
2828- Setting: `font_features`
2829- Default: `null`
2830- Platform: macOS and Windows.
2831
2832**Options**
2833
2834See Buffer Font Features
2835
2836```json
2837{
2838  "terminal": {
2839    "font_features": {
2840      "calt": false
2841      // See Buffer Font Features for more features
2842    }
2843  }
2844}
2845```
2846
2847### Terminal: Line Height
2848
2849- Description: Set the terminal's line height.
2850- Setting: `line_height`
2851- Default: `comfortable`
2852
2853**Options**
2854
28551. Use a line height that's `comfortable` for reading, 1.618. (default)
2856
2857```json
2858{
2859  "terminal": {
2860    "line_height": "comfortable"
2861  }
2862}
2863```
2864
28652. Use a `standard` line height, 1.3. This option is useful for TUIs, particularly if they use box characters
2866
2867```json
2868{
2869  "terminal": {
2870    "line_height": "standard"
2871  }
2872}
2873```
2874
28753.  Use a custom line height.
2876
2877```json
2878{
2879  "terminal": {
2880    "line_height": {
2881      "custom": 2
2882    }
2883  }
2884}
2885```
2886
2887### Terminal: Minimum Contrast
2888
2889- Description: Controls the minimum contrast between foreground and background colors in the terminal. Uses the APCA (Accessible Perceptual Contrast Algorithm) for color adjustments. Set this to 0 to disable this feature.
2890- Setting: `minimum_contrast`
2891- Default: `45`
2892
2893**Options**
2894
2895`integer` values from 0 to 106. Common recommended values:
2896
2897- `0`: No contrast adjustment
2898- `45`: Minimum for large fluent text (default)
2899- `60`: Minimum for other content text
2900- `75`: Minimum for body text
2901- `90`: Preferred for body text
2902
2903```json
2904{
2905  "terminal": {
2906    "minimum_contrast": 45
2907  }
2908}
2909```
2910
2911### Terminal: Option As Meta
2912
2913- Description: Re-interprets the option keys to act like a 'meta' key, like in Emacs.
2914- Setting: `option_as_meta`
2915- Default: `false`
2916
2917**Options**
2918
2919`boolean` values
2920
2921```json
2922{
2923  "terminal": {
2924    "option_as_meta": true
2925  }
2926}
2927```
2928
2929### Terminal: Shell
2930
2931- Description: What shell to use when launching the terminal.
2932- Setting: `shell`
2933- Default: `system`
2934
2935**Options**
2936
29371. Use the system's default terminal configuration (usually the `/etc/passwd` file).
2938
2939```json
2940{
2941  "terminal": {
2942    "shell": "system"
2943  }
2944}
2945```
2946
29472. A program to launch:
2948
2949```json
2950{
2951  "terminal": {
2952    "shell": {
2953      "program": "sh"
2954    }
2955  }
2956}
2957```
2958
29593. A program with arguments:
2960
2961```json
2962{
2963  "terminal": {
2964    "shell": {
2965      "with_arguments": {
2966        "program": "/bin/bash",
2967        "args": ["--login"]
2968      }
2969    }
2970  }
2971}
2972```
2973
2974## Terminal: Detect Virtual Environments {#terminal-detect_venv}
2975
2976- 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.
2977- Setting: `detect_venv`
2978- Default:
2979
2980```json
2981{
2982  "terminal": {
2983    "detect_venv": {
2984      "on": {
2985        // Default directories to search for virtual environments, relative
2986        // to the current working directory. We recommend overriding this
2987        // in your project's settings, rather than globally.
2988        "directories": [".env", "env", ".venv", "venv"],
2989        // Can also be `csh`, `fish`, and `nushell`
2990        "activate_script": "default"
2991      }
2992    }
2993  }
2994}
2995```
2996
2997Disable with:
2998
2999```json
3000{
3001  "terminal": {
3002    "detect_venv": "off"
3003  }
3004}
3005```
3006
3007## Terminal: Toolbar
3008
3009- Description: Whether or not to show various elements in the terminal toolbar.
3010- Setting: `toolbar`
3011- Default:
3012
3013```json
3014{
3015  "terminal": {
3016    "toolbar": {
3017      "breadcrumbs": true
3018    }
3019  }
3020}
3021```
3022
3023**Options**
3024
3025At the moment, only the `breadcrumbs` option is available, it controls displaying of the terminal title that can be changed via `PROMPT_COMMAND`.
3026
3027If the terminal title is empty, the breadcrumbs won't be shown.
3028
3029The shell running in the terminal needs to be configured to emit the title.
3030
3031Example command to set the title: `echo -e "\e]2;New Title\007";`
3032
3033### Terminal: Button
3034
3035- Description: Control to show or hide the terminal button in the status bar
3036- Setting: `button`
3037- Default: `true`
3038
3039**Options**
3040
3041`boolean` values
3042
3043```json
3044{
3045  "terminal": {
3046    "button": false
3047  }
3048}
3049```
3050
3051### Terminal: Working Directory
3052
3053- Description: What working directory to use when launching the terminal.
3054- Setting: `working_directory`
3055- Default: `"current_project_directory"`
3056
3057**Options**
3058
30591. Use the current file's project directory. Will Fallback to the first project directory strategy if unsuccessful
3060
3061```json
3062{
3063  "terminal": {
3064    "working_directory": "current_project_directory"
3065  }
3066}
3067```
3068
30692. Use the first project in this workspace's directory. Will fallback to using this platform's home directory.
3070
3071```json
3072{
3073  "terminal": {
3074    "working_directory": "first_project_directory"
3075  }
3076}
3077```
3078
30793. Always use this platform's home directory (if we can find it)
3080
3081```json
3082{
3083  "terminal": {
3084    "working_directory": "always_home"
3085  }
3086}
3087```
3088
30894. 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.
3090
3091```json
3092{
3093  "terminal": {
3094    "working_directory": {
3095      "always": {
3096        "directory": "~/zed/projects/"
3097      }
3098    }
3099  }
3100}
3101```
3102
3103## Theme
3104
3105- 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.
3106- Setting: `theme`
3107- Default: `One Dark`
3108
3109### Theme Object
3110
3111- Description: Specify the theme using an object that includes the `mode`, `dark`, and `light` themes.
3112- Setting: `theme`
3113- Default:
3114
3115```json
3116"theme": {
3117  "mode": "system",
3118  "dark": "One Dark",
3119  "light": "One Light"
3120},
3121```
3122
3123### Mode
3124
3125- Description: Specify theme mode.
3126- Setting: `mode`
3127- Default: `system`
3128
3129**Options**
3130
31311. Set the theme to dark mode
3132
3133```json
3134{
3135  "mode": "dark"
3136}
3137```
3138
31392. Set the theme to light mode
3140
3141```json
3142{
3143  "mode": "light"
3144}
3145```
3146
31473. Set the theme to system mode
3148
3149```json
3150{
3151  "mode": "system"
3152}
3153```
3154
3155### Dark
3156
3157- Description: The name of the dark Zed theme to use for the UI.
3158- Setting: `dark`
3159- Default: `One Dark`
3160
3161**Options**
3162
3163Run the `theme selector: toggle` action in the command palette to see a current list of valid themes names.
3164
3165### Light
3166
3167- Description: The name of the light Zed theme to use for the UI.
3168- Setting: `light`
3169- Default: `One Light`
3170
3171**Options**
3172
3173Run the `theme selector: toggle` action in the command palette to see a current list of valid themes names.
3174
3175## Vim
3176
3177- Description: Whether or not to enable vim mode (work in progress).
3178- Setting: `vim_mode`
3179- Default: `false`
3180
3181## Project Panel
3182
3183- Description: Customize project panel
3184- Setting: `project_panel`
3185- Default:
3186
3187```json
3188{
3189  "project_panel": {
3190    "button": true,
3191    "default_width": 240,
3192    "dock": "left",
3193    "entry_spacing": "comfortable",
3194    "file_icons": true,
3195    "folder_icons": true,
3196    "git_status": true,
3197    "indent_size": 20,
3198    "auto_reveal_entries": true,
3199    "auto_fold_dirs": true,
3200    "scrollbar": {
3201      "show": null
3202    },
3203    "show_diagnostics": "all",
3204    "indent_guides": {
3205      "show": "always"
3206    },
3207    "hide_root": false
3208  }
3209}
3210```
3211
3212### Dock
3213
3214- Description: Control the position of the dock
3215- Setting: `dock`
3216- Default: `left`
3217
3218**Options**
3219
32201. Default dock position to left
3221
3222```json
3223{
3224  "dock": "left"
3225}
3226```
3227
32282. Default dock position to right
3229
3230```json
3231{
3232  "dock": "right"
3233}
3234```
3235
3236### Entry Spacing
3237
3238- Description: Spacing between worktree entries
3239- Setting: `entry_spacing`
3240- Default: `comfortable`
3241
3242**Options**
3243
32441. Comfortable entry spacing
3245
3246```json
3247{
3248  "entry_spacing": "comfortable"
3249}
3250```
3251
32522. Standard entry spacing
3253
3254```json
3255{
3256  "entry_spacing": "standard"
3257}
3258```
3259
3260### Git Status
3261
3262- Description: Indicates newly created and updated files
3263- Setting: `git_status`
3264- Default: `true`
3265
3266**Options**
3267
32681. Default enable git status
3269
3270```json
3271{
3272  "git_status": true
3273}
3274```
3275
32762. Default disable git status
3277
3278```json
3279{
3280  "git_status": false
3281}
3282```
3283
3284### Default Width
3285
3286- Description: Customize default width taken by project panel
3287- Setting: `default_width`
3288- Default: `240`
3289
3290**Options**
3291
3292`float` values
3293
3294### Auto Reveal Entries
3295
3296- Description: Whether to reveal it in the project panel automatically, when a corresponding project entry becomes active. Gitignored entries are never auto revealed.
3297- Setting: `auto_reveal_entries`
3298- Default: `true`
3299
3300**Options**
3301
33021. Enable auto reveal entries
3303
3304```json
3305{
3306  "auto_reveal_entries": true
3307}
3308```
3309
33102. Disable auto reveal entries
3311
3312```json
3313{
3314  "auto_reveal_entries": false
3315}
3316```
3317
3318### Auto Fold Dirs
3319
3320- Description: Whether to fold directories automatically when directory has only one directory inside.
3321- Setting: `auto_fold_dirs`
3322- Default: `true`
3323
3324**Options**
3325
33261. Enable auto fold dirs
3327
3328```json
3329{
3330  "auto_fold_dirs": true
3331}
3332```
3333
33342. Disable auto fold dirs
3335
3336```json
3337{
3338  "auto_fold_dirs": false
3339}
3340```
3341
3342### Indent Size
3343
3344- Description: Amount of indentation (in pixels) for nested items.
3345- Setting: `indent_size`
3346- Default: `20`
3347
3348### Indent Guides: Show
3349
3350- Description: Whether to show indent guides in the project panel.
3351- Setting: `indent_guides`
3352- Default:
3353
3354```json
3355"indent_guides": {
3356  "show": "always"
3357}
3358```
3359
3360**Options**
3361
33621. Show indent guides in the project panel
3363
3364```json
3365{
3366  "indent_guides": {
3367    "show": "always"
3368  }
3369}
3370```
3371
33722. Hide indent guides in the project panel
3373
3374```json
3375{
3376  "indent_guides": {
3377    "show": "never"
3378  }
3379}
3380```
3381
3382### Scrollbar: Show
3383
3384- 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.
3385- Setting: `scrollbar`
3386- Default:
3387
3388```json
3389"scrollbar": {
3390  "show": null
3391}
3392```
3393
3394**Options**
3395
33961. Show scrollbar in the project panel
3397
3398```json
3399{
3400  "scrollbar": {
3401    "show": "always"
3402  }
3403}
3404```
3405
34062. Hide scrollbar in the project panel
3407
3408```json
3409{
3410  "scrollbar": {
3411    "show": "never"
3412  }
3413}
3414```
3415
3416## Agent
3417
3418Visit [the Configuration page](./ai/configuration.md) under the AI section to learn more about all the agent-related settings.
3419
3420## Outline Panel
3421
3422- Description: Customize outline Panel
3423- Setting: `outline_panel`
3424- Default:
3425
3426```json
3427"outline_panel": {
3428  "button": true,
3429  "default_width": 300,
3430  "dock": "left",
3431  "file_icons": true,
3432  "folder_icons": true,
3433  "git_status": true,
3434  "indent_size": 20,
3435  "auto_reveal_entries": true,
3436  "auto_fold_dirs": true,
3437  "indent_guides": {
3438    "show": "always"
3439  },
3440  "scrollbar": {
3441    "show": null
3442  }
3443}
3444```
3445
3446## Calls
3447
3448- Description: Customize behavior when participating in a call
3449- Setting: `calls`
3450- Default:
3451
3452```json
3453"calls": {
3454  // Join calls with the microphone live by default
3455  "mute_on_join": false,
3456  // Share your project when you are the first to join a channel
3457  "share_on_join": false
3458},
3459```
3460
3461## Unnecessary Code Fade
3462
3463- Description: How much to fade out unused code.
3464- Setting: `unnecessary_code_fade`
3465- Default: `0.3`
3466
3467**Options**
3468
3469Float values between `0.0` and `0.9`, where:
3470
3471- `0.0` means no fading (unused code looks the same as used code)
3472- `0.9` means maximum fading (unused code is very faint but still visible)
3473
3474**Example**
3475
3476```json
3477{
3478  "unnecessary_code_fade": 0.5
3479}
3480```
3481
3482## UI Font Family
3483
3484- Description: The name of the font to use for text in the UI.
3485- Setting: `ui_font_family`
3486- Default: `Zed Plex Sans`
3487
3488**Options**
3489
3490The name of any font family installed on the system.
3491
3492## UI Font Features
3493
3494- Description: The OpenType features to enable for text in the UI.
3495- Setting: `ui_font_features`
3496- Default:
3497
3498```json
3499"ui_font_features": {
3500  "calt": false
3501}
3502```
3503
3504- Platform: macOS and Windows.
3505
3506**Options**
3507
3508Zed supports all OpenType features that can be enabled or disabled for a given UI font, as well as setting values for font features.
3509
3510For example, to disable font ligatures, add the following to your settings:
3511
3512```json
3513{
3514  "ui_font_features": {
3515    "calt": false
3516  }
3517}
3518```
3519
3520You can also set other OpenType features, like setting `cv01` to `7`:
3521
3522```json
3523{
3524  "ui_font_features": {
3525    "cv01": 7
3526  }
3527}
3528```
3529
3530## UI Font Fallbacks
3531
3532- Description: The font fallbacks to use for text in the UI.
3533- Setting: `ui_font_fallbacks`
3534- Default: `null`
3535- Platform: macOS and Windows.
3536
3537**Options**
3538
3539For example, to use `Nerd Font` as a fallback, add the following to your settings:
3540
3541```json
3542{
3543  "ui_font_fallbacks": ["Nerd Font"]
3544}
3545```
3546
3547## UI Font Size
3548
3549- Description: The default font size for text in the UI.
3550- Setting: `ui_font_size`
3551- Default: `16`
3552
3553**Options**
3554
3555`integer` values from `6` to `100` pixels (inclusive)
3556
3557## UI Font Weight
3558
3559- Description: The default font weight for text in the UI.
3560- Setting: `ui_font_weight`
3561- Default: `400`
3562
3563**Options**
3564
3565`integer` values between `100` and `900`
3566
3567## An example configuration:
3568
3569```json
3570// ~/.config/zed/settings.json
3571{
3572  "theme": "cave-light",
3573  "tab_size": 2,
3574  "preferred_line_length": 80,
3575  "soft_wrap": "none",
3576
3577  "buffer_font_size": 18,
3578  "buffer_font_family": "Zed Plex Mono",
3579
3580  "autosave": "on_focus_change",
3581  "format_on_save": "off",
3582  "vim_mode": false,
3583  "projects_online_by_default": true,
3584  "terminal": {
3585    "font_family": "FiraCode Nerd Font Mono",
3586    "blinking": "off"
3587  },
3588  "languages": {
3589    "C": {
3590      "format_on_save": "language_server",
3591      "preferred_line_length": 64,
3592      "soft_wrap": "preferred_line_length"
3593    }
3594  }
3595}
3596```