How do I report a broken site in Firefox desktop?

Firefox Firefox Last updated: 02/22/2024 40% of users voted this helpful
No one has helped translate this article yet. If you already know how localizing for SUMO works, start translating now. If you want to learn how to translate articles for SUMO, please start here.

Enhanced Tracking Protection sometimes causes websites to display or work incorrectly. For example, some buttons may not work, parts of some pages may be missing, and some pages may not load at all. Reporting any problems caused by content blocking helps us improve Firefox.

Follow these steps, when necessary, to report a site that isn’t working properly:

  1. Click the shield Fx91ShieldIcon-Blue in the address bar to open the Protections panel.
  2. Click the blue toggle switch Fx91ETPbluetoggle to turn off protections.
    The site will reload with Enhanced Tracking Protection turned off.
  3. If this fixed the problem, click the shield Fx91shield-ETPoff to open the Protections panel again.
  4. Click Site fixed? Send report to let Firefox know.
    It will open the Report a Broken Site panel.
  5. Describe the problem to help us solve the problem faster. (Optional.)
  6. Click the Send Report button.

When you report breakage, Mozilla receives the following information:

  • Website URL (without query strings to avoid identifying your activity on the site)
  • Operating system on the device
  • Version of Firefox that you’re using
  • Description of the problem that you’ve typed in the text box
  • Your Firefox privacy settings:
    • Enhanced Tracking Protection (On, Off or Only in private browsing)
    • Your protection level (Standard, Strict or Custom)
    • Third-party tracking cookies (Blocked or Allowed)
    • Which third-party tracking cookie block list is being used (Level 1 or Level 2)
    • Fingerprinting (Blocked or allowed)
    • Cryptomining (Blocked or allowed)
    • Other third-party cookies (Always blocked, Never blocked or Blocked from unvisited websites)
    • Custom referrer settings from about:config
    • If cookies are set to expire at the end of your session
    • How long third-party storage will be kept

Are you experiencing issues with a webpage that works fine in other browsers but not in Firefox? This could be a web compatibility (webcompat) issue. Common signs include:

  • Slow or non-functional sites
  • Broken images or videos
  • Malfunctioning buttons, links, and text boxes
  • Missing content
  • Issues with signing in or password autofill
  • Problems when using an ad blocker

To proactively combat these web compatibility issues, Firefox has integrated a user-friendly reporting tool directly into the browser. This tool enables users to swiftly report issues related to content blocking, thereby aiding in the enhancement of Firefox's performance and user experience.

To ensure your privacy, the reporting tool allows you to edit the URL before reporting, enabling you to remove any personal information from the URL. For detailed information and precautions, turn to the Protect your information section detailed later in this article.

How can I access the Report broken site tool?

If a site seems broken due to web compatibility or Enhanced Tracking Protection-related issues, you can report it directly to the Webcompat team. To report a non-Firefox site that isn’t working properly, follow these steps:

  1. At the top right, click the menu button Fx89menuButton to open the Firefox menu.
  2. At the bottom of the menu, select the Report broken site option option.
  3. Next, enter the site URL, pick an option from the dropdown menu under What's broken?, and, optionally, add a short description of the issue.
    Report broken site panel
  4. To submit your report, click Report broken site panel Send button.
  5. A success message will confirm your submission. To conclude, click Report broken site panel Close button.
    Report broken site panel Success message

The reporting tool will not work on a new tab or about: Firefox page.

For Nightly and Beta channel users: You can send a detailed report using the Send more info link, located at the lower end of the Report a broken site panel.

What information does Mozilla collect from your report?

We wish to keep our process as transparent as possible. Any reports you send to Mozilla with this tool will include the following information when we receive it via our data pipeline:

  • uuid: A single-use Unique User ID that helps us identify the specific report in our data pipeline. This is not tied to your Firefox profile in any way and cannot be used to identify you. If you submit multiple reports, it will be a different uuid each time.
  • reported_at: The timestamp when our pipeline receives your report
  • comments: Any notes you would like to share with us in the optional Describe the problem box.
  • url = The URL of the site you are reporting. While the feature automatically populates the text field with the URL of the site you are currently on when you select Report Broken Site, you will be able to edit it prior to submitting the report.
  • breakage_category = The answer you chose from the Choose reason dropdown menu
  • details
    • Device (Operating system, version, screen dimensions, & touchscreen capability)
    • User Agent String (Mozilla version, Gecko version, Firefox version and build date)
    • Graphics (GPU model, version, and rendering capabilities)
    • Privacy settings
      • If you’re submitting a report from a Private Browsing window
      • If Firefox site isolation (Fission) is turned on
      • If Total Cookie Protection is turned on
      • Enhanced Tracking Protection (On, Off, or Only in private browsing)
      • Your protection level (Standard, Strict, or Custom)
      • Third-party tracking cookies (Blocked or Allowed)
      • Which third-party tracking cookie block list is being used (Level 1 or 2)
      • Fingerprinting (Blocked or allowed)
      • Cryptomining (Blocked or allowed)
      • Other third-party cookies (Always blocked, Never blocked, or Blocked from unvisited websites)
      • Custom referrer settings from about:config
      • If cookies are set to expire at the end of your session
      • How long third-party storage will be kept
    • Security settings (Any antivirus software, antispyware, or firewalls installed)
    • Languages used for Firefox, and
    • Any details you share in the optional Describe the problem text box

Protect your information

Customizable URL

The Report broken site tool pre-fills the URL of the site you're reporting. Beware, some URLs might contain sensitive data, such as shipping details or personal tax information. To protect your privacy, edit the URL to omit personal details. Note, however, that changes to the URL might hinder our issue reproduction efforts.

Optional Describe the Problem Text Box

If you believe additional details in the Describe the Problem area could help resolve your web compatibility issue, feel free to include them. However, carefully consider the information you share. We implement measures to protect your data temporarily before it's securely discarded, but submitting sensitive information is ultimately your choice. Your contributions are crucial to our Webcompat team's efforts in improving Firefox. Providing extra context, including thorough responses to What’s broken?, aids us in identifying and rectifying major problems that negatively affect your browsing.

What will Firefox do with your report?

When you submit a Report broken site form, it's emailed to the Firefox Webcompat team and entered into a secure internal database accessible only to them. The team reviews these reports, actively filtering for and sanitizing any potentially sensitive personal information before sharing it with other Mozilla staff involved in issue resolution. Access to this data is strictly limited to Mozilla employees. Post-sanitization, the intention is to keep the data for trend analysis and compiling aggregated user statistics, ensuring it's eventually disposed of securely.

Related content

To learn more about the privacy principles that guide Mozilla's mission, visit:

Was this article helpful?

Please wait...

These fine people helped write this article:

Illustration of hands


Grow and share your expertise with others. Answer questions and improve our knowledge base.

Learn More