@mui/material
9.5.0 · 9 Oct 2026MIT14.9M / weekRepositoryHomepagenpmAtom feed
5.18.0 is the newest release of 5.x.
In short
1 breaking
- Breaking
[core] Do not reexport Base from Material
Release note
The section about @mui/material of a note shared by several packages.
@mui/material@5.4.0
Breaking changes
- Breaking
[core] Do not reexport Base from Material
All Base components were exported from the
@mui/materialpackage and treated as stable even though the@mui/basepackage is in development. It could create a lot of confusion if developers start using Base components, depend on them, and demand quality found in "proper" Material components. We admit it was a mistake to reexport these components without marking them as unstable.Developers are still encouraged to evaluate the Base components, but they should do so by explicitly installing the
@mui/basepackage.This is technically a breaking change as it removes a number of components from the
@mui/materialpackage. However, we believe that removing the components now and potentially breaking the codebases will do less harm than introducing "silent" breaking changes to Base components while continuing reexporting them from@mui/material.Note: the utility components, such as ClickAwayListener, NoSsr, Portal, and TextareaAutosize continue to be exported from both
@mui/materialand@mui/base.If you're encountering build errors after upgrading @mui/material, do the following:
Install @mui/base: npm install @mui/base or yarn add @mui/base
Make sure the version of @mui/base match the version of @mui/material
Change the import paths of unstyled components from @mui/material to @mui/base, e.g.:
- @import ButtonUnstyled from '@mui/material/ButtonUnstyled'; + @import ButtonUnstyled from '@mui/base/ButtonUnstyled';
Changes
[Autocomplete] Add
readOnlyprop[FormControlLabel][formgroup] add Mui-error class
[Grid] Fix prop check for applying wrap-reverse
[TextField] Remove notch when no label is added
[TextField] Remove usage of dangerouslySetInnerHTML
[TreeView] Select node when key
Enteris pressed[useMediaQuery] Ensure no tearing in React 18
A whole project to check? Paste its package.json in the dependency check: every deprecated, outdated or vulnerable dependency, with what to upgrade to. Free, no account.