themes.md

 1---
 2title: Themes - Zed
 3description: Browse, install, and create themes for Zed. Includes built-in themes and community theme extensions.
 4---
 5
 6# Themes
 7
 8Zed comes with a number of built-in themes, with more themes available as extensions.
 9
10## Selecting a Theme
11
12See what themes are installed and preview them via the Theme Selector, which you can open from the command palette with `theme selector: toggle` (bound to {#kb theme_selector::Toggle}).
13
14Navigating through the theme list by moving up and down will change the theme in real time and hitting enter will save it to your settings file.
15
16## Installing more Themes
17
18More themes are available from the Extensions page, which you can access via the command palette with `zed: extensions` or the [Zed website](https://zed.dev/extensions?filter=themes).
19
20Many popular themes have been ported to Zed, and if you're struggling to choose one, visit [zed-themes.com](https://zed-themes.com), a third-party gallery with visible previews for many of them.
21
22## Configuring a Theme
23
24Your selected theme is stored in your settings file.
25You can open your settings file from the command palette with {#action zed::OpenSettingsFile} (bound to {#kb zed::OpenSettingsFile}).
26
27By default, Zed maintains two themes: one for light mode and one for dark mode.
28You can set the mode to `"dark"` or `"light"` to ignore the current system mode.
29
30```json [settings]
31{
32  "theme": {
33    "mode": "system",
34    "light": "One Light",
35    "dark": "One Dark"
36  }
37}
38```
39
40## Theme Overrides
41
42To override specific attributes of a theme, use the `theme_overrides` setting.
43This setting can be used to configure theme-specific overrides.
44
45For example, add the following to your `settings.json` if you wish to override the background color of the editor and display comments and doc comments as italics:
46
47```json [settings]
48{
49  "theme_overrides": {
50    "One Dark": {
51      "editor.background": "#333",
52      "syntax": {
53        "comment": {
54          "font_style": "italic"
55        },
56        "comment.doc": {
57          "font_style": "italic"
58        }
59      },
60      "accents": [
61        "#ff0000",
62        "#ff7f00",
63        "#ffff00",
64        "#00ff00",
65        "#0000ff",
66        "#8b00ff"
67      ]
68    }
69  }
70}
71```
72
73To see a comprehensive list of list of captures (like `comment` and `comment.doc`) see [Language Extensions: Syntax highlighting](./extensions/languages.md#syntax-highlighting).
74
75To see a list of available theme attributes look at the JSON file for your theme.
76For example, [assets/themes/one/one.json](https://github.com/zed-industries/zed/blob/main/assets/themes/one/one.json) for the default One Dark and One Light themes.
77
78## Local Themes
79
80Store new themes locally by placing them in the `~/.config/zed/themes` directory (macOS and Linux) or `%USERPROFILE%\AppData\Roaming\Zed\themes\` (Windows).
81
82For example, to create a new theme called `my-cool-theme`, create a file called `my-cool-theme.json` in that directory.
83It will be available in the theme selector the next time Zed loads.
84
85## Theme Development
86
87See: [Developing Zed Themes](./extensions/themes.md)