Migrating to v6

This guide explains how and why to migrate from Material UI v5 to v6.

Start using the alpha release

In the package.json file, change the package version from latest to next.

package.json

-"@mui/material": "latest",
+"@mui/material": "next",

Using next ensures your project always uses the latest v6 alpha release. Alternatively, you can also target and fix it to a specific version, for example, 6.0.0-alpha.0.

Supported browsers

The targets of the default bundle have changed in v6.

The exact versions will be pinned on release from the browserslist query "> 0.5%, last 2 versions, Firefox ESR, not dead, safari >= 15.4, iOS >= 15.4".

The stable bundle supports the following minimum versions:

Chrome 109 (up from 90)
Edge 121 (up from 91)
Firefox 115 (up from 78)
Safari 15.4 in both macOS and iOS (up from 14 in macOS and 12.5 in iOS)
and more (see .browserslistrc (stable entry))

Support for IE 11 is completely removed, by dropping the legacy bundle and all IE 11 related code. This allows us to decrease bundle size and keep the scope manageable. If you need to support IE 11, you can use Material UI v5's legacy bundle, but it won't get updates or bug fixes.

Breaking changes

Since v6 is a new major release, it contains some changes that affect the public API. The steps you need to take to migrate from Material UI v5 to v6 are described below.

UMD bundle was removed

The UMD bundle is no longer provided. This was replaced in favor of ESM CDNs. Please refer to the CDN docs for alternatives.