Skip to content

Browser support

Material for MkDocs goes at great lengths to support the largest possible range of browsers while retaining the simplest possibilities for customization via modern CSS features like custom properties and mask images.

Supported browsers

The following table lists all browsers for which Material for MkDocs offers full support, so it can be assumed that all features work without degradation. If you find that something doesn't look right in a browser which is in the supported version range, please open an issue:

Browser Version Release date Usage
desktop mobile overall
Chrome 49+ 03/2016 25.65% 38.33% 63.98%
Safari 10+ 09/2016 4.63% 14.96% 19.59%
Edge 79+ 01/2020 3.95% n/a 3.95%
Firefox 53+ 04/2017 3.40% .30% 3.70%
Opera 36+ 03/2016 1.44% .01% 1.45%

Browser support matrix sourced from

Note that the usage data is based on global browser market share, so it could in fact be entirely different for your target demographic. It's a good idea to check the distribution of browser types and versions among your users.

Other browsers

Albeit your site might not look as perfect as when viewed with a modern browser, the following older browser versions might work with some additional effort:

  • Firefox 31-52 – icons will render as little boxes due to missing support for mask images. While this cannot be polyfilled, it might be mitigated by hiding the icons altogether.
  • Edge 16-18 – the spacing of some elements might be a little off due to missing support for the :is pseudo selector, which can be mitigated with some additional effort.
  • Internet Explorer - no support, mainly due to missing support for custom properties. The last version of Material for MkDocs to support Internet Explorer is 4.6.3.

  1. The data was collected from in January 2022, and is primarily based on browser support for custom properties, mask images and the :is pseudo selector which are not entirely polyfillable. Browsers with a cumulated market share of less than 1% were not considered, but might still be fully or partially supported.