1name: Report a bug
2description: Report a problem with Zed.
3type: Bug
4labels: "state:needs triage"
5body:
6 - type: markdown
7 attributes:
8 value: |
9 Is this bug already reported? Upvote to get it noticed faster. [Here’s the search](https://github.com/zed-industries/zed/issues). Upvote means giving it a :+1: reaction.
10
11 Feature request? Please open in [discussions](https://github.com/zed-industries/zed/discussions/new/choose) instead.
12
13 Just have a question or need support? Welcome to [Discord Support Forums](https://discord.com/invite/zedindustries).
14 - type: textarea
15 attributes:
16 label: Reproduction steps
17 description: A step-by-step description of how to reproduce the bug from a **clean Zed install**. The more context you provide, the easier it is to find and fix the problem fast.
18 placeholder: |
19 1. Start Zed
20 2. Click X
21 validations:
22 required: true
23 - type: textarea
24 attributes:
25 label: Current vs. Expected behavior
26 description: |
27 Current behavior (screenshots, videos, etc. are appreciated), vs. what you expected the behavior to be.
28
29 placeholder: |
30 Current behavior: <screenshot with an arrow> The icon is blue. Expected behavior: The icon should be red because this is what the setting is documented to do.
31 validations:
32 required: true
33 - type: textarea
34 id: environment
35 attributes:
36 label: Zed version and system specs
37 description: |
38 Open the command palette in Zed, then type “zed: copy system specs into clipboard”.
39 placeholder: |
40 Zed: v0.215.0 (Zed Nightly bfe141ea79aa4984028934067ba75c48d99136ae)
41 OS: macOS 15.1
42 Memory: 36 GiB
43 Architecture: aarch64
44 validations:
45 required: true
46 - type: textarea
47 attributes:
48 label: Attach Zed log file
49 description: |
50 Open the command palette in Zed, then type `zed: open log` to see the last 1000 lines. Or type `zed: reveal log in file manager` in the command palette to reveal the log file itself.
51
52 ⚠️ **Please review your log file for secrets (API keys, tokens, etc.) and partially or fully redact them before posting.**
53 value: |
54 <details><summary>Zed.log</summary>
55
56 <!-- Paste your log inside the code block. -->
57 ```log
58
59 ```
60
61 </details>
62 validations:
63 required: false
64 - type: textarea
65 attributes:
66 label: Relevant Zed settings
67 description: |
68 Open the command palette in Zed, then type “zed: open settings file” and copy/paste any relevant (e.g., LSP-specific) settings.
69
70 ⚠️ **Please review your settings file for secrets (API keys, tokens, etc.) and partially or fully redact them before posting.**
71 value: |
72 <details><summary>settings.json</summary>
73
74 <!-- Paste your settings inside the code block. -->
75 ```json
76
77 ```
78
79 </details>
80 validations:
81 required: false
82 - type: textarea
83 attributes:
84 label: Relevant Keymap
85 description: |
86 Open the command palette in Zed, then type “zed: open keymap file” and copy/paste the file’s contents.
87 value: |
88 <details><summary>keymap.json</summary>
89
90 <!-- Paste your keymap file inside the code block. -->
91 ```json
92
93 ```
94
95 </details>
96 validations:
97 required: false
98 - type: textarea
99 attributes:
100 label: (for AI issues) Model provider details
101 placeholder: |
102 - Provider: (Anthropic via ZedPro, Anthropic via API key, Copilot Chat, Mistral, OpenAI, etc.)
103 - Model Name: (Claude Sonnet 4.5, Gemini 3.1 Pro, GPT-5)
104 - Mode: (Agent Panel, Inline Assistant, Terminal Assistant or Text Threads)
105 - Other details (ACPs, MCPs, other settings, etc.):
106 validations:
107 required: false
108 - type: dropdown
109 attributes:
110 label: If you are using WSL on Windows, what flavor of Linux are you using?
111 multiple: false
112 options:
113 - Arch Linux
114 - Ubuntu
115 - Fedora
116 - Mint
117 - Pop!_OS
118 - NixOS
119 - Other