Best practices, tips and tricks for effective bug reporting.
These issues are not considered bugs:
- Functionality which works as intended but could be improved.
- Crashes running out of memory.
- Crashes from loading corrupted Blend files.
In addition to the content on this page, here is a video on How to Report a Bug:
Avoid Walls of Text
Please, avoid copy/pasting the content of text files like system-info, debug/console/command line output, scripts directly in the report's Description field. It makes the report difficult to read and breaks up the formatting. Include them as files instead (.txt). On how to include files, look at the Appending files to the report section.
Bugs in Blender or Add-ons included with Blender can be reported at developer.blender.org, through links on the front page. You will need an account, so that developers can follow up with questions and notify you when the bug is fixed. You will receive an email each time there is an update to the bug report.
The bug report page has concise instructions and a template for creating reports. More advice on how to create good reports is listed below. Following these steps will make life easier for you, the user, and us, the developers.
Before you think of posting any bug report, consult first the bug tracker for an existing report on the bug you have spotted. Make sure you search from all bug reports, also closed and deleted ones.
It may very well be that the bug has already been spotted.
First try to simplify the process that triggers the bug, so that it is reproducible in the least amount of steps. The less steps there are, the easier it is for us to spot the problem in the code. Typically if you have a complex .blend file, it is possible to keep removing objects, modifiers, nodes, and other data until the problem has been isolated to a simple setup.
Very important is, that the bug is reproducible, that is, not occurring on a random basis. It is fine if the bug randomly happens for example 1 out of 10 times you perform some operation. However if the bug randomly happens without any clear steps leading up to it, then it is unlikely developers will be able to fix the bug.
A .blend or screenshot illustrating the bug will help to speed up the process. As in the previous paragraph, make them as simple as possible, so that the developers can spot the problem without too much effort.
You can even provide a backtrace which lead to possible crash. That may help developers as well. A backtrace is not necessary and producing a useful one requires special debug build and a debugger.
How to Append Files to the Report
Files like .blend, .txt, images can be included into the report by dragging and dropping them into the Description field. At the bottom of the bug report page, there is a Preview of how the report will look like when posted. If everything is OK, a link will show up with the file name. In the Description field itself, the file is represented by a set of letters and numbers in brackets. To move the link to an appropriate place if needed, cut and paste it and be sure that there are spaces between it and the rest of the text.
If you include a screencast of a problem make sure it is as short and clear as possible, edit it if necessary. A video is not the main way to convey information, but can be used as support.
Apart from the actual bug report it is always good (if not necessary) to include operating system, software (drivers) and hardware specifications of your configuration. Some bugs can be related to either area and including this information can help the developers to pinpoint problems better. And let's not forget mentioning what Blender version you are using. Please look in the splash top right corner for all build details and include that as well.
How to Provide System Information
system-info.txt generated from the Help > Save System Info Menu will give information about the OS, hardware, drivers, Blender version and add-ons enabled.
For anyone willing to help with bug triaging please follow the Bug Triaging Playbook.