Creating new Jira bug tickets
Last updated
Was this helpful?
Last updated
Was this helpful?
Bugs are any “obvious errors” on how the product or a feature is functioning as well as any UI issues. If you’re not reporting an obvious error, please file a Story ticket instead. Errors on are not considered bugs.
If you don't already have a Jira account or permissions to create Jira tickets, you can request access through .
Search existing tickets in Jira's "Mattermost" project to confirm your issue isn’t already filed by someone else.
If your issue involves security or if it involves confidential information or customer information, please mark the bug ticket as internal.
Steps to reproduce: How can we reproduce the issue.
Expected behavior: Describe what you’re expecting to see.
Observed behavior: Describe your issue in detail. What did you see happen? Please include relevant error messages and/or screenshots.
Severity: Choose appropriate severity from the drop-down. Severity levels and descriptions are documented .
Labels: Add a customer-bug label if the ticket is based on a customer bug report. Add a community-bug label if the ticket is based on a community bug report.
Environment: There is an Environment field with drop-down options to choose whether the bug was found in Cloud test servers, Cloud production servers, Self-Hosted test servers, Self-Hosted production servers, Desktop app, Mobile app, or in Master/PR testing.
Attachments: Please include screenshots and/or videos of any helpful error messages and snippets of what you are seeing.
Possible fixes: If you can, link to the line of code that might be responsible for the problem.
Add any additional relevant details if it helps make the bug more clear. For example, you can add details on Mattermost server and version, OS and version, Mattermost mobile app version, Mattermost desktop app version, and any notable Mattermost configurations (such as HA, Elasticsearch, image proxy, SSO).
If you know which team would own fixing the bug, you can assign the ticket directly to that team.
Otherwise, you can leave the team Unassigned and the Program Manager assigns the ticket. The Program Manager follows the ~Bugs channel on a daily basis.
Regression: Please re-test your issue (if possible) on the previous Mattermost version at to see if the bug is a recent regression.