This page tracks documentation status and work progress for Add-ons documentation. Feel free to contribute!


Pages No tags Needs* tags Missing tags Editorial reviews Technical reviews Outdated pages Dev-doc-needed bugs Documentation requests
632 9 (2%) 2 (1%) 0 (0%) 8 (2%) 30 (5%) 245 (39%) 55 (9%) 33 (6%)

See also localization status of this section.

No tags

Found 9 pages. Learn more about how to tag pages.

Needs* tags

Found 2 pages. Learn more about how to deal with meta-tags.

Editorial reviews

Found 8 pages. Learn more about how to do an editorial review.

Technical reviews

Found 30 pages. Learn more about how to do a technical review.

Outdated pages

Found 245 pages. These pages haven't been updated in over a year. Outdated pages can have problems with both content and format. Look at these pages and consider: Is this page talking about the Web of today? Does it look consistent with newer pages in this topic area? If not, make any needed changes.

Dev-doc-needed bugs

Found 55 bugs. Learn more about how to resolve a dev-doc-needed bug.

Bug Summary Release
1198590 Disable dom.ipc.plugins.asyncInit in Firefox 40.0.3 ---
648664 Create an MDC page listing all known XPCOM interface changes from Firefox 4 to 5 ---
630874 about:home doesn't work with unpacked omnijar ---
934311 Javascript modules don't share definition of Array (and probably all other standard classes like String etc.) ---
1383926 Stop defining Task.jsm lazy getter in browser.js and nsBrowserGlue.js Firefox 56
1282768 Convert permission notifications to use two buttons instead of the drop-down menu Firefox 53
1171746 Some panels stay open when switching or closing tabs Firefox 51
1160200 Add image/apng MIME type so it can be used with `picture` type switching. mozilla48
1014185 Remove the about:customizing preloading hack Firefox 47
1208715 Impose size restriction on extension icons Firefox 44
968923 Implement some equivalent of Chrome's use counters (on top of telemetry?) mozilla43
467729 RFE: Add font autoinstallation support Firefox 38
914596 Support building with Visual C++ 2013 mozilla36
714675 Fullscreen API should restore sidebar if it was open before entering fullscreen Firefox 36
1050944 Get Firefox to launch with the new .app bundle structure Firefox 35
1047738 Make distribution code look for the distribution directory under Contents/Resources due to v2 signing requirements Firefox 35
1032573 Implement Element.getAnimationPlayers mozilla33
998246 Add document.timeline interface mozilla32
947344 Australis - Show shortcuts for all widgets Firefox 32
987492 CustomizableUI.jsm should provide convenience APIs around windows Firefox 31
952568 [australis-measuring] Determine if Australis Update experience tab is active Firefox 30
970321 UITour: Menu panel broken if tour tab is opened in new window Firefox 30
949471 Firefox v26 returns undefined when it should return null mozilla29
942393 Document CustomizableUI Firefox 29
956162 UITour: When highlighting app menu button, highlight is offset to the left (Implement @flip="none") Firefox 29
944947 Label truncation is not fully supported in Australis menu widgets Firefox 29
819900 Please add a File constructor mozilla28
943683 Annotate buttons when we migrate them from the add-on bar to the toolbar. Firefox 28
770135 New PanelUI and toolbar customization (Milestone 1) Firefox 28
752434 Stop hiding toolbars for about:addons & Co. Firefox 28
927605 Refactor keyboard-shortcut-to-text-string code into a JSM or otherwise reusable module Firefox 27
602006 Remove Error Console Menu Items Firefox 24
650295 Add support for speech input mozilla22
844604 Text is too small on hidpi displays Firefox 22
831428 ContentChild's nsIConsoleListener should have threadsafe addref/release methods mozilla21
822367 Implement Mixed Content Blocker Doorhanger - Backend Changes mozilla21
815743 Backout the UA changes in bug 588909 and its follow-ups from all branches mozilla20
737153 Enable mounting storage through USB from a host machine mozilla15
641892 Support showing multiple popup notification icons at the same time Firefox 15
758812 Break up browser.js into smaller pieces, Phase 1 Firefox 15
736495 Some scripts are importing modules with resource:///gre instead of resource:/// and vice-versa Firefox 14
704400 Implement --enable-dmd mozilla11
706958 Add ClearOnShutdown() function which will clear a smart pointer on shutdown mozilla11
675553 Switch from PRBool to bool mozilla10
480735 Startup timeline mozilla1.9.3a5
462222 getZOrderDOMWindowEnumerator broken on Linux and Mac Firefox 3.6
627386 Add more wildcards to match-pattern 1.0
643156 No mechanism to perform cross-domain HTTP HEAD request with add-on builder ---
1002229 Add anonymous parameter to Request API ---
773297 widget ui doesn't get updated after customization of toolbar ---
994280 It would be nice to have ability to add badge over button mozilla35
1026543 expose the document.readyState property on tab instances (e10s) mozilla33
892203 Expose TextEncoder TextDecoder in SDK mozilla26
852687 nsIDOMWindowUtils should expose getInnerWindowWithId too mozilla24
642447 change default contentScriptWhen to new 'end' option that fires on 'load' event 1.0b5

