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.

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:

Template Purpose
Fuchsia Default Alert the Fuchsia team that there is a bug related to using or building Fuchsia.
Fuchsia Security external bug report Report a security issue related to Fuchsia. Documentation Alert the Documentation team that there is an issue related to
Open Source Review Board Propose open source external code to be included in Fuchsia. Review the Open Source Review Board (OSRB) process before filing an issue with the Open Source Review Board (OSRB).
Report Community Abuse Alert Community Managers about any violations of the Code of Conduct that you may have experienced in the Fuchsia community.

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

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:

Scenario Process
Proposing a change that would significantly affect the Fuchsia API. Create an API Design Document. For more information, see Fuchsia API Council Charter.
Proposing a change that would affect a large part of the Fuchsia codebase or the technical direction of the Fuchsia project. Propose a Request for Comments (RFC). For more information on RFCs, see Create an RFC.