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