Firefox OS add-ons

This is an archived page. It's not actively maintained.

Firefox OS 2.5 introduces support for add-ons, a feature that desktop users have known and loved since the beginning of Firefox.  Add-ons on Firefox OS are even more powerful and can customize not only the browser, but the whole phone experience, including tweaks to the homescreen and system apps like E-Mail and Messages. This page tells you everything you need to know to get started with creating Firefox OS add-ons and get involved with the add-ons community.

Note: Firefox OS add-ons are based on the WebExtensions API, which is also supported in Firefox desktop starting with version 42 and is based on the extension APIs used in Chrome and Opera.


You should follow the below steps to get set up to start developing extensions.

1. Flash your phone to Firefox OS 2.5

Firefox OS add-ons are only supported on Firefox OS 2.5 and later.  Here’s a list of supported devices and how to update them (this list is incomplete, and will be added to as time goes on.)

2. Enable USB Debugging

In the Settings app on the device, select Developer > Debugging via USB > ADB and Devtools.  You should now be able to debug installed apps using WebIDE, either via a USB cable, and over Wifi (no USB cable required.)

3. Set up WebIDE

The WebIDE tool is part of Firefox and can be used to install add-ons on your phone during development — see Testing your add-on using WebIDE for more information.

See also



Get involved