Add-ons/Reviewers/Guide/Review Decision
Review Decision Guidelines
This page provides guidance to support reviewers in making consistent review decisions based on our Review Policies. In addition, it explains how to best communicate with the developer when conducting add-on reviews. It is a supplement to our Reviewer Guide.
Completing the Review
Add-ons must be reviewed completely, noting issues in the review comments field as you find them. We want to avoid sending multiple partial reviews to developers and give them an opportunity to address all policy violations at once in their next submission.
In the following sections we will explain how canned responses should be used for the issues you find and guide you through the review actions. Finally, you are guided on how to respond if you find issues that cover multiple review actions.
Use of Canned Responses
To ensure developers receive consistent, actionable responses from the review team, AMO makes use of canned responses that cover many of our policy issues.
If no canned response is available for the issue you have found, you may write a custom response specific to the situation. Keep in mind that when writing a response to the developer, all responses must be in line with our policies. This is especially true when using custom responses. If you are unsure your response conforms with the policy, an admin reviewer will be able to assist you.
In addition, we’d love to hear from you believe the response is useful to add to the official list of canned responses. We would much prefer that reviewers use the canned responses to ensure consistent replies, therefore adding new canned responses could be very useful.
In some cases the developer responds to your review, either via email or by uploading a new version, making clear that they did not fully understand how to act upon the canned response. In such cases, sending the same canned response again will not help resolve the situation. Here it makes sense to explain the policy issue in a different, possibly more verbose way, using your own words.
Example
While the review comments field is free-form, we have a de-facto standard approach that lists the review issues in numbered lists each with a headline. Note that your text is inserted into an email that handles all the formalities, you should not need to begin your review with “Dear Developer” or sign with your name.
Commonly, we use a numbered list item for each review issue, along with headings to separate sections as needed. Here is an example review text to give you an idea:
This add-on didn't pass review because of the following problems: 1) We don't allow add-ons to use remote scripts because they can create serious security vulnerabilities. We also need to review all add-on code, and this makes it much more difficult. Please insert those scripts locally from your add-on code. - pages/inject.html line 8 In addition, the following information is required to complete the review: 1) Please provide us with detailed information on how to test this add-on. If authentication to a website is necessary, give us a test username and password to facilitate our work. This can be provided in the Whiteboard field, which can be found in the Edit Listing page under the Technical Details section. This information is only available to reviewers.
Reviewer Replies
With a reviewer reply, you can convey information to the developer. You can use this action to answer questions the developer may have about your review. All communication between developers and reviewers is captured on the review history page.
If you need the developer to take action, please make use of a delayed rejection instead. Doing so makes sure the correct email template is used and AMO knows to remind us when the developer has not responded to the request.
If you are unsure how to answer a response from a developer, or the developer is disputing your review, please get in touch with admins to make sure the developer receives a reply. Involving a second reviewer to confirm your review can also be helpful if the developer does not want to accept your reasoning.
Delayed Rejection
If the add-on has minor policy issues that don’t require an immediate rejection, the delayed rejection action should be used. AMO will then reach out to the developer, asking them to resolve the issue within the requested time frame. If the developer fails to comply, the marked versions will be rejected.
To use a delayed rejection, select “Reject Multiple Versions”, and select the option to delay the rejection. All versions you have selected will be rejected after the time passes. You will need to determine when the developer started to use the code in question, so you can determine which versions to reject. Generally it is sufficient to check back until the last reviewed version, for example using a bisection approach. If the issue also exists in that last reviewed version, you will need to track back further.
If the developer responds, you will receive email with the developer’s response. At this time you should return to the review page to continue reviewing using the information you received from the developer. Note that the developer may follow up with further questions about the information you are requesting. In all cases, please answer developers in a timely manner (within 2 days). If you are answering questions that require no further action or response, please use the “reviewer reply” action.
If you cannot complete the review after the developer has provided information, please at least check if the developer has provided the information you have requested and leave a comment on the version so that other reviewers can continue your work.
Similarly, if you come across an add-on where the developer has provided information but the original reviewer has not followed up within that time, you are welcome to complete the review. The original reviewer may have prior knowledge that would speed up the review, but at the same time we do not want to keep developers waiting.
Immediate Rejection
Rejecting an add-on’s versions can mean anything from showing an outdated version of the add-on to completely hiding the listing from addons.mozilla.org (when rejecting all public versions). Especially in the post-review model where add-ons are reviewed after initial approval, a rejection can lead to frustration from the developer. At the same time, we need to ensure that there are no policy violations that threaten user security or privacy.
Our general policy is to only reject immediately when necessary. Rejection is necessary when an add-on has security or privacy issues, doesn't meet our content policies, or fits one of the examples described later on.
When rejecting the add-on, you will need to determine all affected versions using the same approach as for a delayed rejection. You can then select the option to reject immediately.
In case of a rejection, developers may have questions on how to best resolve the policy issues, or if they have trouble understanding the message. Similar to the delayed rejection, please answer in a timely manner using the reviewer reply feature.
Policy issues found in previously reviewed version(s)
When policy issues are found in an add-on's version(s) that was previously reviewed and approved, you should perform the following action on the non-compliant version(s) for all non-malicious policy issues, depending on whether the version is listed or unlisted:
- Listed versions: You should delayed-reject the versions with the standard delay.
- Unlisted versions: You should immediate-reject the non-compliant versions.
Multiple Categories of Issues
If you find multiple issues within the add-on where there are both delayed and immediate rejections, you may reject the add-on immediately. Please make sure to clearly separate information needed to complete the review from rejection reasons. An example on how this can be done is shown above.
Super-Review
Using the “Request Super Review” action will put the add-on into the admin queue. There are few select cases where this would occur, please see the examples below for further details. If you have a concern that needs immediate admin attention, please get in touch with the admins via the channel described in the Escalation section, as there are no specific notifications to admins when you request super review.
Escalation
There are certain cases that are severe enough that the reviewer actions on addons.mozilla.org are not sufficient and you must inform the admin team. This is especially true for reporting child pornography, add-ons containing abusive functionality or being of malicious nature that must be blocked in accordance with our blocking policy.
In such cases, you should contact the admin team via email at amo-admins [at] mozilla [dot] com. You can find more examples on when to escalate later on this page.
Examples
The following sections show a few common examples on how to respond to certain policy violations. Please note however these are merely examples intended to convey the intent we have with the policies. It should not be considered a complete list of review decisions.
No Surprises
Example | Verdict |
---|---|
The add-on sends all visited URLs to a third party service without adhering to the no surprises requirements. | Reject Immediately |
The add-on uses means such as webRequest to circumvent the permission prompts for new tab page, homepage or search engine changes. | Reject Immediately |
The add-on changes browsing behavior inhibiting user actions, such as closing or hiding about:addons or other special pages when opened. | Reject and Escalate Immediately |
The add-on unexpectedly makes use of redirection to block the user from visiting certain sites without providing the user an option to circumvent the redirection. The add-on is violating the no surprises policy. | Reject Immediately |
The add-on silently modifies web content, for example by exchanging words and images, or adding content. This feature is not part of the core functionality and is not described to the user in any way. | Reject Immediately |
The add-on describes itself as e.g. “VPN Service”, while at the same time it also provides something completely unrelated to the add-on’s core function, such as altering the new tab page and providing affiliate search results. The additional features are not stated in the description, and there is no opt-in for the additional feature, violating the no surprises requirements. |
Reject Immediately |
An add-on provides UI to allow the user to make a no surprises choice, but the default action is to accept the choice (hence not an opt-in). | Reject Immediately |
An add-on makes use of an “unexpected” feature as per no-surprises policy, but fails to indicate so in the add-on description. | Delayed Reject |
Content Policy
The content review policies are detailed in separate guidelines. Here are a few select examples for the content policy:
Example | Verdict |
---|---|
Sexual Content: An add-on contains obscene or pornographic images in the icon, screenshots, or anywhere within the add-on UI. | Reject Immediately |
Sexual Content: An add-on contains images of potential or actual child pornography. | Reject and Escalate Immediately |
Hate Speech: The add-on listing or UI attacks a person or group based on the attributes described in the acceptable use policy. If you are unsure certain phrasing is acceptable or not, please contact an admin. |
Reject Immediately |
Spam: The add-on clearly has the sole purpose of linking to a product or website and at the same time does not offer any functionality (e.g. “WATCH THIS MOVIE ONLINE”). | Reject Immediately |
Spam: The listing contains a large amount of words and links unrelated to the add-on’s functionality clearly intending to increase SEO rating. | Reject Immediately |
Trademarks: The add-on is named “Mozilla Frobnicator”, “Firefox Spice Dispenser” or similar, instead of “Frobnicator for Mozilla” or “Spice Dispenser for Firefox”. | Reject Immediately |
Trademarks: The add-on is related to Pocket, and is named “Pocket Reader” or similar, instead of “Reader for Pocket”. | Reject Immediately |
The add-on’s code, functionality or service used indicates that payment is required to use the core functionality of the add-on but the developer has not selected this option in the listing. | Delayed Reject |
The add-on only functions within a closed environment, such as only for employees of a specific company (“internal or private use”). | Reject Immediately |
Users can only sign up to the service using a “contact us” link on the website. There is no apparent web sign-up process (“only accessible to a closed user group”). (Note that especially on sites with foreign languages, maybe you just missed it. Best to ask the developer to provide information on how a user would sign up. If they can’t provide the information or confirm there is no web sign-up process, the add-on can be rejected). |
Reject Immediately |
The add-on is a fork of another add-on, while not providing a significant difference in functionality or code. | Reject Immediately |
The add-on listing is well described, but requires knowledge of the specific system being used in combination with the add-on. | Approve |
The add-on advertises functionality as part of the extension, that is provided completely by a website or third party application. The add-on merely opens the website. | Reject Immediately |
The add-on advertises itself as a companion for a website or third party application, and offers functionality to provide data to the website. The main functionality is provided by the add-on. | Approve |
The add-on’s website or support website is not related to the add-on’s functionality. | Delayed Reject |
Submission Guidelines
Example | Verdict |
---|---|
The add-on requires use of an external service that is only available with login credentials, and the developer has not provided them. | Delayed Reject |
The add-on contains obfuscated code (as opposed to minified code). (Please see the Source Code Submission page on how to differentiate obfuscated and minified code. Not everything that is unreadable is obfuscated.) |
Reject Immediately |
The add-on contains obfuscated code that seems to intentionally violate the policy. | Reject Immediately and Escalate |
The add-on contains transpiled, minified or otherwise machine-generated code and has not provided source code. | Delayed Reject |
The add-on requests additional permissions that are not required for the add-on to function. | Delayed Reject |
The add-on contains transpiled, minified or otherwise machine-generated code and the source submission relies on outdated or unmaintained build tools | Delayed Reject |
Development Practices
Example | Verdict |
---|---|
The add-on requests additional permissions that are not required for the add-on to function. The developer argues they will need them in a future update. | Delayed Reject |
The add-on loads and executes remote code. If there is reason to believe the add-on is intentionally loading remote code, please escalate to a block. |
Reject Immediately |
The add-on uses a http channel to exchange information, while it is possible for the developer to use https. If the developer has control over the remote infrastructure and can enable servers to use https, you can reject as they need to take this step. If the choice of http is outside of the developers hands, you may approve. |
Reject Immediately |
The add-on makes use of http as a result of the user entering an url that uses http. Note: If such URLs can be upgraded to https, the developer should make reasonable effort to inform the user about an insecure connection and attempt to upgrade to https. |
Delayed Reject |
The add-on contains a large amount of duplicate files, or files not loaded by the add-on. | Delayed Reject |
There is a noticeable impact on performance, for example opening a new tab takes very long because the new tab page is very resource-intensive. | Reject Immediately |
The developer has not provided links to third party libraries, the links do not point to the original maintainer’s website, the library does not match the original checksum from the developer. The developer should be asked to provide the link where they received the library as per the Third Party Libraries Usage guidelines. If there is any indication that the modifications are intentionally violating policy, please reject immediately and escalate. |
Delayed Reject |
The add-on sets a new tab page that redirects to a remote page. | Reject Immediately |
Data Disclosure, Collection and Management
This section has a few items related to the privacy policy. We do not check the privacy policy for correctness. We do however make sure the privacy policy is more than just a link and generally about the add-on.
Example | Verdict |
---|---|
The add-on uses a privacy policy which is merely a link to an external website. | Delayed Reject |
On a quick skim, the privacy policy seems to be about a website more than it is about the add-on. | Delayed Reject |
The add-on is listed and doesn't link to its privacy policy hosted on AMO on its data collection consent page | Delayed Reject |
The add-on is listed and links to a self-hosted privacy policy (as opposed to AMO hosted) on its data collection consent page | Reject Immediately |
The add-on is unlisted and doesn't link to a self-hosted privacy policy on its data collection consent page | Reject Immediately |
The add-on makes use of native messaging, but does not explain the data exchanged with this application in the privacy policy. | Delayed Reject |
After code review it is clear that the add-on exchanges data with a third party service, but the add-on description and summary do not include a summary of the information collected. | Delayed Reject |
The add-on exchanges data with a native application via native messaging, but the data being exchanged is not summarized in the description nor mentioned in the privacy policy. | Delayed Reject |
The add-on exchanges data with a native application, but the data is not declared in the data collection consent experience within the add-on. | Reject Immediately |
The add-on provides a search box for Google, Bing, Amazon etc. and search requests go through another website. | Reject Immediately |
The add-on collects tab urls and is sending them as part of a request that doesn’t relate to actions based on the URL. This is considered ancillary data collection. | Reject Immediately |
The add-on collects personal data, technical data, or user interaction data, and does not have a consent prompt when the add-on is first run (e.g. installed). | Reject Immediately |
The add-on has a consent prompt, but it does not describe the data being collected | Reject Immediately |
The add-on has a consent prompt that makes use of dark patterns to entice the user to accept. | Reject Immediately |
The main purpose of the add-on is to collect and analyze form data. Therefore, the add-on collects personal data such as the name and email of the user and sends the data to the service, but without an opt-in for personal data. | Reject Immediately |
An add-on collects all visited browser URLs without notice, as part of a feature that does not relate to the primary functionality of the add-on. | Reject Immediately |
The add-on exchanges data via native messaging that does not belong to the primary functionality of the add-on and fails to adhere to the no surprises requirements. | Reject Immediately |
The consent experience only offers the option to accept the data collection. | Reject Immediately |
The consent experience offers the option to accept or uninstall, but the main functionality of the add-on will technically work without this type of data collection. If the developer argues that collecting the data is required for business purposes, e.g. to maintain the add-on, this does not warrant an accept or uninstall behavior. |
Reject Immediately |
The add-on collects technical data and does not provide a way for the user to disable this type of data collection. | Reject Immediately |
The add-on combines both personal and technical data into one option and does not provide a way to control them separately. | Reject Immediately |
An update to the add-on adds consent experience but it is only displayed to new users and not to existing users upgrading to a newer version. | Reject Immediately |
An update to the add-on contains additional data collection but that data isn't declared in the consent experience and/or the consent isn't displayed again to existing users upgrading to this version. | Reject Immediately |
The consent experience is not shown immediately after installation, but the add-on does not collect any data until the user sees the consent. (For example, consent experience is shown at browser action click). | Delayed Reject |
The consent experience is not shown immediately after installation, but data is being collected before the user can see the control mechanism. | Reject Immediately |
The add-on collects personal data, technical data, or user interaction data and does not have a consent experience. | Reject Immediately |
Additional Privacy Protocols
The add-on passes on cookies or other user-sensitive information to a native messaging application. | Reject immediately |
The add-on stores information about tabs, but fails to exclude storing information from private browsing mode tabs. | Delayed Reject |
Monetization
Monetization follows the same data disclosure policies as for other data and includes a few extra provisions to set user expectations. We define monetization as a feature of the add-on that results in a potential monetary benefit for the developer.
Example | Verdict |
---|---|
The add-on monetizes by injecting ads into web pages, but fails to identify the content as belonging to the add-on. | Reject Immediately |
The add-on includes a crypto-mining function that mines coins in the background for the profit of the developer. | Reject Immediately |
The add-on contains a crypto-mining function for the profit of the user (this is still a performance issue). | Reject Immediately |
The add-on shows information about crypto coins by querying a web service for information (this is not mining). | Approve |
The add-on changes all Amazon/Yahoo/etc. links on web pages to add affiliate tags to profit the developer. | Reject Immediately |
The add-on has links that include affiliate tags within the browser popup of the add-on. | Approve |
Security, Compliance & Blocking
Example | Verdict |
---|---|
The add-on injects remote data into an extension page or web page using innerHTML or other methods without prior sanitation. | Reject Immediately |
The add-on makes use of React’s dangerouslySetInnerHTML with remote unsanitized data. | Reject Immediately |
The add-on makes use of remote CSS scripts, which can cause security vulnerabilities in combination with libraries such as React and Angular. | Reject Immediately |
The add-on seems to be intentionally violating our policies, such as collecting a cryptocurrency private key and sending it to a remote server. | Force Disable and Block |