Create Bug Reports for Discourse on Meta

A bug report means something is broken, preventing normal/typical use of Discourse.

How to report a bug in Discourse

  1. Make sure the bug isn’t already resolved. Search for similar issues in the bug category.

  2. Make sure you can reproduce your problem on the default sandbox at

  • If you’re also testing on your own Discourse development instance, be sure to use the Master release branch, aka the Tests Passed channel.
  • If possible, submit a Pull Request with a failing test, or;
  • if you’d rather take matters into your own hands, try fix the bug yourself
    (you need to read up on the Discourse Development Contribution Guidelines for these last two.).
  1. Make a report of everything you know about the bug so far by opening a topic on the bug category. Make sure to include reproducible steps.

When the bug is fixed, you can usually expect to see an update posted on the reporting topic.