Frequently asked questions - Firefox add-on technology is modernizing

Revision Information
  • Revision id: 210270
  • Created:
  • Creator: AliceWyman
  • Comment: edit to search summary: removed "Quantum" (minor)
  • Reviewed: Yes
  • Reviewed:
  • Reviewed by: AliceWyman
  • Is approved? Yes
  • Is current revision? No
  • Ready for localization: No
Revision Source
Revision Content

What is a legacy extension?

Extensions built using frameworks that are not compatible with Firefox 57 and beyond (such as SDK or XUL) are considered “legacy” extensions.

How can I tell if I have any legacy extensions installed?

To see if you have incompatible extensions installed, go to the Add-ons Manager. Click the menu button Fx57Menu and choose Add-ons or enter about:addons in a new tab. If you have a legacy extension, it will display as disabled and the toggle to enable it won't display.

To see if you have incompatible extensions installed, go to the Add-ons Manager. Click the menu button Fx57Menu and choose Add-ons or enter about:addons in a new tab. If you have a legacy extension, it will be listed in the Extensions panel as Disabled with no Enable option in the ellipsis (3-dot) menu.

Fx68Addons-OldLegacyNowDisabled

To see if you have incompatible extensions installed, go to the Add-ons Manager. Click the menu button Fx57Menu and choose Add-ons or enter about:addons in a new tab. If you have a legacy extension, you will see a note at the top of your screen like this:

Legacy extension warning

Click on the link “Show legacy extensions” to see a list of legacy extensions installed in your browser. Click on “Find a Replacement” next to each legacy extension for a recommended alternative. You can read more about this feature in our blog.

If I see the "legacy" label, does that mean my extension is broken?

Yes, extensions labeled "legacy" will not work with Firefox 57 or above. In some cases, developers will need to continue working after the release date on November 14, 2017 to make their extensions compatible. In these cases, the extension will automatically update when the compatible version becomes available.

Can you recommend replacements for my legacy extensions?

Yes! Go to the Add-ons Manager (Click the menu button Fx57Menu and choose Add-ons or enter about:addons in a new tab) and select Legacy Extensions. Click on “Find a Replacement” next to each legacy extension for a recommended alternative. You can read more about this feature in our blog.

We recommend that you search for compatible extensions on addons.mozilla.org (AMO) or look through the featured extensions collection.

Alternatively, you may use the extension finder utility to look up the extension you would like to replace and discover recommended replacements.

There aren’t any recommended replacements for one of my legacy extensions. What now?

If you don’t find a suitable replacement, please head over to our forum to ask the community for suggestions.

When did Firefox ESR stop supporting legacy extensions?

Firefox Extended Support Release (ESR) version 52 was the last version that supported legacy extensions. Support for ESR 52 ended on September 5, 2018.

In October 2018, all legacy add-ons were disabled on addons.mozilla.org (AMO). Users will no longer be able to find legacy add-ons on AMO.

If you decide to run unsupported releases to use legacy add-ons, this will make you vulnerable to security weaknesses and we strongly do not recommend that they be used.

What happened to my complete theme?

Complete themes do not work with Firefox 57+ and are disabled. If you use a dark complete theme, the Dark Theme option in the Add-on Manager might be a good option for you. Go to the Themes tab in about:addons and give it a try. We are making improvements to themes in the coming months, so look for themes with additional functionality beyond an image overlay in future releases.

What happened to my Flash-related add-on?

Starting with the Firefox 55 release, Adobe Flash does not run by default as Click-to-run Flash is built into the browser. You can chose how you want Flash to behave on certain sites or all sites.

Some of the most popular Flash extensions were providing this capability before it became part of the browser. Since these extensions are now obsolete, they will likely no longer be supported by developers and will no longer work.

In some cases, we have WebExtension APIs for additional Flash capabilities (like Flash LSO deletion) and we anticipate add-ons will leverage more Flash capabilities over time and as we work together to discover what is needed to create feature parity.