Packages

@mui/material

9.5.0 · 9 Oct 2026MIT14.9M / weekRepositoryHomepagenpmAtom feed

Your version

5.4.0

1 Feb 2022Where it was published

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/material package and treated as stable even though the @mui/base package 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/base package.

    This is technically a breaking change as it removes a number of components from the @mui/material package. 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/material and @mui/base.

    If you're encountering build errors after upgrading @mui/material, do the following:

    1. Install @mui/base: npm install @mui/base or yarn add @mui/base

    2. Make sure the version of @mui/base match the version of @mui/material

    3. 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 readOnly prop

  • ​[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 Enter is 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.