Report an issue

Filing issues is a great way to contribute to the Fuchsia project. You can file an issue using Issue Tracker, Google’s issue tracking tool for open source projects.

Note: You need a Google account to file an issue in Issue Tracker.

When to file an issue

Issue Tracker issues are used to track and suggest the following types of changes:

  • Minor changes or suggestions to Fuchsia's code and documentation.
  • Reporting security issues
  • Proposing open source third-party code to be included in Fuchsia

For proposing code changes that would affect Fuchsia significantly, see Propose significant code changes.

As an open source contributor, you can file a issue with the following templates:

How to file an issue

To file an issue in Fuchsia, do the following:

  1. Go to
  2. Click Create Issue.
  3. Select one of the following components from the Component dropdown:
    1. For Fuchsia Default template, select Fuchsia
    2. For Fuchsia Security bug report template, select Fuchsia > Security > Vulns
    3. For Documentation template, select Fuchsia > Documentation
    4. For Open Source Review Board template, select Fuchsia > OSRB
    5. For Report Community Abuse template, select Fuchsia > Community
  4. Select the template from the Template dropdown if not already defaulted to above named template
  5. Complete the questions associated with the template you selected.
  6. Click Create.

Issue reporting guidelines

When you create an issue, include the following:

  • A description of the issue that you’re experiencing, including the expected behavior.
  • The steps necessary to reproduce the issue.
  • (Optional) Screenshots
  • (Optional) If a bug can be identified through a unit test, then create a simplified test and attach it to the issue.

Issue resolution

After you have filed an issue, a team of triagers will route your issue to the appropriate team. That team is responsible for prioritizing, assigning, and responding to your issue.

Propose significant code changes {:#significant-code-changes}

There are some instances where filing an issue would not be the best course of action. Here are a few examples of alternative courses of action: