Troubleshoot and diagnose Firefox problems

Revision Information
  • Revision id: 180850
  • Created:
  • Creator: fffknol
  • Comment: In the address bar, enter '''about:about''' - cuz why make it a secret?
  • Reviewed: Yes
  • Reviewed:
  • Reviewed by: AliceWyman
  • Is approved? Yes
  • Is current revision? No
  • Ready for localization: No
Revision Source
Revision Content

Most problems with Firefox can be fixed by following the troubleshooting methods described below. Try these steps in order. If one doesn't work, move on to the next one. If you need extra help with any of this, we have a community of volunteers standing by.

1. Restart your computer

Sometimes problems can be fixed by simply restarting your computer and then starting Firefox again.

2. Clear your cookies and cache

Many problems with loading web pages can be resolved by clearing Firefox's cookies and cache:

  1. Click the menu button Fx89menuButton to open the menu panel.
  2. Click History and select Clear Recent History…
  3. In the Time Range to clear: drop-down, select Everything.
  4. Below the drop-down menu, select both Cookies and Cache. Make sure other items you want to keep are not selected.
  5. Click OKClear Now.
For more information, see Delete browsing, search and download history on Firefox.

3. Restart Firefox in Safe Mode

Firefox Safe Mode is a troubleshooting mode that disables all extensions, uses the default theme, turns off hardware acceleration, and uses default toolbar settings and controls, among other things. To start Firefox in Safe Mode:

  1. Click the menu button Fx89menuButton, click Help, select Troubleshoot Mode… and click Restart in the Restart Firefox in Troubleshoot Mode? dialog.

    Note: You can also start Firefox in Troubleshoot Mode by holding down the Shift key while starting Firefox.holding down the option key while starting Firefox.quitting Firefox and then going to your Terminal and running: firefox -safe-mode
    You may need to specify the Firefox installation path (e.g. /usr/lib/firefox).
  2. In the Firefox Safe Mode dialog, click Start in Safe Mode.
  3. Check whether your problem is still happening while in Safe Mode.

4. Reinstall Firefox

Some Firefox issues can be caused by a problem with one of the Firefox program files. Follow these steps to completely remove and reinstall Firefox. This process will not remove your Firefox profile data (such as bookmarks and passwords), since that information is stored in a different location.

Note: You might want to print these steps or view them in another browser.
  1. Download and save the installer for the latest official version of Firefox from mozilla.org.
  2. Exit Firefox (if open): The template "closefirefox" does not exist or has no approved revision.
  3. Uninstall Firefox from your computer.
  4. Delete the Firefox program folder, which is located in one of these locations by default:
    • C:\Program Files\Mozilla Firefox
    • C:\Program Files (x86)\Mozilla Firefox
  5. Reinstall Firefox using the installer you downloaded earlier - see How to install Firefox on Windows for instructions.
  1. Download the latest official version of Firefox from mozilla.org.
  2. Quit Firefox: The template "closefirefox" does not exist or has no approved revision.
  3. Uninstall Firefox from your computer by opening the Applications folder in the Finder and dragging the Firefox application to the Trash.
  4. Reinstall Firefox - see How to download and install Firefox on Mac for instructions.
  1. Download the latest official version of Firefox from mozilla.org.
  2. Quit Firefox: The template "closefirefox" does not exist or has no approved revision.
  3. Uninstall Firefox - If you installed Firefox with the distro-based package manager, you should use the same way to uninstall it - see Install Firefox on Linux for details. If you downloaded and installed the binary package from the Firefox download page, simply remove the folder firefox in your home directory to uninstall Firefox.
  4. Reinstall Firefox - see Install Firefox on Linux for instructions.

Now start Firefox and check to see if your problem has been fixed. If it hasn't, continue with the next troubleshooting method.

5. Refresh Firefox

The Refresh Firefox feature can fix many issues by restoring your Firefox profile to its default state while saving your essential information.

Note: When you refresh Firefox, your bookmarks, browsing history, open tabs, windows, passwords, cookies and web form auto-fill information will be saved. However, your extensions and themes will be removed and your preferences will be reset. Learn more.
  1. Click the menu button Fx89menuButton, click Help and select More Troubleshooting Information.
  2. Click Refresh Firefox… then Refresh Firefox in the confirmation window that opens. Firefox will close to refresh itself.
  3. When finished, a window will list your imported information. Click the Finish button. Firefox will open.
  4. Select whether you want Firefox to restore all or some windows and tabs and click the Let's go! button.
Note: There's a Refresh Firefox button in the Firefox Troubleshoot Mode window, if you can't start Firefox normally. You can also do a manual refresh by creating a new profile and transferring your important data to the new profile.

6. Create a new Firefox profile

Sometimes files in your Firefox profile folder that correspond to the essential information that a Firefox Refresh doesn't remove (such as bookmarks and browsing history) may be causing the issue. You can create a new, additional profile which will not contain any of your old Firefox data. See Profile Manager - Create, remove or switch Firefox profiles for instructions.

Other solutions

If you've tried all of these troubleshooting methods and you're still having problems, the issue may be with other software or hardware on your computer.

Check browser internals

In the address bar, enter about:about to get a list of system windows with technical information that might be helpful for users or technicians. Using it you can test DNS, profile the workload and much more.

Troubleshoot the Flash plugin

See Flash Plugin - Keep it up to date and troubleshoot problems.

Check for conflicts with your Internet security software

Some Internet security software (including antivirus, antispyware, and firewall programs) can cause problems with Firefox including blocking it from opening websites, crashes, and more. Often you can open the program's settings, remove Firefox from its list of allowed or trusted programs and it will be re-detected and things should start working again. If your program is listed at the Configure firewalls so that Firefox can access the Internet article, you can get specific instructions for how to properly reconfigure it.

Check for malware

Malware (short for "malicious software") can cause problems with Firefox. Periodically, you should scan your system for viruses, spyware, or other malware. For more information, see Troubleshoot Firefox issues caused by malware.




Based on information from Standard diagnostic - Firefox (mozillaZine KB)