@@ -1,39 +1,50 @@
-name: Report an issue
-description: Report an issue with Zed.
+name: Report a bug
+description: Report a problem with Zed.
type: Bug
labels: "state:needs triage"
body:
- type: markdown
attributes:
value: |
- Feature requests should be opened in [discussions](https://github.com/zed-industries/zed/discussions/new/choose).
+ 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.
- Before opening a new issue, please do a [search](https://github.com/zed-industries/zed/issues) of existing issues and :+1: upvote the existing issue instead. This will help us maintain a proper signal-to-noise ratio.
+ Feature request? Please open in [discussions](https://github.com/zed-industries/zed/discussions/new/choose) instead.
- If you need help with your own project, you can ask a question in our [Discord Support Forums](https://discord.com/invite/zedindustries).
+ Just have a question or need support? Welcome to [Discord Support Forums](https://discord.com/invite/zedindustries).
- type: textarea
attributes:
label: Reproduction steps
- description: A step-by-step description of how to reproduce the issue from a **clean Zed install**. Any code must be sufficient to reproduce (make sure to include context!). Include code as text, not just as a screenshot. **Issues with insufficient detail may be summarily closed**.
+ 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.
placeholder: |
1. Start Zed
2. Click X
- 3. Y will happen
validations:
required: true
- type: textarea
attributes:
label: Current vs. Expected behavior
description: |
- A clear and concise description of what is the current behavior (screenshots, videos), vs. what you expected the behavior to be.
+ Current behavior (screenshots, videos, etc. are appreciated), vs. what you expected the behavior to be.
- **Skipping this/failure to provide complete information will result in the issue being closed.**
- placeholder: "Based on my reproduction steps above, when I click X, I expect this to happen, but instead Y happens."
+ placeholder: |
+ 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.
+ validations:
+ required: true
+ - type: textarea
+ attributes:
+ label: Zed version and system specs
+ description: |
+ Open the command palette in Zed, then type “zed: copy system specs into clipboard”.
+ placeholder: |
+ Zed: v0.215.0 (Zed Nightly bfe141ea79aa4984028934067ba75c48d99136ae)
+ OS: macOS 15.1
+ Memory: 36 GiB
+ Architecture: aarch64
validations:
required: true
- type: textarea
attributes:
- label: If applicable, attach your Zed log file to this issue.
+ label: Attach Zed log file
description: |
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.
value: |
@@ -49,7 +60,7 @@ body:
required: false
- type: textarea
attributes:
- label: If applicable, attach your relevant Zed settings to this issue
+ label: Relevant Zed settings
description: |
Open the command palette in Zed, then type “zed: open settings file” and copy/paste any relevant (e.g., LSP-specific) settings.
value: |
@@ -65,7 +76,7 @@ body:
required: false
- type: textarea
attributes:
- label: If applicable, provide details about your model provider
+ label: (for AI issues) Model provider details
placeholder: |
- Provider: (Anthropic via ZedPro, Anthropic via API key, Copilot Chat, Mistral, OpenAI, etc.)
- Model Name: (Claude Sonnet 4.5, Gemini 3 Pro, GPT-5)
@@ -73,18 +84,6 @@ body:
- Other details (ACPs, MCPs, other settings, etc.):
validations:
required: false
- - type: textarea
- attributes:
- label: Zed version and system specs
- description: |
- Open the command palette in Zed, then type “zed: copy system specs into clipboard”. **Skipping this/failure to provide complete information will result in the issue being closed**.
- placeholder: |
- Zed: v0.215.0 (Zed Nightly bfe141ea79aa4984028934067ba75c48d99136ae)
- OS: macOS 15.1
- Memory: 36 GiB
- Architecture: aarch64
- validations:
- required: true
- type: dropdown
attributes:
label: If you are using WSL on Windows, what flavor of Linux are you using?
@@ -97,4 +96,3 @@ body:
- Pop!_OS
- NixOS
- Other
- default: 0