1# Configuring Zed
2
3Zed is designed to be configured: we want to fit your workflow and preferences exactly. We provide default settings that are designed to be a comfortable starting point for as many people as possible, but we hope you will enjoy tweaking it to make it feel incredible.
4
5In addition to the settings described here, you may also want to change your [theme](./themes.md), configure your [key bindings](./key-bindings.md), set up [tasks](./tasks.md) or install [extensions](https://github.com/zed-industries/extensions).
6
7## Settings files
8
9<!--
10TBD: Settings files. Rewrite with "remote settings" in mind (e.g. `local settings` on the remote host).
11Consider renaming `zed: Open Local Settings` to `zed: Open Project Settings`.
12
13TBD: Add settings documentation about how settings are merged as overlays. E.g. project>local>default. Note how settings that are maps are merged, but settings that are arrays are replaced and must include the defaults.
14-->
15
16Your settings file can be opened with {#kb zed::OpenSettings}. By default it is located at `~/.config/zed/settings.json`, though if you have XDG_CONFIG_HOME in your environment on Linux it will be at `$XDG_CONFIG_HOME/zed/settings.json` instead.
17
18This configuration is merged with any local configuration inside your projects. You can open the project settings by running {#action zed::OpenLocalSettings} from the command palette. This will create a `.zed` directory containing`.zed/settings.json`.
19
20Although most projects will only need one settings file at the root, you can add more local settings files for subdirectories as needed. Not all settings can be set in local files, just those that impact the behavior of the editor and language tooling. For example you can set `tab_size`, `formatter` etc. but not `theme`, `vim_mode` and similar.
21
22The syntax for configuration files is a super-set of JSON that allows `//` comments.
23
24## Default settings
25
26You can find the default settings for your current Zed by running {#action zed::OpenDefaultSettings} from the command palette.
27
28Extensions that provide language servers may also provide default settings for those language servers.
29
30# Settings
31
32## Active Pane Magnification
33
34- Description: Scale by which to zoom the active pane. When set to `1.0`, the active pane has the same size as others, but when set to a larger value, the active pane takes up more space.
35- Setting: `active_pane_magnification`
36- Default: `1.0`
37
38**Options**
39
40`float` values
41
42## Autosave
43
44- Description: When to automatically save edited buffers.
45- Setting: `autosave`
46- Default: `off`
47
48**Options**
49
501. To disable autosave, set it to `off`:
51
52```json
53{
54 "autosave": "off"
55}
56```
57
582. To autosave when focus changes, use `on_focus_change`:
59
60```json
61{
62 "autosave": "on_focus_change"
63}
64```
65
663. To autosave when the active window changes, use `on_window_change`:
67
68```json
69{
70 "autosave": "on_window_change"
71}
72```
73
744. To autosave after an inactivity period, use `after_delay`:
75
76```json
77{
78 "autosave": {
79 "after_delay": {
80 "milliseconds": 1000
81 }
82 }
83}
84```
85
86## Auto Update
87
88- Description: Whether or not to automatically check for updates.
89- Setting: `auto_update`
90- Default: `true`
91
92**Options**
93
94`boolean` values
95
96## Base Keymap
97
98- Description: Base key bindings scheme. Base keymaps can be overridden with user keymaps.
99- Setting: `base_keymap`
100- Default: `VSCode`
101
102**Options**
103
1041. VSCode
105
106```json
107{
108 "base_keymap": "VSCode"
109}
110```
111
1122. Atom
113
114```json
115{
116 "base_keymap": "Atom"
117}
118```
119
1203. JetBrains
121
122```json
123{
124 "base_keymap": "JetBrains"
125}
126```
127
1284. None
129
130```json
131{
132 "base_keymap": "None"
133}
134```
135
1365. SublimeText
137
138```json
139{
140 "base_keymap": "SublimeText"
141}
142```
143
1446. TextMate
145
146```json
147{
148 "base_keymap": "TextMate"
149}
150```
151
152## Buffer Font Family
153
154- Description: The name of a font to use for rendering text in the editor.
155- Setting: `buffer_font_family`
156- Default: `Zed Plex Mono`
157
158**Options**
159
160The name of any font family installed on the user's system
161
162## Buffer Font Features
163
164- Description: The OpenType features to enable for text in the editor.
165- Setting: `buffer_font_features`
166- Default: `null`
167- Platform: macOS and Windows.
168
169**Options**
170
171Zed 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.
172
173For example, to disable font ligatures, add the following to your settings:
174
175```json
176{
177 "buffer_font_features": {
178 "calt": false
179 }
180}
181```
182
183You can also set other OpenType features, like setting `cv01` to `7`:
184
185```json
186{
187 "buffer_font_features": {
188 "cv01": 7
189 }
190}
191```
192
193## Buffer Font Fallbacks
194
195- Description: Set the buffer text's font fallbacks, this will be merged with the platform's default fallbacks.
196- Setting: `buffer_font_fallbacks`
197- Default: `null`
198- Platform: macOS and Windows.
199
200**Options**
201
202For example, to use `Nerd Font` as a fallback, add the following to your settings:
203
204```json
205{
206 "buffer_font_fallbacks": ["Nerd Font"]
207}
208```
209
210## Buffer Font Size
211
212- Description: The default font size for text in the editor.
213- Setting: `buffer_font_size`
214- Default: `15`
215
216**Options**
217
218`integer` values from `6` to `100` pixels (inclusive)
219
220## Buffer Font Weight
221
222- Description: The default font weight for text in the editor.
223- Setting: `buffer_font_weight`
224- Default: `400`
225
226**Options**
227
228`integer` values between `100` and `900`
229
230## Buffer Line Height
231
232- Description: The default line height for text in the editor.
233- Setting: `buffer_line_height`
234- Default: `"comfortable"`
235
236**Options**
237
238`"standard"`, `"comfortable"` or `{"custom": float}` (`1` is very compact, `2` very loose)
239
240## Confirm Quit
241
242- Description: Whether or not to prompt the user to confirm before closing the application.
243- Setting: `confirm_quit`
244- Default: `false`
245
246**Options**
247
248`boolean` values
249
250## Centered Layout
251
252- Description: Configuration for the centered layout mode.
253- Setting: `centered_layout`
254- Default:
255
256```json
257"centered_layout": {
258 "left_padding": 0.2,
259 "right_padding": 0.2,
260}
261```
262
263**Options**
264
265The `left_padding` and `right_padding` options define the relative width of the
266left 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`.
267
268## Direnv Integration
269
270- Description: Settings for [direnv](https://direnv.net/) integration. Requires `direnv` to be installed.
271 `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.
272 It also allows for those environment variables to be used in tasks.
273- Setting: `load_direnv`
274- Default:
275
276```json
277"load_direnv": "direct"
278```
279
280**Options**
281There are two options to choose from:
282
2831. `shell_hook`: Use the shell hook to load direnv. This relies on direnv to activate upon entering the directory. Supports POSIX shells and fish.
2842. `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.
285
286## Inline Completions
287
288- Description: Settings for inline completions.
289- Setting: `inline_completions`
290- Default:
291
292```json
293"inline_completions": {
294 "disabled_globs": [
295 ".env"
296 ]
297}
298```
299
300**Options**
301
302### Disabled Globs
303
304- Description: A list of globs representing files that inline completions should be disabled for.
305- Setting: `disabled_globs`
306- Default: `[".env"]`
307
308**Options**
309
310List of `string` values
311
312## Current Line Highlight
313
314- Description: How to highlight the current line in the editor.
315- Setting: `current_line_highlight`
316- Default: `all`
317
318**Options**
319
3201. Don't highlight the current line:
321
322```json
323"current_line_highlight": "none"
324```
325
3262. Highlight the gutter area:
327
328```json
329"current_line_highlight": "gutter"
330```
331
3323. Highlight the editor area:
333
334```json
335"current_line_highlight": "line"
336```
337
3384. Highlight the full line:
339
340```json
341"current_line_highlight": "all"
342```
343
344## Cursor Blink
345
346- Description: Whether or not the cursor blinks.
347- Setting: `cursor_blink`
348- Default: `true`
349
350**Options**
351
352`boolean` values
353
354## Cursor Shape
355
356- Description: Cursor shape for the default editor.
357- Setting: `cursor_shape`
358- Default: `bar`
359
360**Options**
361
3621. A vertical bar:
363
364```json
365"cursor_shape": "bar"
366```
367
3682. A block that surrounds the following character:
369
370```json
371"cursor_shape": "block"
372```
373
3743. An underscore that runs along the following character:
375
376```json
377"cursor_shape": "underscore"
378```
379
3804. An box drawn around the following character:
381
382```json
383"cursor_shape": "hollow"
384```
385
386**Options**
387
3881. Position the dock attached to the bottom of the workspace: `bottom`
3892. Position the dock to the right of the workspace like a side panel: `right`
3903. Position the dock full screen over the entire workspace: `expanded`
391
392## Editor Scrollbar
393
394- Description: Whether or not to show the editor scrollbar and various elements in it.
395- Setting: `scrollbar`
396- Default:
397
398```json
399"scrollbar": {
400 "show": "auto",
401 "cursors": true,
402 "git_diff": true,
403 "search_results": true,
404 "selected_symbol": true,
405 "diagnostics": true
406},
407```
408
409### Show Mode
410
411- Description: When to show the editor scrollbar.
412- Setting: `show`
413- Default: `auto`
414
415**Options**
416
4171. Show the scrollbar if there's important information or follow the system's configured behavior:
418
419```json
420"scrollbar": {
421 "show": "auto"
422}
423```
424
4252. Match the system's configured behavior:
426
427```json
428"scrollbar": {
429 "show": "system"
430}
431```
432
4333. Always show the scrollbar:
434
435```json
436"scrollbar": {
437 "show": "always"
438}
439```
440
4414. Never show the scrollbar:
442
443```json
444"scrollbar": {
445 "show": "never"
446}
447```
448
449### Cursor Indicators
450
451- Description: Whether to show cursor positions in the scrollbar.
452- Setting: `cursors`
453- Default: `true`
454
455**Options**
456
457`boolean` values
458
459### Git Diff Indicators
460
461- Description: Whether to show git diff indicators in the scrollbar.
462- Setting: `git_diff`
463- Default: `true`
464
465**Options**
466
467`boolean` values
468
469### Search Results Indicators
470
471- Description: Whether to show buffer search results in the scrollbar.
472- Setting: `search_results`
473- Default: `true`
474
475**Options**
476
477`boolean` values
478
479### Selected Symbols Indicators
480
481- Description: Whether to show selected symbol occurrences in the scrollbar.
482- Setting: `selected_symbol`
483- Default: `true`
484
485**Options**
486
487`boolean` values
488
489### Diagnostics
490
491- Description: Whether to show diagnostic indicators in the scrollbar.
492- Setting: `diagnostics`
493- Default: `true`
494
495**Options**
496
497`boolean` values
498
499## Editor Tab Bar
500
501- Description: Settings related to the editor's tab bar.
502- Settings: `tab_bar`
503- Default:
504
505```json
506"tab_bar": {
507 "show": true,
508 "show_nav_history_buttons": true
509}
510```
511
512### Show
513
514- Description: Whether or not to show the tab bar in the editor.
515- Setting: `show`
516- Default: `true`
517
518**Options**
519
520`boolean` values
521
522### Navigation History Buttons
523
524- Description: Whether or not to show the navigation history buttons.
525- Setting: `show_nav_history_buttons`
526- Default: `true`
527
528**Options**
529
530`boolean` values
531
532## Editor Tabs
533
534- Description: Configuration for the editor tabs.
535- Setting: `tabs`
536- Default:
537
538```json
539"tabs": {
540 "close_position": "right",
541 "file_icons": false,
542 "git_status": false
543},
544```
545
546### Close Position
547
548- Description: Where to display close button within a tab.
549- Setting: `close_position`
550- Default: `right`
551
552**Options**
553
5541. Display the close button on the right:
555
556```json
557{
558 "close_position": "right"
559}
560```
561
5622. Display the close button on the left:
563
564```json
565{
566 "close_position": "left"
567}
568```
569
570### File Icons
571
572- Description: Whether to show the file icon for a tab.
573- Setting: `file_icons`
574- Default: `false`
575
576### Git Status
577
578- Description: Whether or not to show Git file status in tab.
579- Setting: `git_status`
580- Default: `false`
581
582## Editor Toolbar
583
584- Description: Whether or not to show various elements in the editor toolbar.
585- Setting: `toolbar`
586- Default:
587
588```json
589"toolbar": {
590 "breadcrumbs": true,
591 "quick_actions": true
592},
593```
594
595**Options**
596
597Each option controls displaying of a particular toolbar element. If all elements are hidden, the editor toolbar is not displayed.
598
599## Enable Language Server
600
601- Description: Whether or not to use language servers to provide code intelligence.
602- Setting: `enable_language_server`
603- Default: `true`
604
605**Options**
606
607`boolean` values
608
609## Ensure Final Newline On Save
610
611- Description: Whether or not to ensure there's a single newline at the end of a buffer when saving it.
612- Setting: `ensure_final_newline_on_save`
613- Default: `true`
614
615**Options**
616
617`boolean` values
618
619## LSP
620
621- Description: Configuration for language servers.
622- Setting: `lsp`
623- Default: `null`
624
625**Options**
626
627The following settings can be overridden for specific language servers:
628
629- `initialization_options`
630- `settings`
631
632To override configuration for a language server, add an entry for that language server's name to the `lsp` value.
633
634Some 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.
635
636For example to pass the `check` option to `rust-analyzer`, use the following configuration:
637
638```json
639"lsp": {
640 "rust-analyzer": {
641 "initialization_options": {
642 "check": {
643 "command": "clippy" // rust-analyzer.check.command (default: "check")
644 }
645 }
646 }
647}
648```
649
650While other options may be changed at a runtime and should be placed under `settings`:
651
652```json
653"lsp": {
654 "yaml-language-server": {
655 "settings": {
656 "yaml": {
657 "keyOrdering": true // Enforces alphabetical ordering of keys in maps
658 }
659 }
660 }
661}
662```
663
664## Format On Save
665
666- Description: Whether or not to perform a buffer format before saving.
667- Setting: `format_on_save`
668- Default: `on`
669
670**Options**
671
6721. `on`, enables format on save obeying `formatter` setting:
673
674```json
675{
676 "format_on_save": "on"
677}
678```
679
6802. `off`, disables format on save:
681
682```json
683{
684 "format_on_save": "off"
685}
686```
687
688## Formatter
689
690- Description: How to perform a buffer format.
691- Setting: `formatter`
692- Default: `auto`
693
694**Options**
695
6961. To use the current language server, use `"language_server"`:
697
698```json
699{
700 "formatter": "language_server"
701}
702```
703
7042. 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):
705
706```json
707{
708 "formatter": {
709 "external": {
710 "command": "sed",
711 "arguments": ["-e", "s/ *$//"]
712 }
713 }
714}
715```
716
7173. Or to use code actions provided by the connected language servers, use `"code_actions"`:
718
719```json
720{
721 "formatter": {
722 "code_actions": {
723 // Use ESLint's --fix:
724 "source.fixAll.eslint": true,
725 // Organize imports on save:
726 "source.organizeImports": true
727 }
728 }
729}
730```
731
7324. Or to use multiple formatters consecutively, use an array of formatters:
733
734```json
735{
736 "formatter": [
737 {"language_server": {"name": "rust-analyzer"}},
738 {"external": {
739 "command": "sed",
740 "arguments": ["-e", "s/ *$//"]
741 }
742 ]
743}
744```
745
746Here `rust-analyzer` will be used first to format the code, followed by a call of sed.
747If any of the formatters fails, the subsequent ones will still be executed.
748
749## Code Actions On Format
750
751- Description: The code actions to perform with the primary language server when formatting the buffer.
752- Setting: `code_actions_on_format`
753- Default: `{}`, except for Go it's `{ "source.organizeImports": true }`
754
755**Examples**
756
757<!--
758TBD: Add Python Ruff source.organizeImports example
759-->
760
7611. Organize imports on format in TypeScript and TSX buffers:
762
763```json
764{
765 "languages": {
766 "TypeScript": {
767 "code_actions_on_format": {
768 "source.organizeImports": true
769 }
770 },
771 "TSX": {
772 "code_actions_on_format": {
773 "source.organizeImports": true
774 }
775 }
776 }
777}
778```
779
7802. Run ESLint `fixAll` code action when formatting:
781
782```json
783{
784 "languages": {
785 "JavaScript": {
786 "code_actions_on_format": {
787 "source.fixAll.eslint": true
788 }
789 }
790 }
791}
792```
793
7943. Run only a single ESLint rule when using `fixAll`:
795
796```json
797{
798 "languages": {
799 "JavaScript": {
800 "code_actions_on_format": {
801 "source.fixAll.eslint": true
802 }
803 }
804 },
805 "lsp": {
806 "eslint": {
807 "settings": {
808 "codeActionOnSave": {
809 "rules": ["import/order"]
810 }
811 }
812 }
813 }
814}
815```
816
817## Auto close
818
819- Description: Whether to automatically add matching closing characters when typing opening parenthesis, bracket, brace, single or double quote characters.
820- Setting: `use_autoclose`
821- Default: `true`
822
823**Options**
824
825`boolean` values
826
827## Always Treat Brackets As Autoclosed
828
829- Description: Controls how the editor handles the autoclosed characters.
830- Setting: `always_treat_brackets_as_autoclosed`
831- Default: `false`
832
833**Options**
834
835`boolean` values
836
837**Example**
838
839If the setting is set to `true`:
840
8411. Enter in the editor: `)))`
8422. Move the cursor to the start: `^)))`
8433. Enter again: `)))`
844
845The result is still `)))` and not `))))))`, which is what it would be by default.
846
847## File Scan Exclusions
848
849- Setting: `file_scan_exclusions`
850- Description: Configure how Add filename or directory globs that will be excluded by Zed entirely. They will be skipped during file scans, file searches and hidden from project file tree.
851- Default:
852
853```json
854"file_scan_exclusions": [
855 "**/.git",
856 "**/.svn",
857 "**/.hg",
858 "**/CVS",
859 "**/.DS_Store",
860 "**/Thumbs.db",
861 "**/.classpath",
862 "**/.settings"
863],
864```
865
866Note, 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.
867
868## File Types
869
870- Setting: `file_types`
871- Description: Configure how Zed selects a language for a file based on its filename or extension. Supports glob entries.
872- Default: `{}`
873
874**Examples**
875
876To interpret all `.c` files as C++, files called `MyLockFile` as TOML and files starting with `Dockerfile` as Dockerfile:
877
878```json
879{
880 "file_types": {
881 "C++": ["c"],
882 "TOML": ["MyLockFile"],
883 "Dockerfile": ["Dockerfile*"]
884 }
885}
886```
887
888## Git
889
890- Description: Configuration for git-related features.
891- Setting: `git`
892- Default:
893
894```json
895{
896 "git": {
897 "git_gutter": "tracked_files",
898 "inline_blame": {
899 "enabled": true
900 }
901 }
902}
903```
904
905### Git Gutter
906
907- Description: Whether or not to show the git gutter.
908- Setting: `git_gutter`
909- Default: `tracked_files`
910
911**Options**
912
9131. Show git gutter in tracked files
914
915```json
916{
917 "git": {
918 "git_gutter": "tracked_files"
919 }
920}
921```
922
9232. Hide git gutter
924
925```json
926{
927 "git": {
928 "git_gutter": "hide"
929 }
930}
931```
932
933### Inline Git Blame
934
935- Description: Whether or not to show git blame information inline, on the currently focused line.
936- Setting: `inline_blame`
937- Default:
938
939```json
940{
941 "git": {
942 "inline_blame": {
943 "enabled": true
944 }
945 }
946}
947```
948
949**Options**
950
9511. Disable inline git blame:
952
953```json
954{
955 "git": {
956 "inline_blame": {
957 "enabled": false
958 }
959 }
960}
961```
962
9632. Only show inline git blame after a delay (that starts after cursor stops moving):
964
965```json
966{
967 "git": {
968 "inline_blame": {
969 "enabled": true,
970 "delay_ms": 500
971 }
972 }
973}
974```
975
976## Indent Guides
977
978- Description: Configuration related to indent guides. Indent guides can be configured separately for each language.
979- Setting: `indent_guides`
980- Default:
981
982```json
983{
984 "indent_guides": {
985 "enabled": true,
986 "line_width": 1,
987 "active_line_width": 1,
988 "coloring": "fixed",
989 "background_coloring": "disabled"
990 }
991}
992```
993
994**Options**
995
9961. Disable indent guides
997
998```json
999{
1000 "indent_guides": {
1001 "enabled": false
1002 }
1003}
1004```
1005
10062. Enable indent guides for a specific language.
1007
1008```json
1009{
1010 "languages": {
1011 "Python": {
1012 "indent_guides": {
1013 "enabled": true
1014 }
1015 }
1016 }
1017}
1018```
1019
10203. Enable indent aware coloring ("rainbow indentation").
1021 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.
1022
1023```json
1024{
1025 "indent_guides": {
1026 "enabled": true,
1027 "coloring": "indent_aware"
1028 }
1029}
1030```
1031
10324. Enable indent aware background coloring ("rainbow indentation").
1033 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.
1034
1035```json
1036{
1037 "indent_guides": {
1038 "enabled": true,
1039 "coloring": "indent_aware",
1040 "background_coloring": "indent_aware"
1041 }
1042}
1043```
1044
1045## Hard Tabs
1046
1047- Description: Whether to indent lines using tab characters or multiple spaces.
1048- Setting: `hard_tabs`
1049- Default: `false`
1050
1051**Options**
1052
1053`boolean` values
1054
1055## Hover Popover Enabled
1056
1057- Description: Whether or not to show the informational hover box when moving the mouse over symbols in the editor.
1058- Setting: `hover_popover_enabled`
1059- Default: `true`
1060
1061**Options**
1062
1063`boolean` values
1064
1065## Inlay hints
1066
1067- Description: Configuration for displaying extra text with hints in the editor.
1068- Setting: `inlay_hints`
1069- Default:
1070
1071```json
1072"inlay_hints": {
1073 "enabled": false,
1074 "show_type_hints": true,
1075 "show_parameter_hints": true,
1076 "show_other_hints": true,
1077 "show_background": false,
1078 "edit_debounce_ms": 700,
1079 "scroll_debounce_ms": 50
1080}
1081```
1082
1083**Options**
1084
1085Inlay hints querying consists of two parts: editor (client) and LSP server.
1086With 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.
1087At 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.
1088
1089The following languages have inlay hints preconfigured by Zed:
1090
1091- [Go](https://docs.zed.dev/languages/go)
1092- [Rust](https://docs.zed.dev/languages/rust)
1093- [Svelte](https://docs.zed.dev/languages/svelte)
1094- [Typescript](https://docs.zed.dev/languages/typescript)
1095
1096Use the `lsp` section for the server configuration. Examples are provided in the corresponding language documentation.
1097
1098Hints are not instantly queried in Zed, two kinds of debounces are used, either may be set to 0 to be disabled.
1099Settings-related hint updates are not debounced.
1100
1101## Journal
1102
1103- Description: Configuration for the journal.
1104- Setting: `journal`
1105- Default:
1106
1107```json
1108"journal": {
1109 "path": "~",
1110 "hour_format": "hour12"
1111}
1112```
1113
1114### Path
1115
1116- Description: The path of the directory where journal entries are stored.
1117- Setting: `path`
1118- Default: `~`
1119
1120**Options**
1121
1122`string` values
1123
1124### Hour Format
1125
1126- Description: The format to use for displaying hours in the journal.
1127- Setting: `hour_format`
1128- Default: `hour12`
1129
1130**Options**
1131
11321. 12-hour format:
1133
1134```json
1135{
1136 "hour_format": "hour12"
1137}
1138```
1139
11402. 24-hour format:
1141
1142```json
1143{
1144 "hour_format": "hour24"
1145}
1146```
1147
1148## Languages
1149
1150- Description: Configuration for specific languages.
1151- Setting: `languages`
1152- Default: `null`
1153
1154**Options**
1155
1156To override settings for a language, add an entry for that languages name to the `languages` value. Example:
1157
1158```json
1159"languages": {
1160 "C": {
1161 "format_on_save": "off",
1162 "preferred_line_length": 64,
1163 "soft_wrap": "preferred_line_length"
1164 },
1165 "JSON": {
1166 "tab_size": 4
1167 }
1168}
1169```
1170
1171The following settings can be overridden for each specific language:
1172
1173- `enable_language_server`
1174- `ensure_final_newline_on_save`
1175- `format_on_save`
1176- `formatter`
1177- `hard_tabs`
1178- `preferred_line_length`
1179- `remove_trailing_whitespace_on_save`
1180- `show_inline_completions`
1181- `show_whitespaces`
1182- `soft_wrap`
1183- `tab_size`
1184- `use_autoclose`
1185- `always_treat_brackets_as_autoclosed`
1186
1187These values take in the same options as the root-level settings with the same name.
1188
1189## Network Proxy
1190
1191- Description: Configure a network proxy for Zed.
1192- Setting: `proxy`
1193- Default: `null`
1194
1195**Options**
1196
1197The proxy setting must contain a URL to the proxy.
1198
1199The following URI schemes are supported:
1200
1201- `http`
1202- `https`
1203- `socks4` - SOCKS4 proxy with local DNS
1204- `socks4a` - SOCKS4 proxy with remote DNS
1205- `socks5` - SOCKS5 proxy with local DNS
1206- `socks5h` - SOCKS5 proxy with remote DNS
1207
1208`http` will be used when no scheme is specified.
1209
1210By 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`.
1211
1212For example, to set an `http` proxy, add the following to your settings:
1213
1214```json
1215{
1216 "proxy": "http://127.0.0.1:10809"
1217}
1218```
1219
1220Or to set a `socks5` proxy:
1221
1222```json
1223{
1224 "proxy": "socks5h://localhost:10808"
1225}
1226```
1227
1228## Preview tabs
1229
1230- Description:
1231 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. \
1232 There are several ways to convert a preview tab into a regular tab:
1233
1234 - Double-clicking on the file
1235 - Double-clicking on the tab header
1236 - Using the `project_panel::OpenPermanent` action
1237 - Editing the file
1238 - Dragging the file to a different pane
1239
1240- Setting: `preview_tabs`
1241- Default:
1242
1243```json
1244"preview_tabs": {
1245 "enabled": true,
1246 "enable_preview_from_file_finder": false,
1247 "enable_preview_from_code_navigation": false,
1248}
1249```
1250
1251### Enable preview from file finder
1252
1253- Description: Determines whether to open files in preview mode when selected from the file finder.
1254- Setting: `enable_preview_from_file_finder`
1255- Default: `false`
1256
1257**Options**
1258
1259`boolean` values
1260
1261### Enable preview from code navigation
1262
1263- Description: Determines whether a preview tab gets replaced when code navigation is used to navigate away from the tab.
1264- Setting: `enable_preview_from_code_navigation`
1265- Default: `false`
1266
1267**Options**
1268
1269`boolean` values
1270
1271## Preferred Line Length
1272
1273- Description: The column at which to soft-wrap lines, for buffers where soft-wrap is enabled.
1274- Setting: `preferred_line_length`
1275- Default: `80`
1276
1277**Options**
1278
1279`integer` values
1280
1281## Projects Online By Default
1282
1283- Description: Whether or not to show the online projects view by default.
1284- Setting: `projects_online_by_default`
1285- Default: `true`
1286
1287**Options**
1288
1289`boolean` values
1290
1291## Remove Trailing Whitespace On Save
1292
1293- Description: Whether or not to remove any trailing whitespace from lines of a buffer before saving it.
1294- Setting: `remove_trailing_whitespace_on_save`
1295- Default: `true`
1296
1297**Options**
1298
1299`boolean` values
1300
1301## Search
1302
1303- Description: Search options to enable by default when opening new project and buffer searches.
1304- Setting: `search`
1305- Default:
1306
1307```json
1308"search": {
1309 "whole_word": false,
1310 "case_sensitive": false,
1311 "include_ignored": false,
1312 "regex": false
1313},
1314```
1315
1316## Show Call Status Icon
1317
1318- Description: Whether or not to show the call status icon in the status bar.
1319- Setting: `show_call_status_icon`
1320- Default: `true`
1321
1322**Options**
1323
1324`boolean` values
1325
1326## Show Completions On Input
1327
1328- Description: Whether or not to show completions as you type.
1329- Setting: `show_completions_on_input`
1330- Default: `true`
1331
1332**Options**
1333
1334`boolean` values
1335
1336## Show Completion Documentation
1337
1338- Description: Whether to display inline and alongside documentation for items in the completions menu.
1339- Setting: `show_completion_documentation`
1340- Default: `true`
1341
1342**Options**
1343
1344`boolean` values
1345
1346## Completion Documentation Debounce Delay
1347
1348- Description: The debounce delay before re-querying the language server for completion documentation when not included in original completion list.
1349- Setting: `completion_documentation_secondary_query_debounce`
1350- Default: `300` ms
1351
1352**Options**
1353
1354`integer` values
1355
1356## Show Inline Completions
1357
1358- Description: Whether to show inline completions as you type or manually by triggering `editor::ShowInlineCompletion`.
1359- Setting: `show_inline_completions`
1360- Default: `true`
1361
1362**Options**
1363
1364`boolean` values
1365
1366## Show Whitespaces
1367
1368- Description: Whether or not to show render whitespace characters in the editor.
1369- Setting: `show_whitespaces`
1370- Default: `selection`
1371
1372**Options**
1373
13741. `all`
13752. `selection`
13763. `none`
13774. `boundary`
1378
1379## Soft Wrap
1380
1381- Description: Whether or not to automatically wrap lines of text to fit editor / preferred width.
1382- Setting: `soft_wrap`
1383- Default: `none`
1384
1385**Options**
1386
13871. `none` to avoid wrapping generally, unless the line is too long
13882. `prefer_line` (deprecated, same as `none`)
13893. `editor_width` to wrap lines that overflow the editor width
13904. `preferred_line_length` to wrap lines that overflow `preferred_line_length` config value
1391
1392## Wrap Guides (Vertical Rulers)
1393
1394- Description: Where to display vertical rulers as wrap-guides. Disable by setting `show_wrap_guides` to `false`.
1395- Setting: `wrap_guides`
1396- Default: []
1397
1398**Options**
1399
1400List of `integer` column numbers
1401
1402## Tab Size
1403
1404- Description: The number of spaces to use for each tab character.
1405- Setting: `tab_size`
1406- Default: `4`
1407
1408**Options**
1409
1410`integer` values
1411
1412## Telemetry
1413
1414- Description: Control what info is collected by Zed.
1415- Setting: `telemetry`
1416- Default:
1417
1418```json
1419"telemetry": {
1420 "diagnostics": true,
1421 "metrics": true
1422},
1423```
1424
1425**Options**
1426
1427### Diagnostics
1428
1429- Description: Setting for sending debug-related data, such as crash reports.
1430- Setting: `diagnostics`
1431- Default: `true`
1432
1433**Options**
1434
1435`boolean` values
1436
1437### Metrics
1438
1439- Description: Setting for sending anonymized usage data, such what languages you're using Zed with.
1440- Setting: `metrics`
1441- Default: `true`
1442
1443**Options**
1444
1445`boolean` values
1446
1447## Terminal
1448
1449- Description: Configuration for the terminal.
1450- Setting: `terminal`
1451- Default:
1452
1453```json
1454{
1455 "terminal": {
1456 "alternate_scroll": "off",
1457 "blinking": "terminal_controlled",
1458 "copy_on_select": false,
1459 "dock": "bottom",
1460 "detect_venv": {
1461 "on": {
1462 "directories": [".env", "env", ".venv", "venv"],
1463 "activate_script": "default"
1464 }
1465 }
1466 "env": {},
1467 "font_family": null,
1468 "font_features": null,
1469 "font_size": null,
1470 "line_height": "comfortable",
1471 "option_as_meta": true,
1472 "button": false,
1473 "shell": {},
1474 "toolbar": {
1475 "title": true
1476 },
1477 "working_directory": "current_project_directory"
1478 }
1479}
1480```
1481
1482### Terminal: Dock
1483
1484- Description: Control the position of the dock
1485- Setting: `dock`
1486- Default: `bottom`
1487
1488**Options**
1489
1490`"bottom"`, `"left"` or `"right"`
1491
1492### Terminal: Alternate Scroll
1493
1494- 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.
1495- Setting: `alternate_scroll`
1496- Default: `off`
1497
1498**Options**
1499
15001. Default alternate scroll mode to on
1501
1502```json
1503{
1504 "terminal": {
1505 "alternate_scroll": "on"
1506 }
1507}
1508```
1509
15102. Default alternate scroll mode to off
1511
1512```json
1513{
1514 "terminal": {
1515 "alternate_scroll": "off"
1516 }
1517}
1518```
1519
1520### Terminal: Blinking
1521
1522- Description: Set the cursor blinking behavior in the terminal
1523- Setting: `blinking`
1524- Default: `terminal_controlled`
1525
1526**Options**
1527
15281. Never blink the cursor, ignore the terminal mode
1529
1530```json
1531{
1532 "terminal": {
1533 "blinking": "off"
1534 }
1535}
1536```
1537
15382. Default the cursor blink to off, but allow the terminal to turn blinking on
1539
1540```json
1541{
1542 "terminal": {
1543 "blinking": "terminal_controlled"
1544 }
1545}
1546```
1547
15483. Always blink the cursor, ignore the terminal mode
1549
1550```json
1551{
1552 "terminal": {
1553 "blinking": "on"
1554 }
1555}
1556```
1557
1558### Terminal: Copy On Select
1559
1560- Description: Whether or not selecting text in the terminal will automatically copy to the system clipboard.
1561- Setting: `copy_on_select`
1562- Default: `false`
1563
1564**Options**
1565
1566`boolean` values
1567
1568**Example**
1569
1570```json
1571{
1572 "terminal": {
1573 "copy_on_select": true
1574 }
1575}
1576```
1577
1578### Terminal: Env
1579
1580- 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
1581- Setting: `env`
1582- Default: `{}`
1583
1584**Example**
1585
1586```json
1587{
1588 "terminal": {
1589 "env": {
1590 "ZED": "1",
1591 "KEY": "value1:value2"
1592 }
1593 }
1594}
1595```
1596
1597### Terminal: Font Size
1598
1599- Description: What font size to use for the terminal. When not set defaults to matching the editor's font size
1600- Setting: `font_size`
1601- Default: `null`
1602
1603**Options**
1604
1605`integer` values
1606
1607```json
1608{
1609 "terminal": {
1610 "font_size": 15
1611 }
1612}
1613```
1614
1615### Terminal: Font Family
1616
1617- Description: What font to use for the terminal. When not set, defaults to matching the editor's font.
1618- Setting: `font_family`
1619- Default: `null`
1620
1621**Options**
1622
1623The name of any font family installed on the user's system
1624
1625```json
1626{
1627 "terminal": {
1628 "font_family": "Berkeley Mono"
1629 }
1630}
1631```
1632
1633### Terminal: Font Features
1634
1635- Description: What font features to use for the terminal. When not set, defaults to matching the editor's font features.
1636- Setting: `font_features`
1637- Default: `null`
1638- Platform: macOS and Windows.
1639
1640**Options**
1641
1642See Buffer Font Features
1643
1644```json
1645{
1646 "terminal": {
1647 "font_features": {
1648 "calt": false
1649 // See Buffer Font Features for more features
1650 }
1651 }
1652}
1653```
1654
1655### Terminal: Line Height
1656
1657- Description: Set the terminal's line height.
1658- Setting: `line_height`
1659- Default: `comfortable`
1660
1661**Options**
1662
16631. Use a line height that's `comfortable` for reading, 1.618. (default)
1664
1665```json
1666{
1667 "terminal": {
1668 "line_height": "comfortable"
1669 }
1670}
1671```
1672
16732. Use a `standard` line height, 1.3. This option is useful for TUIs, particularly if they use box characters
1674
1675```json
1676{
1677 "terminal": {
1678 "line_height": "standard"
1679 }
1680}
1681```
1682
16833. Use a custom line height.
1684
1685```json
1686{
1687 "terminal": {
1688 "line_height": {
1689 "custom": 2
1690 }
1691 }
1692}
1693```
1694
1695### Terminal: Option As Meta
1696
1697- Description: Re-interprets the option keys to act like a 'meta' key, like in Emacs.
1698- Setting: `option_as_meta`
1699- Default: `true`
1700
1701**Options**
1702
1703`boolean` values
1704
1705```json
1706{
1707 "terminal": {
1708 "option_as_meta": true
1709 }
1710}
1711```
1712
1713### Terminal: Shell
1714
1715- Description: What shell to use when launching the terminal.
1716- Setting: `shell`
1717- Default: `system`
1718
1719**Options**
1720
17211. Use the system's default terminal configuration (usually the `/etc/passwd` file).
1722
1723```json
1724{
1725 "terminal": {
1726 "shell": "system"
1727 }
1728}
1729```
1730
17312. A program to launch:
1732
1733```json
1734{
1735 "terminal": {
1736 "shell": {
1737 "program": "sh"
1738 }
1739 }
1740}
1741```
1742
17433. A program with arguments:
1744
1745```json
1746{
1747 "terminal": {
1748 "shell": {
1749 "with_arguments": {
1750 "program": "/bin/bash",
1751 "args": ["--login"]
1752 }
1753 }
1754 }
1755}
1756```
1757
1758## Terminal: Detect Virtual Environments {#terminal-detect_venv}
1759
1760- 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.
1761- Setting: `detect_venv`
1762- Default:
1763
1764```json
1765{
1766 "terminal":
1767 "detect_venv": {
1768 "on": {
1769 // Default directories to search for virtual environments, relative
1770 // to the current working directory. We recommend overriding this
1771 // in your project's settings, rather than globally.
1772 "directories": [".venv", "venv"],
1773 // Can also be `csh`, `fish`, and `nushell`
1774 "activate_script": "default"
1775 }
1776 }
1777 }
1778}
1779```
1780
1781Disable with:
1782
1783```json
1784{
1785 "terminal":
1786 "detect_venv": "off"
1787 }
1788}
1789```
1790
1791## Terminal: Toolbar
1792
1793- Description: Whether or not to show various elements in the terminal toolbar. It only affects terminals placed in the editor pane.
1794- Setting: `toolbar`
1795- Default:
1796
1797```json
1798{
1799 "terminal": {
1800 "toolbar": {
1801 "title": true
1802 }
1803 }
1804}
1805```
1806
1807**Options**
1808
1809At the moment, only the `title` option is available, it controls displaying of the terminal title that can be changed via `PROMPT_COMMAND`. If the title is hidden, the terminal toolbar is not displayed.
1810
1811### Terminal: Button
1812
1813- Description: Control to show or hide the terminal button in the status bar
1814- Setting: `button`
1815- Default: `true`
1816
1817**Options**
1818
1819`boolean` values
1820
1821```json
1822{
1823 "terminal": {
1824 "button": false
1825 }
1826}
1827```
1828
1829### Terminal: Working Directory
1830
1831- Description: What working directory to use when launching the terminal.
1832- Setting: `working_directory`
1833- Default: `"current_project_directory"`
1834
1835**Options**
1836
18371. Use the current file's project directory. Will Fallback to the first project directory strategy if unsuccessful
1838
1839```json
1840{
1841 "terminal": {
1842 "working_directory": "current_project_directory"
1843 }
1844}
1845```
1846
18472. Use the first project in this workspace's directory. Will fallback to using this platform's home directory.
1848
1849```json
1850{
1851 "terminal": {
1852 "working_directory": "first_project_directory"
1853 }
1854}
1855```
1856
18573. Always use this platform's home directory (if we can find it)
1858
1859```json
1860{
1861 "terminal": {
1862 "working_directory": "always_home"
1863 }
1864}
1865```
1866
18674. 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.
1868
1869```json
1870{
1871 "terminal": {
1872 "working_directory": {
1873 "always": {
1874 "directory": "~/zed/projects/"
1875 }
1876 }
1877 }
1878}
1879```
1880
1881## Theme
1882
1883- 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.
1884- Setting: `theme`
1885- Default: `One Dark`
1886
1887### Theme Object
1888
1889- Description: Specify the theme using an object that includes the `mode`, `dark`, and `light` themes.
1890- Setting: `theme`
1891- Default:
1892
1893```json
1894"theme": {
1895 "mode": "system",
1896 "dark": "One Dark",
1897 "light": "One Light"
1898},
1899```
1900
1901### Mode
1902
1903- Description: Specify theme mode.
1904- Setting: `mode`
1905- Default: `system`
1906
1907**Options**
1908
19091. Set the theme to dark mode
1910
1911```json
1912{
1913 "mode": "dark"
1914}
1915```
1916
19172. Set the theme to light mode
1918
1919```json
1920{
1921 "mode": "light"
1922}
1923```
1924
19253. Set the theme to system mode
1926
1927```json
1928{
1929 "mode": "system"
1930}
1931```
1932
1933### Dark
1934
1935- Description: The name of the dark Zed theme to use for the UI.
1936- Setting: `dark`
1937- Default: `One Dark`
1938
1939**Options**
1940
1941Run the `theme selector: toggle` action in the command palette to see a current list of valid themes names.
1942
1943### Light
1944
1945- Description: The name of the light Zed theme to use for the UI.
1946- Setting: `light`
1947- Default: `One Light`
1948
1949**Options**
1950
1951Run the `theme selector: toggle` action in the command palette to see a current list of valid themes names.
1952
1953## Vim
1954
1955- Description: Whether or not to enable vim mode (work in progress).
1956- Setting: `vim_mode`
1957- Default: `false`
1958
1959## Project Panel
1960
1961- Description: Customize project panel
1962- Setting: `project_panel`
1963- Default:
1964
1965```json
1966{
1967 "project_panel": {
1968 "button": true,
1969 "default_width": 240,
1970 "dock": "left",
1971 "file_icons": true,
1972 "folder_icons": true,
1973 "git_status": true,
1974 "indent_size": 20,
1975 "auto_reveal_entries": true,
1976 "auto_fold_dirs": true,
1977 "scrollbar": {
1978 "show": null
1979 }
1980 }
1981}
1982```
1983
1984### Dock
1985
1986- Description: Control the position of the dock
1987- Setting: `dock`
1988- Default: `left`
1989
1990**Options**
1991
19921. Default dock position to left
1993
1994```json
1995{
1996 "dock": "left"
1997}
1998```
1999
20002. Default dock position to right
2001
2002```json
2003{
2004 "dock": "right"
2005}
2006```
2007
2008### Git Status
2009
2010- Description: Indicates newly created and updated files
2011- Setting: `git_status`
2012- Default: `true`
2013
2014**Options**
2015
20161. Default enable git status
2017
2018```json
2019{
2020 "git_status": true
2021}
2022```
2023
20242. Default disable git status
2025
2026```json
2027{
2028 "git_status": false
2029}
2030```
2031
2032### Default Width
2033
2034- Description: Customize default width taken by project panel
2035- Setting: `default_width`
2036- Default: N/A width in pixels (eg: 420)
2037
2038**Options**
2039
2040`boolean` values
2041
2042### Auto Reveal Entries
2043
2044- Description: Whether to reveal it in the project panel automatically, when a corresponding project entry becomes active. Gitignored entries are never auto revealed.
2045- Setting: `auto_reveal_entries`
2046- Default: `true`
2047
2048**Options**
2049
20501. Enable auto reveal entries
2051
2052```json
2053{
2054 "auto_reveal_entries": true
2055}
2056```
2057
20582. Disable auto reveal entries
2059
2060```json
2061{
2062 "auto_reveal_entries": false
2063}
2064```
2065
2066### Auto Fold Dirs
2067
2068- Description: Whether to fold directories automatically when directory has only one directory inside.
2069- Setting: `auto_fold_dirs`
2070- Default: `true`
2071
2072**Options**
2073
20741. Enable auto fold dirs
2075
2076```json
2077{
2078 "auto_fold_dirs": true
2079}
2080```
2081
20822. Disable auto fold dirs
2083
2084```json
2085{
2086 "auto_fold_dirs": false
2087}
2088```
2089
2090### Indent Size
2091
2092- Description: Amount of indentation (in pixels) for nested items.
2093- Setting: `indent_size`
2094- Default: `20`
2095
2096### Scrollbar
2097
2098- Description: Scrollbar related settings. Possible values: null, "auto", "system", "always", "never". Inherits editor settings when absent, see its description for more details.
2099- Setting: `scrollbar`
2100- Default:
2101
2102```json
2103"scrollbar": {
2104 "show": null
2105}
2106```
2107
2108**Options**
2109
21101. Show scrollbar in project panel
2111
2112```json
2113{
2114 "scrollbar": {
2115 "show": "always"
2116 }
2117}
2118```
2119
21202. Hide scrollbar in project panel
2121
2122```json
2123{
2124 "scrollbar": {
2125 "show": "never"
2126 }
2127}
2128```
2129
2130## Assistant Panel
2131
2132- Description: Customize assistant panel
2133- Setting: `assistant`
2134- Default:
2135
2136```json
2137"assistant": {
2138 "enabled": true,
2139 "button": true,
2140 "dock": "right",
2141 "default_width": 640,
2142 "default_height": 320,
2143 "provider": "openai",
2144 "version": "1",
2145},
2146```
2147
2148## Outline Panel
2149
2150- Description: Customize outline Panel
2151- Setting: `outline_panel`
2152- Default:
2153
2154```json
2155"outline_panel": {
2156 "button": true,
2157 "default_width": 240,
2158 "dock": "left",
2159 "file_icons": true,
2160 "folder_icons": true,
2161 "git_status": true,
2162 "indent_size": 20,
2163 "auto_reveal_entries": true,
2164 "auto_fold_dirs": true,
2165}
2166```
2167
2168## Calls
2169
2170- Description: Customize behavior when participating in a call
2171- Setting: `calls`
2172- Default:
2173
2174```json
2175"calls": {
2176 // Join calls with the microphone live by default
2177 "mute_on_join": false,
2178 // Share your project when you are the first to join a channel
2179 "share_on_join": false
2180},
2181```
2182
2183## Unnecessary Code Fade
2184
2185- Description: How much to fade out unused code.
2186- Setting: `unnecessary_code_fade`
2187- Default: `0.3`
2188
2189**Options**
2190
2191Float values between `0.0` and `0.9`, where:
2192
2193- `0.0` means no fading (unused code looks the same as used code)
2194- `0.9` means maximum fading (unused code is very faint but still visible)
2195
2196**Example**
2197
2198```json
2199{
2200 "unnecessary_code_fade": 0.5
2201}
2202```
2203
2204## UI Font Family
2205
2206- Description: The name of the font to use for text in the UI.
2207- Setting: `ui_font_family`
2208- Default: `Zed Plex Sans`
2209
2210**Options**
2211
2212The name of any font family installed on the system.
2213
2214## UI Font Features
2215
2216- Description: The OpenType features to enable for text in the UI.
2217- Setting: `ui_font_features`
2218- Default: `null`
2219- Platform: macOS and Windows.
2220
2221**Options**
2222
2223Zed supports all OpenType features that can be enabled or disabled for a given UI font, as well as setting values for font features.
2224
2225For example, to disable font ligatures, add the following to your settings:
2226
2227```json
2228{
2229 "ui_font_features": {
2230 "calt": false
2231 }
2232}
2233```
2234
2235You can also set other OpenType features, like setting `cv01` to `7`:
2236
2237```json
2238{
2239 "ui_font_features": {
2240 "cv01": 7
2241 }
2242}
2243```
2244
2245## UI Font Fallbacks
2246
2247- Description: The font fallbacks to use for text in the UI.
2248- Setting: `ui_font_fallbacks`
2249- Default: `null`
2250- Platform: macOS and Windows.
2251
2252**Options**
2253
2254For example, to use `Nerd Font` as a fallback, add the following to your settings:
2255
2256```json
2257{
2258 "ui_font_fallbacks": ["Nerd Font"]
2259}
2260```
2261
2262## UI Font Size
2263
2264- Description: The default font size for text in the UI.
2265- Setting: `ui_font_size`
2266- Default: `16`
2267
2268**Options**
2269
2270`integer` values from `6` to `100` pixels (inclusive)
2271
2272## UI Font Weight
2273
2274- Description: The default font weight for text in the UI.
2275- Setting: `ui_font_weight`
2276- Default: `400`
2277
2278**Options**
2279
2280`integer` values between `100` and `900`
2281
2282## An example configuration:
2283
2284```json
2285// ~/.config/zed/settings.json
2286{
2287 "theme": "cave-light",
2288 "tab_size": 2,
2289 "preferred_line_length": 80,
2290 "soft_wrap": "none",
2291
2292 "buffer_font_size": 18,
2293 "buffer_font_family": "Zed Plex Mono",
2294
2295 "autosave": "on_focus_change",
2296 "format_on_save": "off",
2297 "vim_mode": false,
2298 "projects_online_by_default": true,
2299 "terminal": {
2300 "font_family": "FiraCode Nerd Font Mono",
2301 "blinking": "off"
2302 },
2303 "languages": {
2304 "C": {
2305 "format_on_save": "language_server",
2306 "preferred_line_length": 64,
2307 "soft_wrap": "preferred_line_length"
2308 }
2309 }
2310}
2311```