To start, familiarize yourself with theAdd-on Policies andDeveloper Agreement.
Next, prepare your add-on for publication by adding all its files to a ZIP archive with the extension.zip,.xpi, or.crx. For information on how to create your ZIP, seePackage your extension, and for details on what to include in the file, seeAnatomy of an extension.
The maximum file size accepted is 200 MB. If your add-on is larger than 200 MB, it will fail validation.
If your add-on includes code that might be difficult to read, such as code created by minification or obfuscation, create a source code package. For more information on this requirement, seeSource Code Submission.
Create your developer account. Onaddons.mozilla.org (AMO):
- If you have a Mozilla Account, in the page header, clickLog in and log in with your Mozilla Account. This connects your account with AMO.
- If you don't have a Mozilla Account, in the page header, clickRegister.
Go toAdd-ons Developer Hub and clickSubmit Your First Add-on orSubmit a New Add-on. You reach the following page:
Choose:
- On this site, if you want your add-on listed on AMO.
ClickContinue and follow theListing on AMO guide. - On your own, if you plan to distribute the add-on yourself and don't want it listed on AMO.
ClickContinue and follow theSelf-distribution guide.
Listing on AMO
The Upload Version page displays.
ClickSelect a file, select and upload your add-on.
The validator checks the add-on for issues and the page updates.
If your add-on passes all the checks, you receive this message:
You may receive a message that you only have warnings. It's advisable to address these warnings, particularly those flagged as security or privacy issues, as they may result in your add-on failing review. However, you can continue with the submission.
Otherwise, you receive a message similar to this:
The message informs you of what failed. You cannot continue. Address these issues and return to step 1.
Select the add-on's compatible platform(s).
ClickContinue.
Indicate whether you need to provide your source code.
If you selectYes, a section displays describing what you need to submit. ClickBrowse and locate and upload your source code package. SeeSource code submission for more information.
ClickContinue.
The Describe Add-on page displays.
Provide the following:
- Name: your add-on's name.
- Add-on URL: the URL for your add-on on AMO. A URL is automatically assigned based on your add-on's name. To change this, clickEdit. The URL must be unique. You are warned if another add-on is using your chosen URL, and you must enter a different one.
- Summary: a useful and descriptive short summary of your add-on.
- Description: a longer description that provides users with details of the extension's features and functionality.
- This add-on is experimental: your add-on is experimental or otherwise not ready for general use. The add-on will be listed but with reduced visibility. You can remove this flag when your add-on is ready for general use.
- This add-on requires payment, non-free services or software, or additional hardware: indicate if your add-on requires users to make an additional purchase for it to work fully.
- Select up to 2 Firefox categories for this add-on: select categories that describe your add-on.
- Select up to 2 Firefox for Android categories for this add-on: select categories that describe your add-on.
- Support email andSupport website: an email address and website where users can get in touch when they have questions, issues, or compliments.
- License: select the appropriate license for your add-on. ClickDetails to learn more about each license.
- This add-on has a privacy policy: if any data is being transmitted from the user’s device, a privacy policy explaining what is being sent and how it’s used is required. Check this box and provide the privacy policy.
- Notes for Reviewers: information to assist the AMO reviewer, such as log in details for a dummy account, source code information, or similar.
ClickSubmit Version
The Version Submitted page displays. You also receive an email confirmation.
Your add-on is published and available on AMO for users to discover and install. Note, however, that your add-on may be subject to further review. If it is, you receive notification of the outcome of the review later.
When you're ready to release a new version of your add-on, update it by visiting the add-on's page onaddons.mozilla.org and uploading the new version. You must update it on the add-on's page so AMO recognizes it as an update to an add-on and not a new one.
Learn how to make your add-on listing appealing with thesetips.
Self-distribution
If you want Firefox to handle updates to your add-on, remember to include thebrowser_specific_settings key in yourmanifest.json with theupdate_url attribute set to point to anupdate manifest file.
The Upload Version page displays.
ClickSelect a file, select and upload your add-on.
The validator checks the add-on for issues and the page updates.
If your add-on passes all the checks, you receive this message:
You may receive a message that you only have warnings. It's advisable to address these warnings, particularly those flagged as security or privacy issues, as they may result in your add-on failing review. However, you can continue with the submission.
Otherwise, you receive a message similar to this:
The message informs you of what failed. You cannot continue. Address these issues and return to step 1.
Select the add-on's compatible platform(s).
ClickContinue.
Indicate whether you need to provide your source code.
If you selectYes, a section displays describing what you need to submit. ClickBrowse and locate and upload your source code package. SeeSource code submission for more information.
ClickContinue.
The Version Signature Pending page displays.
ClickGo to My Submissions.
You receive an email when your extension has been signed.
Follow the link in the email or open your extension from My Add-ons and, under the latest version details, clickView All.
Select the version you uploaded and, on the version page, click the file link to download the signed copy of your add-on.
You can now distribute your add-on. Note, however, that your add-on may be subject to further review. If it is, you receive notification of the outcome of the review later.
Get help
For resources that can help now you've published an add-on and details of how to get help if you encounter issues, check outResources for publishers.
Tags: add-ons beginner tutorial webextensions
Contributors: Rob--W Roubo rebloor wbamberg chrisdavidmills andrewtruongmoz wesinator achangofpace
Last update: achangofpace
Up Next
Publish
Version Rollback
Publish
Source code submission
Publish