Skip to content

Use the Troubleshooting Information page to help fix Waterfox issues

Waterfox includes a Troubleshooting Information page with some problem-solving tools, details about your Waterfox installation and other technical data, such as any installed extensions, important modified preferences and graphics information. If you are getting help on the subreddit, content you provide from this page can help resolve your Waterfox issue.

To access the Troubleshooting Information page: Click the menu button menu button, click Help and select More Troubleshooting Information. You will be taken to a page with the address about:support. You can also access this page by entering about:support into the address bar.

Fx88aboutsupport

Give Waterfox a tune up

The Refresh Waterfox feature can fix many issues by restoring Waterfox to its default state while saving your essential information. Consider using it before going through a lengthy troubleshooting process.

Diagnose issues

You can restart Waterfox in Troubleshoot Mode to temporarily turn off hardware acceleration, reset some settings, and disable add-ons (extensions and themes) that might be causing problems. See Diagnose Waterfox issues using Troubleshoot Mode for more information.

Try clearing the startup cache

Waterfox stores certain temporary data in a startup cache to improve startup speed. Clearing the startup cache and then restarting Waterfox can sometimes fix various issues, such as mixed languages in the user interface after an update. This will not change your profile data or add-ons.

Copy to clipboard

You can copy the contents of this page to the Windows clipboard. Clicking the Copy raw data to clipboard button will copy the source data in Json format. Clicking the Copy text to clipboard button will copy a version of the same data in report format for further use. (For privacy reasons, the Application Basics Profile Folder line will not be copied.)

After copying, you can paste the information into another window for someone to see by clicking the Edit menu in the program you are using and then selecting Paste (or by holding down the Ctrl key and pressing V).

Application Basics

  • Name: Tells you the name of the product you are using. In most cases, it should say “Waterfox”.
  • Version: Tells you which version number of Waterfox you are using.
  • Build ID: The code created automatically to identify the unique environment in which this Waterfox installation was built.
  • Distribution ID: This field will appear blank to non-Linux users.
  • Update Folder: Shows the path to the folder containing the files update-config.json, updates.xml, active-update.xml (if an update was downloaded but not yet applied) and the updates subfolder. Clicking on Open Folder will take you to the update folder.
  • Update History: Clicking on Show Update History will open a window showing a history of Waterfox updates that have been installed.
  • Update Channel: The Update Channel is based on whether Waterfox is the standard release, an Extended Support Release (ESR), or a pre-release such as Beta, Developer Edition or Nightly.
  • User Agent: In addition to your browser and its version number, the User Agent provides other details about your system, such as the operating system and version.
  • OS: Shows your operating system.
  • Application Binary: Shows where Waterfox is installed.
  • Profile Folder: Your profile folder is a location on your computer where Waterfox stores your personal information such as bookmarks, passwords, and user preferences. Clicking on Open Folder will take you to your profile folder, where you can manage your files. For more information, see Profiles - Where Waterfox stores your bookmarks, passwords and other user data.
  • Enabled Plugins: Clicking on about:plugins will take you to a page that lists your installed plugins. For more information, see Watch DRM content on Waterfox and Use plugins to play audio, video, games and more.
  • Build Configuration: Clicking on about:buildconfig will take you to a page that will help someone understand if you are using a standard version of Waterfox or a custom version.
  • Memory Use: Clicking on about:memory will take you to a page that shows memory usage. For more information, see this blog post.
  • Performance: Clicking on about:performance will take you to the Task Manager page. For more information, see Task Manager - see what tabs or extensions are slowing down Waterfox.
  • Registered Service Workers: Clicking on about:serviceworkers will show you whether or not the Service Workers feature is enabled and if any current Worker URLs are registered. Service workers are used for web enhancements such as push notifications.
  • Third-party Modules: Clicking on about:third-party will take you to a page with information about any modules that have been injected into Waterfox by third-party applications. To learn more, see this article.
  • Launcher Process: This shows the status of the security-related Launcher Process for Waterfox on Windows (enabled by default). For more information, see this article.
  • Multiprocess Windows: This shows you the number of Multiprocess Waterfox windows (if any) and the total number of windows that are open.
  • Fission Windows: This shows you the number of Site Isolation (Fission) windows (if any), the total number of windows that are open and the reason this feature is enabled or disabled. For example, when Waterfox is in Troubleshoot Mode and one window is open, the entry will show 0/1 Disabled by safe mode.
  • Enterprise Policies: This shows you if your browser is being managed by Windows Group Policy or a policies.json file. If enterprise policies are managing Waterfox, clicking on Active will show you a list of the policies that are currently active on Waterfox.
  • Safe Mode: This tells you whether or not Waterfox is currently in Troubleshoot Mode.
  • Profiles: Clicking on about:profiles will take you to the Profile Manager.

