• Skip to main content
  • Select language
  • Skip to search
MDN Web Docs
  • Technologies
    • HTML
    • CSS
    • JavaScript
    • Graphics
    • HTTP
    • APIs / DOM
    • WebExtensions
    • MathML
  • References & Guides
    • Learn web development
    • Tutorials
    • References
    • Developer Guides
    • Accessibility
    • Game development
    • ...more docs
Firefox Marketplace
  1. MDN
  2. Mozilla
  3. Firefox Marketplace
  4. Add-on submission

Add-on submission

In This Article
  1. Submission step-by-step
  2. Editing and updating your add-on
  3. Add-on package structure
  4. Review Criteria

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

Tags: 
  • Add-ons
  • B2G
  • Firefox OS
  • Marketplace
  • Review
  • submission
 Contributors to this page: chrisdavidmills
 Last updated by: chrisdavidmills, Nov 16, 2015, 1:38:24 AM
  1. Prepare for success
    1. Introduction
    2. Deciding what to build
    3. Getting to know your users
    4. Choosing your business model
    5. Localizing your apps
    6. Promoting your app
    7. Creating your community
  2. Your publication options
    1. Introduction
    2. Packaged apps
    3. Hosted apps
    4. Packaged or hosted?
    5. Mobile-optimized websites
    6. Publish apps yourself
  3. App publishing overview
    1. Introduction
    2. Submission checklist
    3. Marketplace review criteria
    4. Marketplace showcase criteria
    5. Adding a subdomain for an app
    6. Policies and Guidelines
      1. Introduction
      2. Marketplace screenshot criteria
      3. Privacy policy
      4. App testing and troubleshooting
  4. Submit your app
    1. Overview
    2. Step 1: Sign-in
    3. Step 2: Load app
    4. Step 3: Listing details
    5. Step 4: Next steps
    6. Step 5: App rating
    7. Step 6: Define team members
    8. Step 7: View listing
    9. Step 8: Edit other localizations
  5. Managing and updating published apps
    1. Introduction
    2. Your app's status
    3. Updating apps
    4. App Stats
  6. Add-on submission
    1. Add-on submission overview
    2. Add-on review criteria
  7. Libraries and APIs
  8. Firefox Marketplace FAQ