• 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. Publishing
  5. Submission checklist

Submission checklist

In This Article
  1. Submission checklist
    1. For Packaged Apps
    2. For Hosted Apps
    3. For all apps (required)
    4. For all apps (optional)
    5. And also ...

Before commencing the submission of an app to the Firefox Marketplace it is worth making sure you have all the resources you need to complete the process. This page provides a list of the items needed and links to related information.

Submission checklist

To complete the submission of an app to the Firefox Marketplace, you need:

For Packaged Apps

  • The app packaged into a zip file, with the manifest in the root.
  • A launch_path specified in the manifest.

For Hosted Apps

  • Web hosting for the app. For more information, see Options for hosting your app.
  • The URL of the manifest file for your app. For more information, see App Manifest.

You can test the validity of your app's manifest before submitting it to Firefox Marketplace , using the Test App Validation tool.

For all apps (required)

For both Hosted Apps and Packaged apps:

  • An app name contained in your app's manifest file: There can be a maximum of 128 characters in the manifest, and is prefilled into the Marketplace name field in Step 3 of the app upload process.
  • An app description in your app's manifest file: There can be a maximum of 1024 characters in the manifest, and is prefilled into the Marketplace Description field in Step 3 of the app upload process where it can be edited further (the Marketplace version isn't limited in terms of character count.)
  • A 128 x 128px icon for display in the marketplace; this is the only mandatory icon size. For more information on how to include icons with your app, see manifest icons.
  • A screenshot of your app, at least 320 x 480px in size (see Marketplace screenshot criteria for more guidelines; screenshots can be updated in Step 4 if you need to add more or change them).
  • Your app's privacy terms, or the URL of a page that describes them. See Privacy policy guidelines for more information (this is entered into the upload app in Step 3).
  • A support email address for your app (entered into the upload app in Step 3).

For all apps (optional)

For both Hosted Apps and Packaged apps, it's recommended that you have:

  • Extra screenshots to show the app's main screens. Each submission can have up to 6 screenshots. Ideally you should include a screenshot for each form factor that your app has a distinct layout for, for example:
    • Phone: suggested size 320 x 480px, or multiple thereof
  • Icons in other sizes, and specified in your app's manifest file, for optimal display in other platforms/contexts :
    • A 60 x 60px icon for display on the device.
    • 32 x 32px, 90 x 90px, 120 x 120px, and 256 x 256px icons for optimal display on various other platforms your app can be installed on, such as Windows 7 and Android.
  • The URL of a home page for the app and/or support site for the app. These could be the same thing, or different, depending on your preference (entered into the upload app in Step 3).
  • Other optional fields in the App manifest. While name, description and icons are the only required fields, there are many other options, for example:
    • You will want include information about other locales if your app is multi-lingual.
    • If you do include locales, then the default_locale field is required.
    • If you want to use specific restricted device APIs or Web Activities in your app, you will need to include the relevant App permissions or activities in your manifest.

And also ...

... you should:

  • Decide if you want your app to go live on the Marketplace immediately after it is approved. The default is for the app to go live immediately. If you don't want this, uncheck Publish my app in the Firefox Marketplace as soon as it's reviewed when you submit your app (selected in the upload app in Step 2).
  • Read and understand the Marketplace review criteria (Step 1).

Document Tags and Contributors

Tags: 
  • Apps
  • Beginner
  • Firefox OS
  • Guide
  • Marketplace
 Contributors to this page: chrisdavidmills, rebloor
 Last updated by: chrisdavidmills, Feb 15, 2016, 5:46:16 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