1---
 2title: Icon Themes
 3description: "Icon Themes for Zed extensions."
 4---
 5
 6# Icon Themes
 7
 8Extensions may provide icon themes to change the icons Zed uses for folders and files.
 9
10## Example extension
11
12The [Material Icon Theme](https://github.com/zed-extensions/material-icon-theme) serves as an example for the structure of an extension containing an icon theme.
13
14## Directory structure
15
16There are two important directories for an icon theme extension:
17
18- `icon_themes`: This directory will contain one or more JSON files containing the icon theme definitions.
19- `icons`: This directory contains the icon assets distributed with the extension. You can create subdirectories in this directory as needed.
20
21Each icon theme file should adhere to the JSON schema specified at [`https://zed.dev/schema/icon_themes/v0.3.0.json`](https://zed.dev/schema/icon_themes/v0.3.0.json).
22
23Here is an example icon theme structure:
24
25```json [icon-theme]
26{
27  "$schema": "https://zed.dev/schema/icon_themes/v0.3.0.json",
28  "name": "My Icon Theme",
29  "author": "Your Name",
30  "themes": [
31    {
32      "name": "My Icon Theme",
33      "appearance": "dark",
34      "directory_icons": {
35        "collapsed": "./icons/folder.svg",
36        "expanded": "./icons/folder-open.svg"
37      },
38      "named_directory_icons": {
39        "stylesheets": {
40          "collapsed": "./icons/folder-stylesheets.svg",
41          "expanded": "./icons/folder-stylesheets-open.svg"
42        }
43      },
44      "chevron_icons": {
45        "collapsed": "./icons/chevron-right.svg",
46        "expanded": "./icons/chevron-down.svg"
47      },
48      "file_stems": {
49        "Makefile": "make"
50      },
51      "file_suffixes": {
52        "mp3": "audio",
53        "rs": "rust"
54      },
55      "file_icons": {
56        "audio": { "path": "./icons/audio.svg" },
57        "default": { "path": "./icons/file.svg" },
58        "make": { "path": "./icons/make.svg" },
59        "rust": { "path": "./icons/rust.svg" }
60        // ...
61      }
62    }
63  ]
64}
65```
66
67Each icon path is resolved relative to the root of the extension directory.
68
69In this example, the extension would have this structure:
70
71```
72extension.toml
73icon_themes/
74  my-icon-theme.json
75icons/
76  audio.svg
77  chevron-down.svg
78  chevron-right.svg
79  file.svg
80  folder-open.svg
81  folder.svg
82  rust.svg
83```