MDN Web Docs
MDN Web Docs is an open-source, collaborative project owned by the Mozilla Corporation that serves as a comprehensive, free resource for web developers, offering detailed documentation, tutorials, and guides on open web technologies including HTML, CSS, JavaScript, and Web APIs, as well as learning pathways and tools to support building websites and progressive web applications.[1][2] Established by Mozilla and developed in partnership with a global community of contributors, MDN Web Docs has evolved since its inception into a trusted industry standard, with over 14,000 pages of documentation available in eight languages and attracting 17 million monthly unique users and over 80 million pageviews worldwide (as of 2025).[1][3][4][5] Its content is maintained by Mozilla's MDN team with support from volunteer contributors focused on accuracy, translations, and browser compatibility data, which is widely utilized by tools like Can I Use for cross-browser support information.[1] The project's mission is to empower developers globally to innovate and create an inclusive, open web by providing reliable, up-to-date information that bridges learning gaps for beginners and experts alike.[1] MDN collaborates with major organizations such as Microsoft, Google, Igalia, the W3C, and Open Web Docs to ensure its resources remain current with evolving standards and best practices.[1] Additionally, it offers premium features through MDN Plus, including AI-assisted tools for enhanced productivity.[1][6]Overview
Purpose and Scope
MDN Web Docs serves as a free, open-source, wiki-style platform that offers comprehensive documentation, tutorials, and learning resources for open web technologies, empowering developers to build accessible and innovative web experiences.[1] Launched in 2005 as DevMo by Mozilla, and rebranded as the Mozilla Developer Network (MDN) in 2010, it was established to consolidate scattered Mozilla and Netscape documentation into a unified hub, providing a centralized resource for web standards and developer tools.[7][1] This collaborative effort, maintained under a Creative Commons Attribution-ShareAlike license, encourages community contributions to ensure content remains accurate, up-to-date, and reflective of evolving web practices.[8] The primary focus of MDN Web Docs centers on client-side web standards essential for creating websites and progressive web applications, including HTML5 for structure, CSS for styling and layout, JavaScript for interactivity, and Web APIs for advanced functionality such as media handling, storage, and device integration.[9][1] These resources emphasize standards-compliant development, guiding users toward practices that enhance accessibility—through features like semantic HTML and ARIA attributes—performance optimization, such as efficient rendering and resource loading, and cross-browser compatibility to support an open web ecosystem. In addition to its core client-side coverage, MDN provides secondary documentation on server-side technologies, including tutorials on Node.js with the Express framework for JavaScript-based backends and Django for Python web applications, helping developers understand full-stack development workflows. It also includes resources on Mozilla-specific tools, such as Firefox Developer Tools for debugging and WebExtensions APIs for building browser add-ons, bridging browser-specific implementation with broader web standards. Overall, the scope prioritizes open technologies that promote interoperability, security, and inclusivity across the web platform.[1]Accessibility and Usage
MDN Web Docs provides free access to all its content without requiring user registration, enabling developers worldwide to read and reference documentation immediately upon visiting the site.[10] For those wishing to contribute edits or personalize their experience through features like saving collections, an optional login via a Mozilla account is available.[10] This open model ensures broad reach, serving over 15 million users monthly and attracting over 100,000 contributors since its inception in 2005.[1][11][3] The platform emphasizes intuitive navigation and search capabilities to facilitate efficient use. A prominent search bar allows users to query topics like HTML or JavaScript directly, while structured sidebars and categorized sections—such as Web APIs or CSS references—enable easy browsing across its 45,000 pages.[1] Additionally, MDN Web Docs employs responsive design principles, adapting its layout seamlessly for desktop, tablet, and mobile devices to support developers working on various screen sizes. To enhance practical learning, MDN integrates runnable code examples, interactive demos embedded via iframes, and browser compatibility tables powered by the Browser Compatibility Data (BCD) API.[12][13] These elements allow users to experiment with code snippets in real-time and check cross-browser support without leaving the documentation, promoting hands-on understanding of web technologies. In 2022, Mozilla introduced MDN Plus, a subscription service offering an ad-free viewing experience and offline access through a progressive web app, catering to users seeking uninterrupted productivity.[14] This feature complements the core free offerings, with tiered plans starting at no cost for basic enhancements.[6]History
Origins and Early Development (2005–2016)
MDN Web Docs originated from efforts to consolidate and revitalize developer resources following the decline of Netscape's DevEdge documentation site, which AOL had archived after acquiring Netscape. In February 2005, Mozilla's leadership, including Mitchell Baker and Deb Richardson, announced plans to create a new, community-driven platform by curating and migrating DevEdge content alongside existing documentation from mozilla.org. This unification aimed to provide a centralized hub for web developers working with open standards and Mozilla technologies.[7] The platform launched on July 23, 2005, as the Mozilla Developer Center (MDC), commonly referred to as DevMo, marking the official start of what would become MDN Web Docs. From its inception, MDC adopted a wiki model powered by MediaWiki software, enabling open editing and contributions from the community to foster collaborative documentation. This early emphasis on accessibility allowed developers to update and expand content dynamically, setting the foundation for a living resource.[7] In its initial years, the site's content primarily focused on Mozilla-specific technologies, including detailed guides for Firefox development, the XUL markup language for building user interfaces in Mozilla applications, and documentation for emerging web standards such as HTML, CSS, and JavaScript implementations in Gecko, Firefox's rendering engine. This Mozilla-centric approach addressed the needs of developers building extensions, applications, and web content optimized for Firefox, while also covering broader open web technologies to support cross-browser compatibility. By 2007, the growing contributions had expanded the site's scope, with thousands of pages contributed by volunteers.[7] A significant milestone occurred in August 2008 when MDC transitioned from the open-source MediaWiki to Deki Wiki, a proprietary platform, to improve editing features and scalability, though this move temporarily limited some open-source aspects. To reaffirm its commitment to openness, the site underwent a major backend migration in 2012 to the Kuma platform, an open-source system built on Django and Python, which stored content in standard HTML formats and enhanced internationalization support. This shift ensured that all documentation was version-controlled and freely modifiable, aligning with Mozilla's open web principles.[7] In September 2010, the platform was rebranded as the Mozilla Developer Network (MDN) to reflect its evolution into a broader "network" connecting developers worldwide, rather than being limited to Mozilla's ecosystem. The rebranding introduced a new visual identity, including the iconic "dino" logo, and emphasized vendor-neutral documentation on web standards to appeal to a wider audience beyond Firefox and Mozilla tools. This change was accompanied by structural improvements, such as a persistent navigation sidebar, to enhance usability for documenting complex APIs and technologies.[7] By 2015, marking its tenth anniversary, MDN had grown substantially, hosting over 34,500 documents across 42 languages and serving as a primary reference for web developers globally. The site's emphasis on accurate, community-vetted content for web standards solidified its reputation, with ongoing refinements to the interface improving discoverability of topics like progressive web apps and browser APIs. Throughout this period, MDN remained under Mozilla's stewardship, prioritizing open collaboration to document the evolving web landscape up to 2016.[15]Expansion and Partnerships (2017–2020)
In 2017, Mozilla announced a collaborative agreement with Google, Microsoft, Samsung, and the World Wide Web Consortium (W3C) to establish MDN Web Docs as the primary, unified source of documentation for web technologies, fostering cross-browser compatibility and developer resources.[16] This partnership formed the MDN Product Advisory Board (PAB), comprising representatives from these organizations, to guide content prioritization and ensure up-to-date, comprehensive coverage of web standards.[17] The initiative specifically aimed to reduce redundant documentation efforts across companies by consolidating resources on MDN, with Microsoft redirecting its MSDN Web API pages to MDN and committing writers to contribute directly.[16] In its first year, Microsoft alone made over 5,000 edits to MDN content.[16] Building on this collaboration, MDN expanded its content beyond Mozilla-specific topics to encompass a broader range of web platform APIs and tools, including contributions from partner companies on emerging standards like CSS Grid and WebAssembly.[18] Over the 2017–2020 period, more than 3,000 new articles were added, enhancing coverage of JavaScript, HTML, and CSS reference materials to support diverse browser ecosystems.[18] Interactive examples were integrated into reference pages starting in 2017, allowing developers to experiment with code snippets directly on the site, which improved practical understanding of APIs and reduced reliance on external testing environments.[19] From 2018 to 2019, MDN undertook content audits to standardize documentation quality, including a major migration of browser compatibility data to a structured JSON format stored in a public GitHub repository, covering over 8,000 pages and enabling easier updates and community verification.[18][20] These efforts also introduced learning pathways, such as the 2019 Front-end Developer pathway, which provided structured modules on topics like client-side frameworks (e.g., React and Vue.js) to guide beginners through progressive skill-building.[18] On December 14, 2020, MDN launched its new platform, codenamed Yari, a React-based system designed for enhanced performance and seamless integration with GitHub for content management.[21] Yari replaced the legacy Kuma platform by decentralizing editable content to a GitHub repository, allowing contributions via pull requests and CLI tools, which streamlined workflows and reduced maintenance overhead while supporting faster page loads.[21][3] This upgrade marked the culmination of the period's technical and collaborative advancements, positioning MDN as a more scalable resource for the global developer community.[21]Modern Era and Open Web Docs (2021–present)
In January 2021, Mozilla announced the launch of Open Web Docs (OWD) on January 25 as an independent non-profit organization dedicated to sustaining MDN Web Docs through collective funding and technical writing efforts, ensuring its independence from any single vendor.[22][23] This initiative emerged in response to Mozilla's reduced direct involvement following staff layoffs in 2020, with OWD taking on the primary role of funding content creation and maintenance for MDN's web platform documentation.[24][25] Building on the infrastructure established by the Yari platform launched in 2020, MDN underwent a significant redesign in March 2022, enhancing mobile responsiveness and user navigation while introducing MDN Plus, a subscription service offering personalized features such as offline access and advanced search capabilities.[26][1][27] MDN marked its 20th anniversary on July 23, 2025, celebrating two decades of community-driven documentation for open web technologies, with over 14,000 English pages, 33,000 localized articles, and contributions from more than 100,000 developers via GitHub.[11] On August 19, 2025, MDN launched a new front-end interface, improving site navigation, search functionality, and overall user experience for better accessibility across devices.[28] In 2024, MDN pursued several key content projects under OWD's oversight, including a comprehensive audit of its HTTP documentation from July to December, which updated over 300 pages on headers, status codes, and related guides with fresh examples, improved formatting, and refreshed browser compatibility data.[29] Additionally, the Learn Web Development section received a major revamp starting in November and culminating in publication by December, merging the separate MDN Curriculum into a unified structure with reorganized modules on core topics like HTML, CSS, and JavaScript, alongside added learning outcomes and educator resources.[30][31] By 2025, MDN continued advancing its documentation on emerging standards, with notable updates to Web Components APIs in September that expanded coverage of custom elements, shadow DOM, and slots to support modular UI development.[32] Privacy-focused APIs also saw integrated enhancements throughout the year, including October revisions to guides on secure contexts, Permissions API, and third-party cookie deprecation to address evolving web privacy requirements.[33][34] These efforts underscored OWD's ongoing commitment to maintaining MDN as a vital, up-to-date resource for open web technologies.[35]Content Structure
Core Topics and Documentation Types
MDN Web Docs provides comprehensive reference documentation for web technologies, detailing syntax, methods, and properties of key elements. For HTML, this includes specifications for elements like<div> and <form>, covering attributes, content categories, and permitted contexts. In CSS, properties such as display and flex are explained with values, initial settings, and inheritance rules. JavaScript reference pages focus on core language features, including detailed entries for objects like Array.prototype, which list methods such as map() with syntax (e.g., array.map(callback(element, index, array), thisArg)), parameters, return values, descriptions, polyfill code, and browser compatibility tables.
Guides and tutorials on MDN offer practical, step-by-step instructions for implementing web features. These resources guide users through building basic websites, from creating HTML structures to styling with CSS Grid and adding interactivity via JavaScript events. For Web APIs, tutorials cover the Fetch API, explaining how to perform HTTP requests with code examples like fetch('https://api.example.com/data').then(response => response.json()).then(data => console.log(data));, including error handling and integration with async/await. Guides also address advanced topics, such as using the Canvas API for 2D graphics or the Geolocation API for location-based services.
The Learn section delivers structured modules designed to build core front-end skills progressively. It includes pathways for beginners, such as "Getting started with the web," which introduces HTML for document structure, CSS for layouts like Flexbox and Grid, and JavaScript fundamentals. A major revamp in late 2024 merged the MDN Curriculum with the existing Learn content, enhancing modules on HTML structuring (e.g., semantic elements like <article> and <section>) and CSS layouts to align with modern best practices and accessibility standards. These modules feature assessments, challenges, and linked GitHub repositories for hands-on practice.[36][30]
Specialized topics extend MDN's coverage to emerging and niche web technologies. Documentation on WebAssembly details its binary instruction format, integration with JavaScript via the WebAssembly JavaScript API, and use cases like high-performance computations in browsers. Service workers are explored through guides on their lifecycle, event handling (e.g., install, activate, fetch), and role in enabling Progressive Web Apps (PWAs) for offline functionality. Accessibility guidelines integrate WCAG principles, with resources on ARIA attributes, keyboard navigation, and semantic HTML to ensure inclusive web experiences.
Throughout all documentation types, MDN emphasizes practical examples with interactive code snippets that allow users to edit and preview code in real-time using embedded editors. Compatibility charts, often powered by data from sources like CanIUse, provide browser support matrices for features, such as percentage adoption rates for CSS properties or API availability across Chrome, Firefox, Safari, and Edge. These elements enhance usability by combining theoretical explanations with verifiable, testable implementations.
Localization and Multilingual Support
MDN Web Docs extends its global accessibility by providing content in eight primary languages: English, Chinese (including simplified and traditional variants), French, Japanese, Korean, Portuguese (Brazilian), Russian, and Spanish, as of 2025.[4] This multilingual support enables developers worldwide to access documentation in their preferred language, fostering broader adoption of web technologies.[4] The localization process is community-led, with translations coordinated through the mdn/translated-content GitHub repository, where volunteers contribute edits, reviews, and new translations following established guidelines.[37] reflecting sustained community efforts to cover key topics like JavaScript and web APIs. Non-English versions are supported by tools that allow users to suggest translations directly via GitHub issues or pull requests.[38] To enhance relevance, localizations incorporate language-specific adjustments, such as culturally adapted examples in tutorials and emphasis on region-specific technologies, for instance, detailed coverage of payment APIs tailored to European regulatory contexts in French and Spanish versions.[4] These adaptations ensure that documentation resonates with diverse audiences while maintaining technical accuracy. A primary challenge in MDN's localization is synchronizing non-English versions with the English master content, as updates to the primary documentation can lead to outdated translations if not promptly addressed by community teams.[4] This has resulted in the archiving of previously unmaintained locales to prioritize quality and currency in active languages.[4]Ownership and Funding
Mozilla's Role
Mozilla Corporation founded the project in 2005 as the Mozilla Developer Center (DevMo), which was rebranded as the Mozilla Developer Network (MDN) in 2010, to serve as a centralized resource for documentation on open web standards, Mozilla projects, and developer guides.[7] As the current owner of the site, Mozilla has maintained overarching responsibility for its operation since inception, ensuring its availability as a key resource for web developers worldwide.[1] Mozilla provides essential infrastructure for MDN Web Docs, including hosting the platform on developer.mozilla.org and integrating it with Firefox Developer Tools, where users can access contextual MDN documentation directly from panels like the Inspector and Console for real-time reference on web APIs and elements.[25] Additionally, Mozilla employees directly contribute to content creation, particularly authoring and updating documentation on the Gecko rendering engine and Firefox-specific features, such as WebExtensions APIs and DevTools extensions.[39] Post-2021, following significant layoffs of MDN's in-house writing team in 2020 and the subsequent formation of the Open Web Docs initiative, Mozilla reduced its direct funding for broad content production, shifting emphasis toward open web standards documentation while deprioritizing proprietary or Mozilla-specific materials.[40] This transition allowed Mozilla to focus resources on infrastructure maintenance and targeted contributions, sustaining MDN's role in promoting universal web technologies.[24] Mozilla holds the trademark for "MDN," exercising oversight of brand guidelines to ensure consistent use across the platform and related materials.[41]Open Web Docs Initiative
The Open Web Docs (OWD) organization was founded in January 2021 as an independent, vendor-neutral non-profit open collective to ensure the long-term sustainability of open web documentation, with a primary focus on coordinating content strategy and contributions for MDN Web Docs.[22][42] OWD's core responsibilities include developing and maintaining content roadmaps, hiring full-time and part-time technical writers and editors, and upholding neutrality in documentation by avoiding bias toward any single vendor or technology stack. This work supports the creation of comprehensive, accurate resources for web developers worldwide, emphasizing open standards and interoperability. In January 2025, OWD released its 2024 Impact and Transparency Report, detailing progress on documentation for emerging web standards.[43][35] As of November 2025, OWD's principal sponsors comprise Platinum-level contributors Google and Microsoft, Gold-level sponsors Igalia (renewed in March 2025) and Bloomberg (joined in March 2025), and Silver-level sponsor Canva; these partnerships fund targeted projects, such as grants from the Sovereign Tech Fund for documentation enhancements and data initiatives.[44][45][46] The organization's funding model centers on tiered corporate sponsorships (ranging from Silver at $5,000 annually to Platinum at $250,000 annually), grants for specific efforts, and individual donations via platforms like Open Collective, enabling independent operation while MDN Web Docs remains hosted by Mozilla.[42][25] A notable development in 2024 was the expansion of sponsored content projects to address emerging web standards, including comprehensive documentation for WebGPU to support high-performance graphics and compute capabilities on the web.[35][47]Community and Contributions
Contributor Base
MDN Web Docs benefits from a diverse contributor base exceeding 45,000 registered individuals since its inception, with over 100,000 contributors interacting via the GitHub organization as of July 2025, including independent developers, educators, technical writers, and employees from technology companies worldwide.[48][3][11] These contributors span various professional backgrounds and skill levels, from beginners enhancing their knowledge through documentation tasks to seasoned experts authoring in-depth guides on web technologies. Prominent organizational contributors include Mozilla, which maintains foundational oversight; Google, Microsoft, and Samsung, whose engineers regularly provide expert reviews, technical accuracy checks, and content contributions to ensure comprehensive coverage of web standards.[16][49][50] This collaborative involvement, initiated through partnerships announced in 2017, has integrated expertise from browser vendors to bolster the reliability and breadth of the documentation.[51] The contributor demographics reflect a global distribution, with robust participation from Asia—particularly through dedicated localization efforts in Japanese and Chinese communities—and significant input from Europe via French and Russian translators.[4] MDN's eight active localized locales, including zh-CN, zh-TW, ja, fr, and ru, are sustained by these international teams, enabling access for non-English-speaking developers and broadening the platform's reach.[4] To foster engagement, MDN recognizes outstanding contributors through spotlight features that profile individual achievements and annual impact reports from initiatives like Open Web Docs, which highlight top editors and quantify community efforts.[52][35] In 2024, contributions from independent developers surged via GitHub pull requests, with 915 unique authors adding to the mdn/content repository, underscoring the growing role of grassroots involvement in the project's evolution.[29]Editing and Review Processes
The editing process for MDN Web Docs relies on a GitHub-based workflow introduced in 2020, where contributors fork the officialmdn/content repository, edit files using Markdown for prose and YAML for metadata such as browser compatibility tables, and submit changes via pull requests.[3][53][54]
Pull requests are reviewed in stages by MDN editorial staff from partners like Mozilla, Google, and Open Web Docs, as well as trained community volunteers, with checks focusing on technical accuracy, clarity, and completeness. Technical accuracy is verified by domain experts who ensure alignment with web standards from organizations such as the WHATWG and W3C, while adherence to the MDN writing style guide covers aspects like tone, structure, and formatting to maintain consistency across the documentation.[53][55][56]
Editorial policies prohibit original research or opinion-based content, requiring all technical claims to cite primary sources like official specifications from the WHATWG, W3C, or other standards bodies, with specification tables often included to link directly to these documents.[57][58][56]
For multilingual support, approved English pull requests feed into localization queues managed through dedicated repositories for Tier 1 languages, where volunteer translators adapt content while preserving technical fidelity.[4][59]
Contributors utilize tools integrated into the repository, such as a local preview server set up via Node.js and Yarn—run with commands like yarn start to view changes at http://localhost:5042/—and automated linters that enforce Markdown syntax, style consistency, and error detection before submission.[3][60]
To minimize duplication, MDN employs a macro system based on KumaScript, enabling reusable content snippets like browser compatibility summaries or sidebar elements; these are embedded in Markdown files using syntax such as {{Compat("api.Math")}}, which dynamically pulls and renders shared data across pages.[61][62]
Once reviews are complete and any revisions addressed, merged pull requests trigger automated builds, deploying updates to the live site typically within 24 hours.[53]
Technical Infrastructure
Platform Evolution
Prior to 2020, MDN Web Docs operated on the Kuma platform, a Python-based system built with the Django framework and extended with wiki functionalities forked from the Kitsune project used for Mozilla Support. This setup enabled collaborative editing through a WYSIWYG interface and dynamic content rendering via macros, but it relied on a MySQL database that limited scalability and performance under high traffic.[7] In 2020, MDN underwent a major migration to the Yari platform, replacing Kuma with a modern architecture featuring a React frontend for client-side rendering. This change facilitated faster page load times by pre-generating static HTML files and improved SEO through better crawlability and structured data output. The shift to static site generation marked a key evolution, enhancing scalability by allowing content to be served efficiently from content delivery networks (CDNs) without real-time database queries. Search functionality is provided through integration with Algolia, enabling precise querying across the documentation.[21][63][64][65] Content storage transitioned fully to GitHub repositories, supporting versioned edits via pull requests. As of November 2025, Yari remains the core platform, with ongoing maintenance focused on performance and compatibility.[3]Content Management and Licensing
Since December 2020, all MDN Web Docs content has been stored in the officialmdn/content GitHub repository, utilizing Markdown files enhanced with frontmatter metadata for structured data such as page titles, slugs, and browser compatibility information.[3][21][66]
Version control is managed through Git's inherent history, enabling detailed tracking of changes, revisions, and authorship for every file and contribution. Obsolete or deprecated content, such as documentation for legacy technologies, is archived in dedicated sections like the MDN Archive of Obsolete Content to preserve historical reference while removing it from active navigation.[3]
MDN Web Docs content is licensed under Creative Commons Attribution-ShareAlike 2.5 or later versions (CC BY-SA 2.5+), applying to textual documentation and requiring attribution to "Mozilla Contributors," inclusion of the original title and URL, and notation of any modifications. Code examples and polyfills, however, fall under the more permissive CC0 public domain dedication (unless otherwise specified), facilitating broad reuse without attribution obligations to encourage developer adoption and integration.[67]
The Open Web Docs (OWD) organization, which stewards MDN content, employs a dedicated team of technical writers and reviewers who oversee content strategy, including the systematic deprecation of outdated specifications—such as marking legacy HTML elements like <applet> or <frame> as obsolete to align with modern web standards.[68][69]