AMO Review Process: What Happens After You Submit a Firefox Extension
Submitting a Firefox extension to addons.mozilla.org (AMO) is the end of development but the beginning of a review process. Here's what to expect.
Two Review Tracks
Self-reviewed (Recommended for New Submissions)
- Listed as "Recommended" only after manual review
- Listed immediately but with a warning banner until reviewed
- Review takes days to weeks depending on queue
Unlisted Extensions
- No AMO listing — distributed via direct download
- Still needs to be signed by Mozilla
- Use case: internal tools, beta testing, distributions via other channels
What Gets Reviewed
Mozilla reviewers check:
- Code quality — Is the code readable? Obfuscated code is rejected.
- Permission justification — Do you need all requested permissions?
- Privacy — What data does it collect? Is there a privacy policy?
- Security — No remote code execution, no dangerous patterns
- Policy compliance — No deceptive behavior, no hidden functionality
The Automated Review (Instant)
When you submit, an automated system runs immediately and checks for:
- Known bad patterns (eval, remote code injection)
- Unverified permissions
- Manifest validity
- Basic policy violations
Most simple extensions pass this instantly and get a preliminary listing.
Preparing for Review
Don't minify your code
Minified code is flagged and will delay or block review. Submit readable source code.
// web-ext.config.mjs — exclude minification from AMO builds
{
artifactsDir: 'dist',
build: {
// Don't minify — AMO requires readable code
overwriteDest: true
}
}
Include a reviewer note
When uploading via the AMO developer dashboard, there's a "Notes to reviewers" field. Use it:
This is a new tab extension that shows live weather and world clocks.
How to test:
1. Install the extension
2. Open a new tab
3. The main features are visible immediately — weather (auto-detected location),
time, and search bar
4. Click the gear icon to access settings
No external APIs require authentication. Weather data from wttr.in (free, no key).
All data stored locally in browser.storage.sync.
List all permissions and explain them
If you request permissions reviewers might question, explain them in your description or reviewer notes.
{
"permissions": ["storage"],
"host_permissions": ["https://wttr.in/*"]
}
For this extension:
-
storage: Save user preferences (theme, location, clocks) -
https://wttr.in/*: Fetch weather data
Common Rejection Reasons
- Remote scripts: Loading JavaScript from external servers
- Eval usage: Dynamic code execution
- Misleading description: Claims that don't match behavior
- Missing privacy policy: Required if you collect any data
- Broad permissions: Requesting more than needed
The Timeline
- Automated review: Instant (minutes)
- Initial listing: Within hours of passing automated review
- Human review for Recommended status: Days to weeks
- Update reviews: Faster than initial — usually days
After Approval
Once your extension is listed:
- AMO generates install statistics (you can see weekly installs)
- Users can leave ratings and reviews
- You get email notifications for new reviews
- Firefox will auto-update users to new versions you submit
Updating Your Extension
For updates:
- Increment
versioninmanifest.json - Build with
npx web-ext build - Upload the new
.zipvia the AMO developer dashboard - The update goes through the same review process
- Users get the update automatically (usually within 24 hours of approval)
The Developer Dashboard
Most important pages:
-
addons.mozilla.org/en-US/developers/addon/{your-addon-slug}/edit— Edit listing -
addons.mozilla.org/en-US/developers/addon/{your-addon-slug}/versions— Version history -
addons.mozilla.org/en-US/developers/addon/{your-addon-slug}/statistics/— Install stats
My Experience
For Weather & Clock Dashboard, the initial submission went through automated review in about 30 minutes and got an initial listing. The human review for Recommended status is ongoing.
Key things that helped:
- Clean, unminified JavaScript
- Minimal permissions (
storage+ one host) - Detailed reviewer notes
- Privacy-first approach (no tracking, local storage only)
Weather & Clock Dashboard — free Firefox new tab extension. Live weather, world clocks, search bar. MIT licensed.
Top comments (0)