Report A Website Issue

Once upon a time there was an issue on a website. Something is behaving differently in your favorite browser and not in another one. A menu is not working; the layout is a bit off; you click or tap on this link but it doesn't respond. This seems like a good time to file a bug report on! Since we can’t fix every issue on the web, we have tools and recommendations to help you understand what issues are not in the scope of this project.

How To Report An Issue?

The goal of reporting an issue is to give all the possible information that will help someone without any context to understand, reproduce and eventually diagnose the symptoms of this issue.

When reporting an issue directly on or through external tools, you will always end up on the webcompat multi-step form. Take time to be precise and to guide us through the steps that will make it possible to reproduce the issue.

A short walk-through for the multi-step form is listed below.

  1. Enter the exact site URL.
  2. Image of url step

  3. Select type of the issue.
  4. Image of issue type step

  5. Confirm your browser or modify the browser information if you are reporting an issue for another browser.

    Image of browser step

  6. If possible, make sure you test in another browser before reporting. It may be that the web site simply has an issue no matter which browser is used. These are not web compatibility issues.

    Image of different browser step

  7. List the steps you need to take in order to get to the issue. This includes which links you click, what you type into form inputs, and so on. Don't be shy! Be as precise as you can, as there are often multiple ways to do such simple-seeming things as log into a site or view an online shopping cart.

    Image of description step

  8. Upload screenshot of the page, or just the area of the page highlighting the issue, is one of the best ways to communicate the problem you experienced. Be mindful about screenshots containing private information about yourself or others (such as social network private pages or bank sites).

    Image of screenshot step

  9. Last step! You can report the issue anonymously or with your Github username. (We use the GitHub issue reporting system behind-the-scenes for When you are identified, we can better follow-up with you if there are additional information required to understand the issue. Anonymous issues which lack details will be closed when we can't reproduce the issue and do diagnosis.

    Image of the final step

Tools To Report An Issue

There are basically three ways of reporting an issue depending on your browser.

The Form

The webcompat report form is the main avenue to report an issue.

Web Extensions Reporter for Firefox (normal and beta releases) Reporter for Chrome

We do not have currently an extension for Chrome on Android and Safari on iOS, you are welcome to contribute to the project, see Support reporting issues from iOS browsers and Chrome for Android.

In Browser

You can find "Report site issue" button in Firefox Beta, Firefox Nightly an Firefox Developer Edition on desktop and in Firefox for Android Beta, Firefox for Android Nightly, Firefox on iOS on mobile.

On Firefox Desktop, "Report Site Issue" button is located in the "Help" submenu of the Application menu. Once selected, it automatically brings you to the webcompat reporting form with pre-filed data about your configuration.

Screenshot of Help menu in Firefox browser

On Firefox on Android or iOS you can tap the three dot menu and locate the Report Site Issue button in the list.

Screenshot of three dot menu in mobile Firefox browser on Android

Other browser vendors are welcome to provide a way to automatically report issues to in a similar fashion in their pre-release versions. Open an issue on the project.

Is It Really A Web Compatibility Issue?

In general there are four type of issues:

  1. Website issues, including layouts, features or content. is the right place! Not all site issues are valid Web Compatibility issues. Network issues, ads and script blockers, flash requirements for every browser are likely not compatibility issues.
  2. Deceptive websites (scams, malware). You can report them to the Report Phishing Page.
  3. Issues with the user interface of the browser itself and not the content of a website. These suggestions should be reported directly to the browser vendor.
  4. Add-ons or web extensions. Report these issue directly to the creator of the extension.