Troubleshoot and diagnose Firefox problems

Revision Information
  • Revision id: 10516
  • Created:
  • Creator: Michael Verdi
  • Comment: saving for troubleshooting with devs
  • Reviewed: 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 in order. If one doesn't work, move on to the next. 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 on the Tools menu and select Clear Recent History... to bring up the Clear Recent History window.
  2. In the Time range to clear drop-down menu, select Everything.
  3. Click the arrow next to Details to display the list of items to clear, then select the following items:
    • Cache
    • Cookies
  4. Click Clear Now.

For more information, see Delete browsing, search and download history on Firefox.

3. Update and troubleshoot your plugins

Sometimes plugins for Firefox (such as Adobe Reader, Flash, Java, QuickTime, RealPlayer, and Windows Media Player) can cause problems. Often this is because they are out of date. To check to see if you have the latest versions of all your plugins, go to our Plugin Check page:

  1. If any of your plugins are out of date, click Update and follow the instructions for updating that plugin.
  2. After you've updated all of your plugins, restart Firefox
    • The template "closefirefox" does not exist or has no approved revision. Then start Firefox again.

If you are still having a problem after updating your plugins, it could be that you have a plugin that no longer works with Firefox. To see if this is the issue, disable all of your plugins. If the problem goes away, it's likely that a plugin is the cause:

  1. Click the menu button Fx89menuButton, click Add-ons and themes and select Plugins.
  2. Click each plugin in the list and then click Disable.
  3. Check whether your problem happens when you have all plugins disabled.

If your problem goes away when all of your plugins are disabled, see the Troubleshoot issues with plugins like Flash or Java to fix common Firefox problems article to learn how to narrow down which one is causing it.

4. Troubleshoot your extensions and themes

Sometimes add-ons for Firefox (extensions or themes) can cause problems. To see whether your problem is caused by an extension or theme, disable them all by restarting Firefox in Diagnose Firefox issues using Troubleshoot Mode. If the problem does not happen in Safe Mode, it's likely that an extension or theme is the cause:

  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 Continue in Safe Mode.
  3. Check whether your problem is still happening while in Safe Mode.

If the problem doesn't happen in Safe Mode, see Troubleshoot extensions, themes and hardware acceleration issues to solve common Firefox problems to learn how to narrow down which one is causing it.

5. Reset Firefox's optionspreferences

If the problem was not fixed by disabling add-ons, you may need to reset all of Firefox's optionspreferences:

  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 to put a check mark by Reset all user preferences to Firefox defaults and Reset toolbars and controls.
  3. To apply your changes, click Make Changes and Restart.

6. 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.

You might want to print these steps or view them in another browser.
  1. Download the latest official version of Firefox from Mozilla.com.
  2. Exit Firefox: The template "closefirefox" does not exist or has no approved revision.
  3. Uninstall Firefox - see Uninstall Firefox from your computer for instructions.
    During the uninstalling process, do not select the option to Remove my Firefox personal data and customizations. You will loose all of your bookmarks, history, passwords and settings.
  4. After running the unistaller, be sure to also delete the Firefox installation folder which is located here by default: C:\Program files\Mozilla Firefox
  5. Reinstall Firefox - see How to install Firefox on Windows for instructions.
  1. Download the latest official version of Firefox from Mozilla.com.
  2. Quit Firefox: The template "closefirefox" does not exist or has no approved revision.
  3. Uninstall Firefox - see Uninstall Firefox from your computer for instructions.
    When following the uninstall instructions, do not perform the additional steps of removing user data and settings. You will loose all of your bookmarks, history, passwords and settings.
  4. Reinstall Firefox - see How to download and install Firefox on MacInstall Firefox on Linux for instructions.

Now start Firefox and check to see if your problem has been fixed. If it has, you can reinstall the extensions and themes you verified (in part 4 above) were not causing problems. If your problem hasn't been fixed continue with the next troubleshooting method.

7. Make a new profile

A bad profile can cause all kinds of problems with Firefox. To see whether your problem is caused by a bad profile, make a new one. If that fixes the problem you can copy your data (bookmarks, saved passwords, etc.) over to the new profile.

  1. Use the instructions in the Profile Manager - Create, remove or switch Firefox profiles article to start the Profile Manager and create a new profile.
    When creating a new profile, do not delete your old profile. You will loose all of your bookmarks, history, passwords and settings.
  2. Once you've created a new profile, select it in the Profile Manager and click Start Firefox.

Test to see if your problem occurs with the new profile. If it doesn't, you can copy your data to the new profile - see Recovering important data from an old profile for instructions.

Other solutions

If you've tried the above steps, including a clean reinstall, the following solutions may help to resolve your problem.

Note: This section does not contain step-by-step instructions. For more information on any of these solutions, please consult the appropriate documentation that came with your operating system or other software product.

Internet security software

Some Internet security software (including antivirus, antispyware, and firewall programs) can cause problems with Firefox. These can include limited ability to open pages, crashes, and more.

If you are using firewall or other Internet security software, verify that the Firefox application is not block from communicating with the Internet.

Most of the time you can open a program's settings, remove Firefox from its list of allowed or trusted programs, and then let it re-detect Firefox, and things will start working again. This step is worth repeating, even if you've not had problems with your Internet security software before. 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.

Viruses and Spyware.

Periodically, you should scan your system for viruses, spyware, or other malware. One of the following free services may be useful for virus scans:

Some malware programs may target the Firefox application file. The following instructions may help diagnose such a problem:

  1. Click the Firefox menu Fx89menuButton and select Exit.Click the Firefox menu at the top of the screen and select Quit Firefox.Click the Firefox menu Fx89menuButton and select Quit.
  2. Open the Firefox application folder - by default, it is:
    C:\Program Files\Mozilla Firefox.
  3. Rename firefox.exe to firefox1.exe.
  4. Double-click firefox1.exe to launch Firefox.
  5. If Firefox runs without problems, some malicious code may be targeting Firefox (firefox.exe). Scan your computer for malicious code using the links above or your own antivirus or antispyware program.

It's also possible that an ad-blocker, web-accelerator, antivirus or other running program is conflicting with Firefox. Try temporarily disabling these other programs one at a time.

File system errors

If your computer's file system has a problem, that may prevent Firefox from running. Run the error-checking tool Chkdsk on your drive to look for and repair errors.



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