Addons documentation status

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
670 12 (2%) 5 (1%) 80 (12%) 23 (4%) 26 (4%) 6 (1%) 46 (7%) 25 (4%)

See also localization status of this section.

No tags

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

Needs* tags

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

Missing tags

At least missing one of the following:

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

Editorial reviews

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

Technical reviews

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

Outdated pages

Found 6 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 46 bugs. Learn more about how to resolve a dev-doc-needed bug.

Bug Summary Release
648664 Create an MDC page listing all known XPCOM interface changes from Firefox 4 to 5 ---
934311 Javascript modules don't share definition of Array (and probably all other standard classes like String etc.) ---
630874 about:home doesn't work with unpacked omnijar ---
1198590 Disable dom.ipc.plugins.asyncInit in Firefox 40.0.3 ---
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
1047738 Make distribution code look for the distribution directory under Contents/Resources due to v2 signing requirements Firefox 35
1050944 Get Firefox to launch with the new .app bundle structure 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
770135 New PanelUI and toolbar customization (Milestone 1) Firefox 28
752434 Stop hiding toolbars for about:addons & Co. Firefox 28
943683 Annotate buttons when we migrate them from the add-on bar to the toolbar. 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
822367 Implement Mixed Content Blocker Doorhanger - Backend Changes mozilla21
831428 ContentChild's nsIConsoleListener should have threadsafe addref/release methods 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
758812 Break up browser.js into smaller pieces, Phase 1 Firefox 15
641892 Support showing multiple popup notification icons at the same time 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

Browse as bug list.

Documentation requests

Found 25 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
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
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
1441356 Incorrectly labeled diagram for webextension native messaging.
1466397 for tutorial "Your second WebExtension"
1471421 webRequest.onHeadersReceived is returning "ip" information but it is not documented
1515455 browser.tabs.duplicate is not a function

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 652 1 (0%) 0 (0%)
bn-BD 652 9 (1%) 0 (0%)
de 652 21 (3%) 3 (14%)
es 652 35 (5%) 6 (17%)
fa 652 6 (0%) 1 (16%)
fr 658 640 (97%) 548 (85%)
it 652 11 (1%) 3 (27%)
ja 661 197 (29%) 71 (36%)
ko 652 23 (3%) 1 (4%)
pl 652 15 (2%) 4 (26%)
pt-BR 652 29 (4%) 9 (31%)
pt-PT 652 49 (7%) 8 (16%)
ro 652 2 (0%) 0 (0%)
ru 652 43 (6%) 12 (27%)
zh-CN 652 97 (14%) 30 (30%)
zh-TW 652 36 (5%) 7 (19%)


Tagging standard

  • "Add-ons"

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

Contact us