sodcalculator

10 Tech How-To

Selenium IDE Support for Firefox 55: Setup Guide

Guide 10-51416 · Updated · Step by step

Selenium IDE, the browser extension for recording and replaying web automation tests, does not work with Firefox 55 or any modern Firefox version. To use Selenium IDE with Firefox, you must install an older Firefox release (52 ESR or earlier) or switch to a different tool like Selenium WebDriver. This guide explains why compatibility broke, what still works, and how to set up a working environment today.

Background: Why Firefox 55 Killed Selenium IDE

Selenium IDE was originally built as a Firefox add-on using the old XUL/XPCOM architecture. Firefox 57 (released November 2017) removed all XUL add-ons in favor of WebExtensions, but the writing was on the wall earlier. Firefox 55, released in August 2017, already disabled many legacy add-ons by default and required users to manually enable them via the extensions.legacy.enabled preference. Selenium IDE 2.x was never updated to the WebExtensions API, so it simply stopped working on Firefox 55 and later.

Mozilla’s decision to drop legacy add-on support was a security and performance move, but it left a gap for testers who relied on the simple record-and-playback workflow. The official Selenium project responded by discontinuing Selenium IDE and recommending WebDriver for all new automation.

What Works on Firefox 55 (and What Doesn’t)

If you are stuck with Firefox 55 for some reason, here is the reality:

  • Does NOT work: Selenium IDE 2.x (the classic XUL extension). It will not appear in the Add-ons Manager, or if installed, it will be disabled and cannot be enabled.
  • Does NOT work: Selenium IDE 3.x (the newer WebExtension version) is not compatible with Firefox 55 either, because it requires Firefox 60 or later.
  • Works: Selenium WebDriver (via Selenium Client & WebDriver) with Firefox 55 using the geckodriver that was current at the time (geckodriver 0.18 or later). This is the programmatic way to run tests.
  • Works: Using Firefox 52 ESR (Extended Support Release) which still supported legacy add-ons. This is the only way to run the old Selenium IDE on Firefox.

How to Set Up Selenium IDE with Firefox 55 (Legacy Method)

If you absolutely must use Selenium IDE with Firefox 55, follow these steps. Note that this is a workaround, not a supported configuration.

  1. Install Firefox 52 ESR – Download the 52.9.0esr build from Mozilla’s archive (or a trusted mirror). Install it in a separate directory to avoid conflicts with your main Firefox.
  2. Disable automatic updates – Go to Options > Advanced > Update and select “Never check for updates” to prevent it from upgrading to a version that breaks the add-on.
  3. Install Selenium IDE 2.9.1 – This is the last stable version of the classic IDE. Download the .xpi file from the Selenium HQ GitHub releases page (or the archived add-on). In Firefox 52 ESR, open the .xpi file and confirm the install.
  4. Enable legacy add-ons – In Firefox 52 ESR, legacy add-ons are enabled by default, but if you see a warning, go to about:config and set extensions.legacy.enabled to true.
  5. Restart Firefox – The Selenium IDE icon should appear in the toolbar. Click it to open the IDE window.

This setup works, but it is fragile. You are using an outdated browser with known security vulnerabilities, so only use it in an isolated, non-production environment.

Alternative: Using Selenium WebDriver with Firefox 55

If you are willing to give up the record-and-playback UI, you can write tests in your preferred language (Python, Java, C#, etc.) using Selenium WebDriver. Firefox 55 works with geckodriver 0.18 or later. Here is a minimal Python example:

from selenium import webdriver

driver = webdriver.Firefox()  # uses geckodriver
driver.get("https://example.com")
print(driver.title)
driver.quit()

To set this up:

  1. Install the Selenium client library for your language (e.g., pip install selenium for Python).
  2. Download geckodriver and place it in your PATH.
  3. Ensure Firefox 55 is installed and recognized by geckodriver.

This is the officially supported way to automate Firefox 55, and it remains the standard approach for all modern Firefox versions.

What About Selenium IDE 3.x?

Selenium IDE was revived as a WebExtension in 2018, version 3.0.0. This new IDE works with Firefox 60 and later, Chrome, and Edge. It offers a similar record-and-playback experience but with a modern interface and support for exporting tests to WebDriver scripts. If you want the convenience of an IDE without the legacy baggage, install Selenium IDE from the Firefox Add-ons store on a current Firefox version (or Chrome). It is actively maintained and is the recommended path for new users.

However, Selenium IDE 3.x does not support Firefox 55, so it is not an option for that specific version. You would need to upgrade Firefox to at least 60, or use the legacy workaround above.

Common Problems and Troubleshooting

  • IDE icon missing after install: In Firefox 52 ESR, right-click the toolbar and select “Customize”, then drag the Selenium IDE icon to the toolbar.
  • “Add-on is not compatible” error: This happens if you try to install the .xpi on Firefox 55 or later. Use Firefox 52 ESR instead.
  • Tests fail to record on HTTPS sites: The old IDE sometimes had issues with self-signed certificates. Make sure the site’s certificate is valid or add an exception.
  • geckodriver cannot find Firefox: If using WebDriver, set the path explicitly: webdriver.Firefox(executable_path='/path/to/geckodriver') or use the firefox_binary option to point to the Firefox executable.
  • Firefox updates automatically and breaks everything: Disable updates in Firefox 52 ESR as described, and also block updates in your system package manager if you installed via a package.

Frequently Asked Questions

Can I use Selenium IDE on Firefox 55 if I enable legacy add-ons?

No. Firefox 55 has a preference extensions.legacy.enabled, but it defaults to false and setting it to true does not re-enable all legacy add-ons; it was a temporary flag that was removed in later versions. The only reliable way is to use Firefox 52 ESR, which still fully supported XUL add-ons.

Is there a way to record tests without Selenium IDE?

Yes, you can use browser developer tools (like the console) to write and run WebDriver scripts manually, or use third-party recorders like Katalon Recorder (a WebExtension) that works on Firefox 55. Katalon Recorder exports to WebDriver code and is a popular alternative.

Why did Mozilla remove support for legacy add-ons?

Mozilla removed XUL/XPCOM add-on support in Firefox 57 to improve security, stability, and performance. Legacy add-ons had full access to the browser internals, which was a security risk. WebExtensions have a sandboxed API, making them safer and more consistent across browsers.

Can I still download Selenium IDE 2.9.1?

Yes, the .xpi file is available on the Selenium HQ GitHub repository under the “selenium-ide” project, in the releases section. It is no longer maintained, but it works with Firefox 52 ESR.

Is it safe to use Firefox 52 ESR today?

No, Firefox 52 ESR is outdated and has known security vulnerabilities. It should only be used in isolated test environments with no access to sensitive data. For any production work, use a current Firefox version with Selenium WebDriver or Selenium IDE 3.x.

Conclusion

Firefox 55 is a dead end for Selenium IDE. The only way to use the classic IDE is to downgrade to Firefox 52 ESR, which is insecure and impractical for most users. The modern, supported path is to use Selenium WebDriver or the new Selenium IDE 3.x on a current Firefox version. If you are migrating from an old Selenium IDE project, export your test cases to WebDriver format and rewrite them in your preferred language—this gives you more flexibility and long-term maintainability.

Related

General steps for current mainstream versions; menus can differ by device and version. See the disclaimer or report an error.

More in this bed

The whole Tech How-To bed →