@mui/material
9.5.0 · 9 Oct 2026MIT14.9M / weekRepositoryHomepagenpmAtom feed
215 stable releases, newest first, by release line. Notes are quoted as the maintainers published them.
5.10.17
6 Dec 2022[Slider] Fix
markActivetheme class not getting applied[SwipeableDrawer] Fix missing close animation when initial open is true
[material-ui] Add channel colors if possible
@mui/material@5.10.17[Slider] Fix
markActivetheme class not getting applied[SwipeableDrawer] Fix missing close animation when initial open is true
[material-ui] Add channel colors if possible
[Fab] Increase disabled styles precedence
[Rating] Apply
labelEmptyValueActivestyle overrides from theme
5.10.16
28 Nov 2022[Autocomplete] Fix inferred value type when
multipleprop istrue[Chip] Add
skipFocusWhenDisabledprop to not allow focussing deletable chip if disabled[Chip] Remove unnecessary handleKeyDown event handler
@mui/material@5.10.16[Autocomplete] Fix inferred value type when
multipleprop istrue[Chip] Add
skipFocusWhenDisabledprop to not allow focussing deletable chip if disabled[Chip] Remove unnecessary handleKeyDown event handler
[FormControl] Add missing types in
useFormControl[IconButton] Add missing color classes
[SwipeableDrawer] Make paper ref accessible
5.10.15
22 Nov 2022Fix keyboard navigation when using custom popover
Add
background.defaultChanneltoCssVarsPaletteAdd Urdu (ur-PK) locale
5.10.14
15 Nov 2022Add
palette.background.defaultChanneltokenRemove tags with the Delete key
Custom color causes type error
5.10.13
7 Nov 2022[material-ui] Introduce the slots API
[NativeSelectInput] Support CSS theme variables
5.10.12
31 Oct 2022[Chip] Don't override icon color
[Radio] Skip default hover style when disableRipple is set
[SwipeableDrawer] Fix React 18 issues
@mui/material@5.10.12[Chip] Don't override icon color
[Radio] Skip default hover style when disableRipple is set
[SwipeableDrawer] Fix React 18 issues
[Tooltip] Save a few bytes
5.10.11
25 Oct 2022Fix
onInvalidto use HTMLInputElement | HTMLTextAreaElement Element typeAdd
componentsandcomponentsPropsprops to allow close action overrides
5.10.10
18 Oct 2022Fix paper position flash on open
Make component
defaultPropsoverridable
5.10.9
11 Oct 2022[Grid v2][system] Handle direction object prop for responsive design
[Slider] Fix unnecessary accessibility attribute in root element
5.10.8
3 Oct 2022[Autocomplete] Skip filtering when list of options is loading
[Fab] Add
disabledclass to FAB button[l10n] Add Arabic Saudi Arabia (ar-SA) locale
@mui/material@5.10.8[Autocomplete] Skip filtering when list of options is loading
[Fab] Add
disabledclass to FAB button[l10n] Add Arabic Saudi Arabia (ar-SA) locale
[l10n] zhTW refinement
[Popover] Add
ownerStateon the paper slot[Slider] Fixed incorrect marks displayed due to duplicate keys in range
5.10.7
27 Sep 2022Exclude dark mode variables from
:rootstylesheetAdd chip classes
Fix passing an ownerState to SvgIcon changes the font size
@mui/material@5.10.7Exclude dark mode variables from
:rootstylesheetAdd chip classes
Fix passing an ownerState to SvgIcon changes the font size
Fix optional label is not centered when
alternativeLabelis usedAdd undefined, null or false in
titleMake @emotion/* fully supported in all Material UI components
@mui/material@5.0.0-alpha.101Move @mui/types to dependencies
5.10.6
19 Sep 2022Fix conflict with
Bootstrapeven when label is not defined
5.10.5
12 Sep 2022[ListItemText] Fix variant mapping in
primaryTypography[Timeline] Add left and right aligned timeline demos in docs
5.10.4
6 Sep 2022[Avatar] Use structured / semantic markup for avatars and avatar groups
[Steps] Use structured / semantic markup for steps and steppers
5.10.3
29 Aug 2022- Removed
Remove SliderInput export from d.ts
Fix value overflow when
disableClearableis usedUpdate unstyled demo to not import Material UI
@mui/material@5.10.3Fix value overflow when
disableClearableis usedUpdate unstyled demo to not import Material UI
- Removed
Remove SliderInput export from d.ts
Fix select variant not working
5.10.2
23 Aug 2022[Autocomplete] Fix
keepMountedPopper prop not working[IconButton] Fix hover effect when CSS Variables are enabled
[LoadingButton] Add support for CSS variables
@mui/material@5.10.2[Autocomplete] Fix
keepMountedPopper prop not working[IconButton] Fix hover effect when CSS Variables are enabled
[LoadingButton] Add support for CSS variables
[TimelineConnector] Add support for CSS variables
[TimelineDot] Add support for CSS variables
[TreeItem] Add support for CSS variables
5.10.1
16 Aug 2022[TableCell] Enable variant overrides via TypeScript module augmentation
5.10.0
9 Aug 2022Prevent crash if spacing is set to zero in theme
Export interface
RegularBreakpointsto fix type errorAdd
roundedvariant
@mui/material@5.10.0Prevent crash if spacing is set to zero in theme
Export interface
RegularBreakpointsto fix type errorAdd
roundedvariantFix classes for icon container
Enable size prop overrides via module augmentation
Fix tooltip arrow css var background
Add passive flag to scroll trigger event listener #32437
5.9.3
1 Aug 2022Assign classnames and associated styles for
filledvariantFix
columnSpacingandrowSpacingprops ignore higher breakpoints with 0Add the readOnly state class
@mui/material@5.9.3Assign classnames and associated styles for
filledvariantFix
columnSpacingandrowSpacingprops ignore higher breakpoints with 0Add the readOnly state class
Responsive styles based on breakpoints should be in the correct order
5.9.2
25 Jul 2022Revert "[Tooltip] Fix children mouse over detection (#32321)" @oliviertassinari
[FormHelperText] Fix unable to create new variants
[ImageList] Remove vertical spacing between items in masonry layout
@mui/material@5.9.2Revert "[Tooltip] Fix children mouse over detection (#32321)" @oliviertassinari
[FormHelperText] Fix unable to create new variants
[ImageList] Remove vertical spacing between items in masonry layout
[LoadingButton] Refactor duplicate code
[Modal] Explain the meaning of deprecation of the BackdropComponent prop
[Stack] Fix default
flexDirectionvalue with responsive prop[Stack] Ensure that
marginundefineddoesn't occur in styling[Tabs] Fix
indicatorColorprop type[Tabs] Add TypeScript interface to augment tab indicator color in theme
5.9.1
18 Jul 2022[Autocomplete] Fix disabling component crashing when focused
[Grid] Avoid scrollbar in demo
[Slider] Fix transition of tooltips on vertical slider
@mui/material@5.9.1[Autocomplete] Fix disabling component crashing when focused
[Grid] Avoid scrollbar in demo
[Slider] Fix transition of tooltips on vertical slider
[TouchRipple] Fix crash on android where
event.touchesare an empty array
5.9.0
12 Jul 2022Fixes in overriding style
Remove unnecessary
clsxwrapper for single classNameExport new grid as unstable
@mui/material@5.9.0Fixes in overriding style
Remove unnecessary
clsxwrapper for single classNameExport new grid as unstable
Fix children mouse over detection
getCssVar autocomplete for Material UI
Fix theme options components types to use
ThemeReexports necessary types for module augmentation
Add sx typings
5.8.7
4 Jul 2022Add some missing props in
useAutocompleteExtend
componentsPropsto includepopperandpopupIndicatorslotsAnnotate empty string as valid value prop
@mui/material@5.8.7Add some missing props in
useAutocompleteExtend
componentsPropsto includepopperandpopupIndicatorslotsAnnotate empty string as valid value prop
Fix message text color with css var provider
5.8.6
27 Jun 2022[Alert] Add support for CSS vars
[Alert] Use
getContrastTextfor filled variant font colorNote: The color of the text in the warning contained
Alertin dark mode was changed to black in order to improve the color contrast ratio[OutlinedInput] Fix
ownerStateundefined in theme style overrides
@mui/material@5.8.6[Alert] Add support for CSS vars
[Alert] Use
getContrastTextfor filled variant font colorNote: The color of the text in the warning contained
Alertin dark mode was changed to black in order to improve the color contrast ratio[OutlinedInput] Fix
ownerStateundefined in theme style overrides[Tabs] Fix crash when used with React 18 & Suspense
[TypeScript] Add CSS vars type augmentation for Material UI
5.8.5
21 Jun 2022[Avatar] Add support for CSS variables
[Dialog] Fix broken styles if
maxWidthis set tofalse[SpeedDialAction] Add support for CSS variables
@mui/material@5.8.5[Avatar] Add support for CSS variables
[Dialog] Fix broken styles if
maxWidthis set tofalse[SpeedDialAction] Add support for CSS variables
[Tabs] Increment scroll of the minimum amount possible
5.8.4
14 Jun 2022[Button] Add missing classes in
ButtonClassestype[Grid] Fix prop-type key regression
[Grid] Support custom breakpoints
@mui/material@5.8.4[Button] Add missing classes in
ButtonClassestype[Grid] Fix prop-type key regression
[Grid] Support custom breakpoints
[Grow] Limit CSS transition bug workaround to Safari 15.4 only
[Hidden] Remove dependency on hoist-non-react-statics
[Link] Add support for CSS variables
[Popover] Export
getOffsetTop&getOffsetLeftfrom Popover's index and add typings[Slider] Fix SliderValueLabelProps type
[Snackbar] Remove
RTLdirection specific logic[StepIcon] Fix text centering when changing browser font size
[Tabs] Scroll by width of the first visible tab if only one tab is partially visible
5.8.3
7 Jun 2022Constrain message width and allow overflow
Add support for CSS variables
Fix positioning of tooltips on vertical slider
5.8.2
31 May 2022[core] Improve the incomplete issues workflow
[core] Add CI check that the PR has label
[core] Avoid leaking @babel/runtime
May 31, 2022
A big thanks to the 8 contributors who made this release possible. This release is mostly about 🐛 bug fixes and 📚 documentation improvements.
Core
[core] Improve the incomplete issues workflow
[core] Add CI check that the PR has label
[core] Avoid leaking @babel/runtime
All contributors of this release in alphabetical order: @aaarichter, @hbjORbj, @m4theushw, @michaldudak, @mnajdova, @oliviertassinari, @romelperez, @siriwatknp
5.8.1
23 May 2022[Alert] Fix missing
ownerStateon theactionslot[Fab] Make the
colorprop type extendable[ListItemButton] Render as link if href specified
@mui/material@5.8.1[Alert] Fix missing
ownerStateon theactionslot[Fab] Make the
colorprop type extendable[ListItemButton] Render as link if href specified
[Paper] Add support for CSS variables
[Radio] Add support for CSS variables
[Slider] Prevent rendering for marks that are out of the min & max bounds
[Slider] Slider having marks should be customizable in theme
[TouchRipple] Allows call imperative methods without event
5.8.0
17 May 2022[Autocomplete] Fix
getInputPropsTypeScript return type[Autocomplete] Forward props to renderTags()
[Badge] Fix TypeScript error when adding style overrides for Badge
@mui/material@5.8.0[Autocomplete] Fix
getInputPropsTypeScript return type[Autocomplete] Forward props to renderTags()
[Badge] Fix TypeScript error when adding style overrides for Badge
[Menu] Fix context menu open position
5.7.0
10 May 2022Add support for CSS variables
Add support for CSS variables
Add a logo component for the responsive app bar demo
@mui/material@5.7.0Add support for CSS variables
Add support for CSS variables
Add a logo component for the responsive app bar demo
Fix clearing single array values
Fix keep listbox open on left/right keys when inputValue is not empty
Add support for CSS variables
Render
endAdornmentonly when necessaryAdd support for CSS variables
Add support for CSS variables
Allow pointer up/down events to event handler
Add support for CSS vars
Add support for CSS variables
Add support for CSS variables
Add support for CSS variables
Add support for CSS variables
Add support for CSS variables
Add support for CSS variables
Add support for CSS variables
Add support for CSS variables
Add support for CSS variables
Add support for CSS variables
Support CSS variables
Add support CSS variables
Fix style overrides color prop
Add support for CSS variables
Add support for CSS variables
Add support for CSS variables
Add support for CSS variables
Add support for CSS variables
Add support for CSS vars
Add support for CSS variables
Add support for CSS vars
Add support for CSS variables
Add support for CSS variables
Add support for CSS variables
Export useStepperContext
Add support for CSS variables
Add support for CSS variables
TableSortLabel: Add support for CSS vars
Add support for CSS variables
Add support for CSS variables
Add support for CSS variables
Add support for CSS variables
5.6.4
2 May 2022[Accordion] Add support for CSS variables
[AvatarGroup] Add support for CSS variables
[Badge] Add support for CSS variables
@mui/material@5.6.4[Accordion] Add support for CSS variables
[AvatarGroup] Add support for CSS variables
[Badge] Add support for CSS variables
[BottomNavigation] Add support for CSS variables
[CircularProgress] Add support for CSS variables
[FilledInput] Fix type error from undefined
color[Tabs] Fix
TabIndicatorPropsprop missingsxprop
5.6.3
25 Apr 2022Action icon
paddingfixFix
componentprop is not available inDialogTitlePropsFix TypeScript type of
TransitionComponentprop
5.6.2
18 Apr 2022[Autocomplete] Explain how to use getOptionLabel in free solo mode and update getOptionLabel type
[Badge] Fix customization of classes
[TextField] Add a workaround for Safari CSS transition scale bug
5.6.1
11 Apr 2022Extend Safari CSS transition bug workaround on WebKit browsers
Fix style overrides 5.6.0 regression
Bug when the first child is a ListSubheader
5.6.0
6 Apr 2022[CssVarsProvider] Add experimental CssVarsProvider in @mui/material
[Link] Fix
sxcolor to support callback[Link] Fix color transformation
@mui/material@5.6.0[CssVarsProvider] Add experimental CssVarsProvider in @mui/material
[Link] Fix
sxcolor to support callback[Link] Fix color transformation
[ListItemButton] Specified width so that text would ellide
[TablePagination] Fixed the etEE locale
5.5.3
28 Mar 2022[ButtonBase] Start ripple only after mount
[FormControlLabel] Fix label prop type to be in-line with other label prop types
[Grow] Add a workaround for Safari 15.4 CSS transition bug
5.5.2
21 Mar 2022[Popper] Expose the
sxprop
5.5.1
14 Mar 2022Add z-index
Fix columns of nested container
Update italian locale
@mui/material@5.5.1
Add z-index
Fix columns of nested container
Update italian locale
Fix type of UsePaginationItem["page"]
Allow setting default props in a theme
Fix disappearing border in Safari
5.5.0
7 Mar 2022- Breaking
[ClassNameGenerator] Prevent all
baseimportsunstable_ClassNameGeneratorhas been moved fromutilstoclassNamefolder to prevent all MUI Base module imports. If you use the module, please update the import as suggested in the diff below:- import { unstable_ClassNameGenerator } from '@mui/material/utils'; + import { unstable_ClassNameGenerator } from '@mui/material/className'; [Autocomplete] Have the screen reader announce when autocomplete is open and closed
[AvatarGroup] Fix misalignment with non-default spacing
@mui/material@5.5.0Breaking change
- Breaking
[ClassNameGenerator] Prevent all
baseimportsunstable_ClassNameGeneratorhas been moved fromutilstoclassNamefolder to prevent all MUI Base module imports. If you use the module, please update the import as suggested in the diff below:- import { unstable_ClassNameGenerator } from '@mui/material/utils'; + import { unstable_ClassNameGenerator } from '@mui/material/className';
Changes
[Autocomplete] Have the screen reader announce when autocomplete is open and closed
[AvatarGroup] Fix misalignment with non-default spacing
[Drawer] Adjustments to the mini variant to improve UI/UX
[Select] Add extending
OutlinedInputPropsby SelectProps
5.4.4
28 Feb 2022[Autocomplete] Have Autocomplete with multiline textfield log a warning instead of an error
[Chip] Fix ellipsis when the children is too long
[Input] Export InputBase's classes from the classes const
@mui/material@5.4.4[Autocomplete] Have Autocomplete with multiline textfield log a warning instead of an error
[Chip] Fix ellipsis when the children is too long
[Input] Export InputBase's classes from the classes const
[TextField] Fix Horizontal scroll when label too long
[styles] Fix typo in import error
5.4.3
21 Feb 2022[Stepper] Export useStepContext
[Transitions] Some components do not use transition duration/easing values from theme
@mui/material@5.4.3[Stepper] Export useStepContext
[Transitions] Some components do not use transition duration/easing values from theme
5.4.2
15 Feb 2022Allow customizing Select based on its variant
Re-export 'Portal' in material
Add prop types for
onClickandonChange
@mui/material@5.4.2Allow customizing Select based on its variant
Re-export 'Portal' in material
Add prop types for
onClickandonChangeAdded TypeText declaration to the exports file
5.4.1
8 Feb 2022[AvatarGroup] Enable targeting of additional Avatar when max props is passed
[Badge] Fix showzero and invisible condition
[ButtonBase] Expose ref to TouchRipple
@mui/material@5.4.1[AvatarGroup] Enable targeting of additional Avatar when max props is passed
[Badge] Fix showzero and invisible condition
[ButtonBase] Expose ref to TouchRipple
[Fab] Add support for the default theme colors
[SelectInput] Only attach click handler to label if a labelId is passed
[Snackbar] Ensure messages are announced in NVDA+FF
5.4.0
1 Feb 2022- 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:
- @import ButtonUnstyled from '@mui/material/ButtonUnstyled'; + @import ButtonUnstyled from '@mui/base/ButtonUnstyled';
[Autocomplete] Add
readOnlyprop[FormControlLabel][formgroup] add Mui-error class
@mui/material@5.4.0Breaking 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
5.3.1
24 Jan 2022🛠 @mnajdova added interoperability guide for using Tailwind CSS
A meaningful number of 🐛 bug fixes and 📚 documentation improvements.
[core] Batch small changes
Jan 24, 2022
A big thanks to the 12 contributors who made this release possible. Here are some highlights ✨:
🛠 @mnajdova added interoperability guide for using Tailwind CSS
A meaningful number of 🐛 bug fixes and 📚 documentation improvements.
Core
[core] Batch small changes
[core] Add new structure to ignore list crowdin
[core] Correct version in package.json
[test] Fix buildApiUtils tests on Windows
Docs
All contributors of this release in alphabetical order: @aaneitchik, @alexfauquette, @chaosmirage, @ddecrulle, @Evomatic, @exequielbc, @michaldudak, @mnajdova, @MrHBS, @NoahYarian, @oliviertassinari, @siriwatknp
5.3.0
17 Jan 2022Add ability to pass props to
PapercomponentAdd defaultOpen prop
5.2.8
10 Jan 2022[TextField][inputlabel] Remove
pointer-events: noneproperty[Slider] Add
inputslot to components and componentsProps
5.2.7
3 Jan 2022[Autocomplete] Fix calling onChange for duplicate values
[Avatar] Fix TypeScript error on imgProps
[Badge] Fix
classesprop TypeScript type
@mui/material@5.2.7[Autocomplete] Fix calling onChange for duplicate values
[Avatar] Fix TypeScript error on imgProps
[Badge] Fix
classesprop TypeScript type[SvgIcon] Allow viewBox to inherit from Component through inheritViewBox prop
[SvgIcon] Correct API docs and code style
5.2.6
27 Dec 2021[l10n] Add Norwegian Bokmål (nb-NO) locale
@mui/material@5.2.6[l10n] Add Norwegian Bokmål (nb-NO) locale
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.