Waterfox Features

Some features included in Waterfox, such as Waterfox Screenshots, are installed as extensions so that they can be updated separately from Waterfox. These extensions (sometimes called system add-ons) are not listed in the Add-ons Manager.

Add-ons

Extensions are Waterfox add-ons that provide additional functionality to Waterfox. This section lists the name of each extension, its version, whether it is enabled, and its ID string. For more information about troubleshooting extensions you have installed, see Troubleshoot extensions, themes and hardware acceleration issues to solve common Waterfox problems.

Security Software

This section displays information about the security software installed on your computer. This includes most antivirus and antispyware software, as well as your firewall. Not having security software installed on your system can leave your system vulnerable. For more information about troubleshooting issues that may be caused by malware, see Troubleshoot Waterfox issues caused by malware.

Graphics

Waterfox can use your computer’s graphics processor to speed up the display of some pages with video and animation, which is called hardware acceleration, and to display WebGL content. This section provides information about your computer’s graphics device and driver and will tell you whether hardware acceleration and WebGL are enabled or not in Waterfox. Note that graphics features may be disabled because of outdated graphics drivers. For help updating your graphics drivers, see Upgrade your graphics drivers to use hardware acceleration and WebGL.

Media

This section displays information about your system audio. The displayed information will include your operating system’s preferred audio settings, as well as the audio input (such as microphones) and output (such as speakers or headphones) devices. From here you can also see the state of each device and some information about the audio format settings. For more information on fixing audio issues in Waterfox, see What to do if Waterfox won’t play any sounds.

Environment Variables

In this section, you will see environment variables utilized by Waterfox and their values, such as the MOZ_CRASHREPORTER_DATA_DIRECTORY variable that shows where crash report data is stored on your computer. Other environment variables, if set, can change how Waterfox behaves. For example, Waterfox downgrade protection can be bypassed by setting the environment variable MOZ_ALLOW_DOWNGRADE, as described in this Waterfox for Enterprise article.

Important Modified Preferences

In this section, you will see a list of settings that have been changed from their defaults. This information will help someone know how you have adjusted your installation of Waterfox. For instructions on how to reset preferences to default, see Reset Waterfox preferences to troubleshoot and fix problems.

Important Locked Preferences

In Waterfox, it’s possible to lock certain preferences so that they cannot be changed by the end user. This is common in enterprise environments. For more information about locking preferences, see the Customizing Waterfox Using AutoConfig documentation.

Places Database

Waterfox periodically performs maintenance tasks on your bookmarks and history database (also known as Places database). Use the Verify Integrity button to perform those tasks on-demand. If you’re having any problems with bookmarks and history, the Verify Integrity tool might help.

Accessibility

This section shows if you have accessibility software enabled in Waterfox.

Library Versions

This section tells you which versions of some runtime libraries are used.

Sandbox

For security and performance purposes, Waterfox created Project Electrolysis (often referred to as e10s) to implement a practice called sandboxing into Waterfox. This ensures that web content is run in a seperate process from the main Waterfox program. This section of the troubleshooting information shows details about the sandbox security levels. See the Sandbox page on the Waterfox Wiki for more information on sandboxing in Waterfox.

Internationalization & Localization

This section shows information about the language and regional preferences in Waterfox and your operating system. For information about using Waterfox language packs, see Use Waterfox in another language.

Printing

The Clear saved print settings button in this section allows you to reset all modified print preferences. This might help fix printing problems in Waterfox.

Modified print settings

This section lists modified print preferences.