Browse as bug list.

Documentation requests

Found 33 bugs. Documentation request bugs can contain various kinds work related to MDN pages. Read through the bug and ask questions in the bug if in doubt.

Bug Summary
1245339 explain the difference between dev-addons and dev-extensions mailing lists
1280032 Availability of options pages for webextensions on Firefox Mobile
1287590 Webpage can override WebExtension frames
1315123 Tutorial on MDN for the emoji substitution WebExtension example
1317797 Write a guide to storage in WebExtensions
1321519 manifest.json creator(s), developer(s), contributor(s), translator(s) properties, do they exist, are they documented?
1322213 Add-on version format consistency between docs, AMO, web-ext and browser?
1322750 Write a tutorial on building WebExtension UIs using React
1324310 AddonManager documentation broken due to missing AMInterface template
1325831 Need clear documentation for sending extension messages in WebExtensions (content script <-> extension)
1329043 WebExtensions resource page
1338153 Add an MDN doc about installing WebExtensions in enterprise environments
1340402 Add-on documentation for how to access external data sources
1343038 Documentation for new themes
1352962 How to develop WebExtensions for mobile (Firefox for Android, Fennec)
1359229 Make clear if an API is available from content scripts or not
1373152 Use arrow functions rather than separate functions for "then" of examples
1380729 Document all the sensitive requests that webRequest API doesn't grant access to
1383910 remove -moz-user-select limitation from browser_style
1385287 Incorrect Micro URL Path resulting in redirect
1395496 MDN: WebExt vs Privileged APIs needs review and update
1401950 Unclear status of supporting of storage.sync API
1411999 Document which permissions trigger user prompts in the different browsers
1413046 static vs. dynamic theme docs
1415798 Tutorials of "Implement a settings page" should use synced storage
1418265 webNavigation API: more transitionTypes in events than documentation reports
1424632 Firefox for Android only supports a saveAs value of false
1439438 Document compat status of individual TransitionType values
1441356 Incorrectly labeled diagram for webextension native messaging.
1462126 Can show us example of code why setTimeout and/or setInterval doesn't work with background pages?
1463892 Improve example for tabs.get()
1466397 for tutorial "Your second WebExtension"
1471421 webRequest.onHeadersReceived is returning "ip" information but it is not documented

Browse as bug list.


Please help us to localize this documentation into different languages. Read more about how to translate.

Language Pages Translated Translations up to date
af 632 1 (0%) 0 (0%)
bn-BD 632 9 (1%) 0 (0%)
de 632 19 (3%) 6 (31%)
es 632 37 (5%) 7 (18%)
fa 632 4 (0%) 0 (0%)
fr 632 582 (92%) 473 (81%)
it 632 7 (1%) 1 (14%)
ja 632 185 (29%) 91 (49%)
ko 632 23 (3%) 3 (13%)
pl 632 13 (2%) 4 (30%)
pt-BR 632 18 (2%) 2 (11%)
pt-PT 632 41 (6%) 11 (26%)
ro 632 2 (0%) 0 (0%)
ru 632 39 (6%) 6 (15%)
zh-CN 632 96 (15%) 29 (30%)
zh-TW 632 36 (5%) 22 (61%)


Tagging standard

  • TBD

Other tasks to do

  • TBD

Tutorial to-do list

  • TBD

Notes for translators

Any notes here? Where do we expect updates, so that localizers don't translate and update too often?


These macros are maintained and actively used in the MDN Add-ons area.

  • AddonSidebar: the main sidebar used for all Add-ons pages
  • WebExtAPISidebar: the piece of the main sidebar used in WebExtension API reference pages
  • WebExtAPIRef: used for cross-references in WebExtension API reference pages
  • WebExtChromeCompat: used to insert Chrome compatibility information into WebExtension API reference pages
  • WebExtExamples: generates links of applicable examples in WebExtension API reference pages
  • WebExtAPIEmbedType: used to insert the details of a WebExtension "type" into another page
  • WebExtBrowserCompat: generates browser compatibility tables from JSON data
  • WebExtBrowserCompatTable: generates a single compat table for a whole API or a single API item
  • WebExtBrowserCompatSummaryTable: generates a summary compatibility table for a module from JSON data
  • WebExtAllCompatTables: generates a list of all API compat tables
  • WebExtAllExamples: generates a list of all API examples
  • WebExtAPIOverview: generates an overview page for WebExtension APIs

Help the 'Addons' documentation project…
Topic driver : Eric Shepherd (IRC nickname: sheppy)
Look at the current status of the 'Addons' documentation.
Don't hesitate to contact us on #mdn or on the MDN discourse group/list:

Document Tags and Contributors

Contributors to this page: ExE-Boss, wbamberg, jswisher, fscholz, Sheppy
Last updated by: ExE-Boss,