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 and 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?

Issues that fall into the web compatibility category are related to layout, content, features or site functionality and occur in one browser, but not in another, for various reasons.

Therefore, we're looking for reports that represent differences in how browsers render web content with this principle in mind.

For example:
  1. Missing elements on the page in Chrome, but not in Firefox.
  2. Can't access a site due to Safari on iOS being unsupported.
  3. Video or audio doesn't play.
  4. The desktop version of the site is displayed on Firefox for Android, but Chrome receives the mobile layout.
  5. Buttons or links don't respond to clicks or taps.
  6. Can't log in or constantly being logged out in Firefox, but it works in Edge.
  7. Animation on a website is slow in one browser but fast in another.

Note that network issues, tracking, ads and script blockers, are likely not compatibility issues.

Issues that are not related to web compatibility efforts and will be closed:

  1. Issues that are reproducible in all browsers. Likely this is a website issue and author or owner of the website should be notified instead.
  2. 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.
  3. Add-ons or web extensions. Report these issues directly to the creator of the extension.
  4. Deceptive websites (phishing, scam, malware). You can report such sites to the Report Phishing Page.
  5. Illegal content on the website. The best would be to report to your local authorities as we're not in a position to act on these issues.
  6. Incorrect or inaccurate content. The best course of action is to get in touch with the author/owner of the website and let them know.

Machine Learning for detecting invalid reports

We have added a machine learning bot into our workflow to help with incoming reports triage. The bot analyses content of the reports and classifies them as valid or invalid based on the historical data. Invalid reports are closed automatically without human involvement.

If your report was closed by the bot, there are three possible reasons:

  1. It falls into a category that is outside the scope of this project. Please take a closer look at the section describing web compatibility issues in detail.
  2. The problem you're experiencing has already been reported, and we received a lot of duplicates. In this case, you could search for the domain in question on our GitHub page to look for similar reports and get updated information on their status.
  3. It was closed by mistake. While these cases are rare, there is still a possibility that the bot classified your report as invalid mistakenly. If you think it was closed by mistake, you could file another one using "Report via GitHub" option instead of "Report anonymously". Reports from authenticated users don't get triaged by the bot.