What is a Bug?

Bugs are those annoying glitches in Discord that disrupt your experience. Imagine you're in the middle of a voice chat, and the app suddenly crashes, or you're trying to add a reaction to your gaming guild’s announcement, but behold your favorite emoji is cut in half! These bugs can be really frustrating, but Discord is always working to fix them and make sure everything runs smoothly.

How to Complete the Bug Form

Here’s a full breakdown of what information to provide when filling out the bug form.

Example of Submission Form for Bug Reporting

Description

When describing a bug, keep it short and clear, which is usually just a sentence or two. 

For instance, instead of saying “It’s broken” or “It glitches,” try to be specific about what’s happening. This helps us understand the problem better and fix it faster. 

Example: 

When attempting to react to a message, my emojis don't appear.

Example of Bug Description Entry

Steps to Reproduce

Write easy step-by-step instructions on how to make the bug happen. Be descriptive and include any details you feel are important to make the bug occur. Avoid saying things like: “Do Bug!"

Example:
- Hover over a message you want to react to

- Click on the "Add Reaction" button

- Tap an emoji you want to react with

- Observe

Example of Steps to Reproduce Entry

Expected Results

Tell us what you think should be happening instead of the bug. Describe how you believe the feature is supposed to work. The more details you provide, the easier it will be for us to understand and fix the issue.

Example:
After tapping the emoji to react with it would show up on the bottom of the message.

Example of Expected Result Entry

Actual Results

Let us know what's actually happening when the bug occurs. Describe the unexpected behavior you're seeing.

Example: 

When attempting to react to a message, the emoji doesn't appear at the bottom of the message.

Example of Actual Result Entry

Discord Client Info

What version of the Discord app are you experiencing this bug on? You can find this info in your settings. 

If you are having trouble with finding this info, check out this Help Center article.

Example: 

stable 297274 (a779dec) Host 0.0.305 arm64 macOS 14 (23.1.0)

Discord Client Info in User Settings

Debug Logs

These are records of what’s happening behind the scenes in your Discord app. They help us track down and fix issues by showing us where things might be going wrong. It’s important to remember to reproduce the bug before sending your logs.

Mobile

1. Reproduce the bug on your mobile device.

2. Tap the You button in the bottom-right corner.

3. Tap the cogwheel in the upper-right corner.

4. Scroll down to the Support category and  tap Upload Debug Logs to Discord Support to upload your debug logs.

Mobile: Navigate to Settings > Support to find the Upload Debug Logs to Discord Support option 

Desktop

Uploading Debug Logs through Discord

Here's how to upload your Debug Logs through Discord:
1. Open your User Settings by pressing the cogwheel in the bottom-left corner of the desktop app.

2. Select Voice & Video and press the Debugging tab. 

3. Enable Debug Logging by toggling it, then reproduce the bug.  

4. After reproducing the bug, go back into your User Settings.  

5. Press Voice & Video > Debugging tab.

6. Under Debug Logging, select Upload to upload your debug logs. You’ll receive a confirmation message confirming it’s been uploaded.

Desktop: Navigate to User Settings > Voice & Video > Debugging to find the Upload option

Uploading Debug Logs Using File Explorer

You can locate and upload your Debug logs through File Explorer on your desktop computer:

For Windows Users: To find your Debug Logs manually, open File Explorer and enter this path, replacing "username" with your Windows username: C:\Users\*username*\AppData\Roaming\discord\logs

For Mac Users: On macOS, find your Debug Logs by opening Finder > Go > Go to Folder and entering: ~/Library/Application Support/discord/

Attachments

Sometimes bugs are tricky and we need to dig deep to figure out what's causing the problem which is where attachments come in handy. 

Here's some info you can provide to help us get to the bottom of bugs faster and squash those bugs. These types of files are especially helpful for audio, video, screen sharing, and crash-related bugs.

DxDiag

These are reports about your computer's system and drivers. They help us troubleshoot issues with audio, video, and crashes more effectively. 

Please note: these are only available on Windows devices.

1. Press the Windows key + R button on your keyboard to open the Run Dialog Box.

2. Type dxdiag and hit the Enter key on your keyboard. The Diagnostic tool will open, make sure to wait until the green bar has fully loaded.

4. Select the Save All Information button. 

5. Attach the TXT file generated to your Bug Report. 

Run Dialog Box

Screen Recordings

To upload screen recordings, attach the files directly to your Bug Report. Avoid using online storage drive links. Discord’s Support team will not open those links.

How to Report a Bug

Once you are ready to submit a bug, please head to the Discord Support form and select Bug Reporting under “What can we help you with?”. Fill out all of the information as outlined above and then press Submit once you’re ready.

You can always keep track of patch updates and if your bug that you submitted has been fixed, by checking out the Discord Blog.

If you need help troubleshooting an issue or have general questions about Discord, please submit a ticket to our Support Team here.