Report an issue

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

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

When to file an issue

Monorail 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 New Issue.
  3. Select one of the following templates from the Template dropdown:
    1. Fuchsia Default
    2. Fuchsia Security external bug report
    3. Documentation
    4. Open Source Review Board
    5. Report Community Abuse
  4. Complete the questions associated with the template you selected.
  5. Click Submit Issue.

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: