Firefox OS 2.5+ supports add-ons, a feature already familiar to Firefox Desktop users, which allows customization of specific apps or the whole OS — behaviour more to your liking. The Firefox Marketplace acts as a host for add-ons as well as apps; this article provides an overview of how to submit your add-ons for publication.

Submission step-by-step

  1. Navigate to Firefox Marketplace Content Tools and log in to the site.
  2. After you've logged in, select the Submit Firefox OS Add-on button to go to the Submit a Firefox OS Add-on page; this is where the process starts.
  3. Click Select a File and select the add-on zip package you want to submit. See the Add-on package structure section below for more details on the required package/manifest format.
  4. You can optionally add submission notes.  These are only for review purposes and are not publicly available — testing instructions, test login details, etc.
  5. Click Submit.  Your add-on will now be validated. 
    1. If there are any errors you’ll be sent back to Step 3 to resubmit an updated zip file.
    2. If not, you will be redirected to your dashboard, where all your submissions will be listed.
  6. After a reviewer has looked at your add-on, an email will be sent to notify you of the outcome.

Editing and updating your add-on

After successful submission of your add-on, you can edit/update it by going to your dashboard and selecting Edit this add-on.

New add-on versions can be added on this page.  Uploading a new version while a previous version is pending review will mark the previous version obsolete and the new version will then be marked pending review instead (a maximum of 1 version can be pending review at one time.)

Once a version is approved then that will be available for installation; it will remain available until a newer version is approved.

Add-on package structure

The add-on is submitted as a zip file. This section details what the zip must contain.

The manifest.json (Manifest file) must be in the root of the zip file. Key details are as follows:

  • name is required.
  • version is required.
  • description is optional but will be used by the Marketplace on the Add-on detail page.
  • icons is used to find icons to display on the marketplace, and on the device when the add-on is installed.
  • author isn’t currently used by the Marketplace, but will be shown on the device when the add-on is installed.

The rest of your add-on will be a typical collection of CSS, JavaScript, icons, etc. Again, this should all be placed in the root of the zip file, not within a subfolder — don’t zip up your project folder; zip up the contents of the project folder.)  For mroe information on developing add-ons, see Firefox OS add-ons.

Note: Validation describes the current state of the manifest validator. 

Review Criteria

You can review the Firefox OS add-ons review criteria to make sure your add-on follows it.

Document Tags and Contributors

 Contributors to this page: chrisdavidmills
 Last updated by: chrisdavidmills,