Contributor Guide
  • Contributor Guide
  • Localization
    • Translations
      • Spanish Style Guide
        • Glosario de términos
        • Prácticas recomendadas
        • Errores comunes de traducción
  • Development
    • Proposing Code Changes
    • Reviewing Code
    • Developer Tools
  • Feedback
    • Reporting Issues
      • Inspecting Crashes
      • Retrieving Logs
    • Creating Feature Requests
    • Starting Discussions
Powered by GitBook
On this page
  • Using The Feedback App
  • Creating a New Issue Report
  • Be Specific In The Summary
  • Describe The Problem Objectively
  • Be Prepared To Provide More Information
  • You Can Get a Bit of Help

Was this helpful?

Edit on GitHub
Export as PDF
  1. Feedback

Reporting Issues

elementary uses GitHub to track issue reports and feature requests publicly. You can send feedback to the team to inform us of a problem you encountered or an improvement that you would like to see.

PreviousDeveloper ToolsNextInspecting Crashes

Last updated 10 months ago

Was this helpful?

Using The Feedback App

To get started with issue reporting, open "System Settings" and navigate to the "System" page. Select "Send Feedback", which will open the Feedback app. From here, choose a category that best describes the general area of the issue, and then choose a specific project to open a new issue against. This will open your web browser to the relevent GitHub page where you can view and create new issue reports.

If you can't find a specific project or aren't sure which project to file against, that's okay! Do your best and if the issue report needs to be migrated to a different project, a bug manager will take care of it for you.

You can also see a list of all elementary Github projects on and search for projects here. When you've found the project you'd like to open a new report against, open it and then select the "Issues" tab.

Creating a New Issue Report

When filing a new report, it's a good idea to search the issue list to make sure your report hasn't been filed already. If your report has already been filed by someone else, you should add the 👍️ reaction to the report to indicate that you are also affected.

Only comment on an existing issue report if you can provide additional useful information that may help track down the source of the issue. Do not comment things like "I have this problem too" or "This is a really important issue"

If your report has not already been filed, select the green "New Issue" button at the top right corner of the "Issues" page. Keep in mind the following information while filing your report:

Be Specific In The Summary

This will be the title of the issue on the issues page. It's important to be specific because it makes it much easier for a developer or bug manager to search the issue list and helps avoid duplicate reports.

❌️ "Performance is bad"

This summary is too vague and could possibly describe a number of different issues.

✅️ "UI is unresponsive while importing"

This summary describes the specific case where we're experiencing a performance issue and what that issue is in a concise way.

Your issue summary should also not include things in brackets like "[bug]" or "[feature request]". elementary uses labels to categorize issue reports.

Describe The Problem Objectively

The most important thing for an issue report is making sure that a developer will be able to understand and reproduce the issue that you're facing. Describe what happened and contrast it with what you expected to happen instead. If necessary, include exact numbered steps to reproduce the issue.

❌️ "Queuing is unintitive. I don't like the way it works"

This description leaves too much room for interpretation and doesn't specifically describe a problem that can be resolved.

✅️ "When I add items to the queue, they appear at the top. I expected them to appear at the bottom instead"

This describes a problem in a way that is actionable and objective and explains how to reproduce the issue.

Be Prepared To Provide More Information

If your report does not contain enough information for a developer to reproduce the issue, it may be labeled as "Incomplete". If it is, a developer will make a comment requesting additional specific information. If you do not provide that information, your report will eventually be closed since it is unable to be acted upon as filed.

You Can Get a Bit of Help

Include relevant information like your OS version or any modifications you've made to the system (like changing your window manager or kernel). If you're reporting a crash, make sure to

If you're not sure about anything above, you are always welcome to chat with community members and developers in . We might be able to help you track down the project where you should report an issue, or perhaps even aid you with any English language issue you might come across. Most developers want to help you make good bug reports.

this page
include a backtrace.
Discord