Browser compatibility tables

How we manage the contents of browser compatibility tables

Browser compatibility tables on MDN Web Docs are generated from mdn/browser-compat-data (also known as BCD). While MDN content and BCD are closely related projects, they’re not directly tied to each other. This page describes the relationship between MDN content and BCD.

MDN Web Docs and BCD are distinct projects

MDN Web Docs content is managed separately from browser compatibility data. BCD has its own governance, contribution process, and content guidelines.

MDN uses browser compatibility data to generate browser compatibility tables (plus some other site content). MDN uses the data as provided, including:

  • Feature descriptions
  • Support status and reported version numbers
  • Notes
  • Experimental, standards track, and deprecation status

That said, MDN does not necessarily use all compatibility data. For example, some features in BCD don’t have corresponding pages on MDN. Historically, certain browsers were part of BCD, but weren’t included in compatibility tables on MDN.

The MDN site is just one of many consumers of BCD. While MDN’s needs influence the direction and contents of BCD, they’re not determinative.

Update data

To change the details of individual compatibility tables on MDN, contribute directly to BCD.

Add a browser or engine

From time to time, MDN has added new browsers and engines to compatibility tables. The MDN team selects browsers and engines to appear, weighing factors including:

  • Relevance to open web platform technologies, both today and in the future
  • Reader benefit and interest
  • Maintenance requirements and impact on contributors
  • Alignment with MDN’s mission

In practice, selecting a browser requires two interdependent decision-making processes:

  • Adding the browser or engine to BCD
  • Selecting the browser or engine to appear on MDN

Since these processes can overlap, it presents something of a chicken-or-the-egg problem. To recommend adding a browser to MDN, follow these steps:

  1. Review BCD’s Addition of browsers guideline.

  2. Start a discussion on the mdn/content repository proposing to add the browser and mention @mdn/yari-content.

  3. Complete the browser selection questionnaire.

    If you’re comfortable sharing your responses publicly, do so; otherwise, ask in the GitHub discussion for a Mozilla email contact.

    If needed, the MDN team may ask follow-up questions.

  4. Wait for the team to consider your recommendation.

Whether your recommendation is selected, deferred, or rejected, we’ll follow up in the GitHub discussion with next steps.

Browser selection questionnaire

Answer these questions to recommend a browser (or engine) to MDN compatibility tables:

  1. Why do you want this browser added to MDN (and BCD)?
  2. How many users and developers do you estimate the browser has? How did you make this estimation?
  3. What’s the governance model of the browser? For example, who owns it, what is or is not open source, who participates in its development, and how is it funded?
  4. What is on the browser’s roadmap for the next year? How do you see the browser’s compatibility or support for existing tools changing in the future?
Last modified September 12, 2022: fix: MD029 ordered style (#20579) (c7048a8743)