@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.
- 9.x · latest line
9.5.0
9 Oct 2026Add missing override interfaces for
slotPropsExport private focus-visible utilities
Fix
onClosetypes for Menu, Snackbar, and SwipeableDrawer
@mui/material@9.5.0Add missing override interfaces for
slotPropsExport private focus-visible utilities
Fix
onClosetypes for Menu, Snackbar, and SwipeableDrawerFix slot handling in Autocomplete chips, TextField
inputLabel, and NativeSelectinputFix theme
defaultPropsand missing exportsRemove unnecessary
OmittypesLazily derive the initial input value
Prevent crash when changing
groupByStop filtering once the result limit is reached
Support values other than raw options
Improve TypeScript performance when using
slotPropsDocument the
selectedpropBuild separators in one pass
Fix loading-position style leaking to non-loading buttons
Simplify
ExtendButtontypeFix LazyRipple retaining event objects when ripples are disabled
Set the native indeterminate state on the input
Render the
theme.focusVisiblering on the scrollable contentFix
slotProps.inputevent handlers and ref being ignoredRemove unwanted
OmittypeRevert to
color-mixwhen underline color is not acceptedPrevent
aria-hiddenfrom being applied to non-portal modalsFix flaky opening mouseup timing
Fix the background fallback with CSS theme variables
Fix
disableSwapwhen a neighboring thumb is at 0Remove unnecessary
Omitin props definitionsFix horizontal persistent tooltip placement
Support action slot object refs
Improve accessibility for the pagination buttons
Align common types with other components
Derive mounted state from the indicator style instead of setting it in an effect
Fix selected tab not scrolling into view when scroll buttons appear in auto mode
Respect
scroll-paddingwhen scrolling the selected tab into viewAdd theme CSS variable for autofill
box-shadowFix
theme.alpha()for raw colors with CSS variablesFix theming outliers in Paper, BreadcrumbCollapsed, TablePagination, and Tooltip
Keep CSS variable fallbacks in
theme.alpha()
9.4.0
27 Aug 2026Add
theme.focusVisibleopt-in keyboard focus ringPrevent sticky hover border on touch devices
Complete Traditional Chinese localization
@mui/material@9.4.0Add
theme.focusVisibleopt-in keyboard focus ringPrevent sticky hover border on touch devices
Complete Traditional Chinese localization
Preserve custom list padding when adjusting for the scrollbar
Manage focus whenever first / last / next / previous buttons become disabled
Improve support for disabled button triggers
9.3.1
6 Aug 2026Prevent exit transitions from getting stuck
9.3.0
5 Aug 2026Wrap the no results and loading messages in an aria live region
Respect global disableRipple / disableFocusRipple in grouped buttons
Respect global disableRipple from MuiButtonBase defaultProps
@mui/material@9.3.0Wrap the no results and loading messages in an aria live region
Respect global disableRipple / disableFocusRipple in grouped buttons
Respect global disableRipple from MuiButtonBase defaultProps
Add missing
labelPlacementEndclassAdd
aria-checkedfor checkbox and radio menu itemsReplace custom findIndexOf with findIndex
Fix scrollbar compensation in Shadow DOM
Fix endAdornment overlapping the open indicator
Add focus style to default InputBase used in Select
Add roving tabindex keyboard navigation
9.2.0
3 Jul 2026Add missing MuiPagination localization to zh-CN locale
Guard display ref during mouse down
9.1.2
23 Jun 2026Don't submit forms when committing
freeSolovalue with Enter keyFix RTG import in ESM
9.1.1
11 Jun 2026Update fullWidth prop documentation
Fix focus ripple lingering after blur
Server-render in tests for React 19.3
@mui/material@9.1.1Update fullWidth prop documentation
Fix focus ripple lingering after blur
Server-render in tests for React 19.3
Mount child in same commit when opening from unmounted
9.1.0
8 Jun 2026Enable clearing highlight when mouse leaves popup
Fix
freeSolocontrolled values cleared by initialnullFix item removal when it receives focus from VoiceOver before using Backspace
@mui/material@9.1.0Enable clearing highlight when mouse leaves popup
Fix
freeSolocontrolled values cleared by initialnullFix item removal when it receives focus from VoiceOver before using Backspace
Fix
resetHighlightOnMouseLeaveJSdocGuard against null inputRef during unmount
Add
aria-hiddento badge content and polish docs demosUse inline CSS variables for anchorOrigin/overlap positioning
Fix customized flex gap styles
Fix unwanted
DialogPaperfocus ringFix incorrect tab order when
tabIndex >= 1Show runtime errors only once
Allow spacebar to select elements
Support typeahead when closed
Choose higher contrast ripple color for dark mode focus
Include StepConnector inside Step element
Proper support for vertical alternativeLabel
Fix React 18 roving tabindex and dedupe invalid-value warning
Add HighContrast theme enhancer
Fix extra ::before spacing when TimelineOppositeContent is present
Prevent stuck-open tooltip when child becomes disabled
Custom
TransitioncomponentSupport
prefers-reduced-motion
9.0.1
7 May 2026- Removed
Remove IE 11-specific focus safety check from FocusTrap cleanup
HighContrast mode on Avatar, Badge, Slider and Switch
Fix highlight sync and scroll preservation
@mui/material@9.0.1HighContrast mode on Avatar, Badge, Slider and Switch
Fix highlight sync and scroll preservation
Fix input value and clear
Fix iOS group scrollbar overflow
Fix popper rendering issues
Improve highlight tracking and selection state
Fix
startIconalignmentDocument
typeattributeRemove duplicated className entries
Set
aria-checked=mixedwhen indeterminateImprove accessibility
Fix initial focus target
Fix swipe close flicker
Fix transition jump
- Removed
Remove IE 11-specific focus safety check from FocusTrap cleanup
Add internal
useFormControlStatehookRemove unused color palette mapping in styles
Revert to using wildcard export paths
Fix layout shift with display: flex
Prevent
notchedprop leaking into DOMPlace aria-label on the input element
Fix autofocus in SSR environment
Fix sticky subheader overlapping iOS scrollbar
Persist positioning styles when popperOptions changes reference
Stop using combobox element for labeling
Support single-pointer-cycle selection and pointer cancellation
Fix incorrect
rolewithslotProps.inputFix scrollable tabs blocking pointer events
Fix autofill styles always in dark mode when CSS variables is used
Simplify RTL styles using CSS logical properties
Close Tooltip when its child becomes disabled
Fix
h4variant when usingresponsiveFontSizes()Fix crash in Firefox extension
9.0.0
7 Apr 2026Use pointer events instead of mouse events
Add border to make it visible in high contrast mode
Performance improvements & misc fixes
@mui/material@9.0.0Use pointer events instead of mouse events
Add border to make it visible in high contrast mode
Performance improvements & misc fixes
Remove unnecessary overridesResolvers from styled components
- 7.x
7.3.11
7 May 2026Fix highlight sync and scroll preservation
Fix popper rendering issues
Improve highlight tracking and selection state
@mui/material@7.3.11Fix highlight sync and scroll preservation
Fix popper rendering issues
Improve highlight tracking and selection state
Fix
startIconalignmentRemove duplicated className entries
Set
aria-checked=mixedwhen indeterminateFix initial focus target
Fix transition jump
Fix layout shift with display: flex
Fix autofocus in SSR environment
Persist positioning styles when popperOptions changes reference
Fix incorrect
rolewithslotProps.inputAdd shadow dom utils
7.3.10
8 Apr 2026Accessibility improvements
Add
rootslotFix helper text focusing input when clicked
@mui/material@7.3.10Accessibility improvements
Add
rootslotFix helper text focusing input when clicked
Fix popup reopening on window focus regain with openOnFocus
Optimize selected option lookup
Support full slots for clearIndicator and popupIndicator
Fix native button detection
Fix high contrast cutoff on first character
Revert cleanup of duplicated CSS rules
Add missing classes export
Fix focus visible always set on menu item
Accept readonly array for the value prop
Add border to make it visible in high contrast mode
Do not create channel tokens for custom colors when
nativeColoris usedPerformance improvements & misc fixes
7.3.9
5 Mar 2026Clean up duplicated CSS rules
Generate
color-mixvalue on top of default generated Material UI CSS variablesFix error is thrown when wrapping an input which is disabled while focused
@mui/material@7.3.9Clean up duplicated CSS rules
Generate
color-mixvalue on top of default generated Material UI CSS variablesFix error is thrown when wrapping an input which is disabled while focused
Apply
alphabefore color mixing to border bottom color when nativeColor + cssVariables is used
7.3.8
12 Feb 2026Revert removing default icon mapping fallback
Fix optional chaining in joinVars function
Fix scroll position resetting on reopen with
disableCloseOnSelect
@mui/material@7.3.8Revert removing default icon mapping fallback
Fix optional chaining in joinVars function
Fix scroll position resetting on reopen with
disableCloseOnSelectPass fullWidth prop to input, with default as true
Refactor variant styles generation
Remove unnecessary
onDeletecheckRemove
aria-disabledfrom root spanRemove unnecessary string concatenation
persistentandpermanentvariant Drawers should not override the styles via theme usingmodalclassAdd ability to extend Tabs variant
Add aria-multiselectable to listbox props when multiple is true
Use
React.Keyinstead ofanyforkeyprop
Core
Revert "[docs-infra] Add Cookie Banner and Analytics Provider (#47445)"
Revert "[docs-infra] Update Cookie Consent Dialog styling and content (#47718)"
Validate slots prop and Slots interface export consistency
Remove
window.muiDocConfigFix flaky Select test on Webkit
Remove usage of NODE_ENV=test
Prepare eslint rule rename
Next.js 15.5.11 (security update)
Fix Tooltip tests flakyness
Improve instructions for error messages
Add initial agent instructions
Update broken links checker
Improve Tooltip leaveDelay test
Fix internal broken links
Resolve a few 301s in our docs
Update Cookie Consent Dialog styling and content
Add Cookie Banner and Analytics Provider
Make sure /customers page has a h1
Fix privacy link
Resolve a few 301s
Remove unused sponsor files
Fix some broken hash links
7.3.7
8 Jan 2026- Removed
Remove incorrect root ref being forwarded to focus highlight component
Remove unnecessary handling of
squareprop on Accordion RootRemove unnecessary default icon mapping fallback
@mui/material@7.3.7Remove unnecessary handling of
squareprop on Accordion RootRemove unnecessary default icon mapping fallback
Fix inherit color CSS variable not getting applied
Fix
ArrowLeft,Backspace&Deletebehavior for multiple and single-value rendering with proper caret handlingRemove unnecessary passing of
classesfrom root slotFix styles when variant is
contained- Removed
Remove incorrect root ref being forwarded to focus highlight component
Fix readonly checkboxes
Tighten the parameter type of createHandleSynthetic method
Fix backdrop theme style overrides
Compute
activeElementinsideloopFocuson every keydownTake non-integer padding-right into consideration when scroll locking
Fix dropdown width does not match trigger width on window resize
Fix passing incorrect slot name props (scrollButton → scrollButtons)
7.3.6
3 Dec 2025Move properties to the AccordionOwnProps interface
Remove unnecessary
filterSelectedOptionsdependency fromsyncHighlightedIndexuseCallbackFix input caret not showing when focusing after chip navigation
@mui/material@7.3.6
Move properties to the AccordionOwnProps interface
Remove unnecessary
filterSelectedOptionsdependency fromsyncHighlightedIndexuseCallbackFix input caret not showing when focusing after chip navigation
Fix ArrowLeft crash when value is not set with single-value rendering
Fix running formAction when passed
Remove leftover closing parenthesis in CSS class key
Add
secondaryActionslot toListItemFix scroll behavior
Fix keyboard navigation while rendering in shadow DOM
Fix cannot pass certain event handlers
Accept readonly array for
markspropAvoid unnecessary
ownerStatespread intouseSnackbarAllow custom props in slot props via TS module augmentation
Fix Arrow key navigation failing when component is rendered in shadow DOM
Fix typings for theme
applyStyleswith custom color schemes
7.3.5
4 Nov 2025Add slots and slotProps props
Add missing Catalan (ca-ES) locale
Fix regression on
theme.vars.shapemodule augmentation
7.3.3
1 Oct 2025Sync highlighted index when popup is opened
Add track slot via enableTrackSlot
Split locales into separate files
@mui/material@7.3.3Sync highlighted index when popup is opened
Add track slot via enableTrackSlot
Split locales into separate files
Fix not scrolling to correct tab after refresh when auto scrollable
7.3.2
2 Sep 2025Remove unnecessary optional chaining from key event handlers
Add dialog role and aria-modal for
temporaryvariantAdd slot descriptions and default components in API documentation
@mui/material@7.3.2Remove unnecessary optional chaining from key event handlers
Add dialog role and aria-modal for
temporaryvariantAdd slot descriptions and default components in API documentation
Remove duplicate isHostComponent function
7.3.1
6 Aug 2025Fix inheritance of component
Revert - Implement pointer cancellation PR 45789
@mui/material@7.3.1Fix inheritance of component
Revert - Implement pointer cancellation PR 45789
All contributors of this release in alphabetical order: @sai6855, @ZeeshanTamboli
7.3.0
5 Aug 2025Support native color without JS manipulation
Add
regionslotFix navigation with arrow keys when slotProps.fab is defined
@mui/material@7.3.0Support native color without JS manipulation
Add
regionslotFix navigation with arrow keys when slotProps.fab is defined
Improve
MenuProps.slotPropsimplementationImplement pointer cancellation
Add role="switch"
Fix auto highlight when options change but not the length
7.2.0
30 Jun 2025- Deprecated
Deprecate composed classes
Fix handling of
componentpropExplicitly define line-height
@mui/material@7.2.0Fix handling of
componentpropExplicitly define line-height
Fix handling on event handlers
- Deprecated
Deprecate composed classes
Pass MenuProps.slotProps.list alongside MenuListProps
Enable
labelDisplayedRowstranslation for RomanianSkip generating
modularCssLayersCSS var
7.1.2
19 Jun 2025Fix handling on event handlers
7.1.1
2 Jun 2025Fix label shrink issue when
renderValueis used with empty array in multiple modePrevent
renderValuefrom being skipped when value is 0Add note in JSDoc for non-TextField components in
renderInput
@mui/material@7.1.1Fix label shrink issue when
renderValueis used with empty array in multiple modePrevent
renderValuefrom being skipped when value is 0Add note in JSDoc for non-TextField components in
renderInputAdd slots and slotProps
Remove depreacted
MenuListPropsfrom demosExport TablePaginationActions as new component
Fix
squareprop not workingFix error when theme value is CSS variable
7.1.0
6 May 2025Text cursor jumps several lines up when inserting text fragment with new line at the end
Add missing
notchedOutlineslotSkip default
onClickAwaybehavior whendefaultMuiPreventedis provided
@mui/material@7.1.0Text cursor jumps several lines up when inserting text fragment with new line at the end
Add missing
notchedOutlineslotSkip default
onClickAwaybehavior whendefaultMuiPreventedis providedFix img slot types and add missing slots
Replace useSlotProps with useSlot hook
Add slots and slotProps
Add slots and slotProps
Add warning and docs for using
useMediaQuery('print')Remove unnecessary clsx usages
Corrected generic type definition in
SelectChangeEventFix theme object changes between renders
7.0.2
9 Apr 2025- Deprecated
Deprecate composed classes
Add ability to render custom single value
Prevent shrink animation in controlled Autocomplete when initial
valueis provided
@mui/material@7.0.2Add ability to render custom single value
Prevent shrink animation in controlled Autocomplete when initial
valueis providedFix
spacingprop ignoring value0- Deprecated
Deprecate composed classes
7.0.1
28 Mar 2025Export ThemeProviderProps
Fix default variant text color when using CSS vars
Remove mention of v7 in deprecation messages
@mui/material@7.0.1Export ThemeProviderProps
Fix default variant text color when using CSS vars
Remove mention of v7 in deprecation messages
Allow
nullinanchorElfunction return typeFix missing CSSProperties/MixinOptions types
7.0.0
26 Mar 2025- Breaking
Update minimum TypeScript support to 4.9
Fix when
onHighlightChangeis calledFix modifier keys + Left/Right Arrow key from being consumed by tab navigation
- 6.x
6.5.0
8 Jul 2025Add codemod for deprecated props
6.4.12
2 Jun 2025Replace useSlotProps with useSlot hook
Add slots and slotProps
Add slots and slotProps
@mui/material@6.4.12Replace useSlotProps with useSlot hook
Add slots and slotProps
Add slots and slotProps
Add missing
notchedOutlineslotAdd warning and docs for using
useMediaQuery('print')Fix theme object changes between renders
6.4.11
9 Apr 2025- Deprecated
Deprecate composed classes
Fix
spacingprop ignoring value0
6.4.10
31 Mar 2025Prevent shrink animation in controlled Autocomplete when initial
valueis providedAllow
nullinanchorElfunction return type
6.4.9
25 Mar 2025Fix when
onHighlightChangeis calledAdd missing root slot
Add slots and slotProps
@mui/material@6.4.9Fix when
onHighlightChangeis calledAdd missing root slot
Add slots and slotProps
Add
rootslotFix modifier keys + Left/Right Arrow key from being consumed by tab navigation
6.4.8
17 Mar 2025Add missing
rootslotAdd missing
rootslotAllow auto placement on tooltip
@mui/material@6.4.8Add missing
rootslotAdd missing
rootslotAllow auto placement on tooltip
Do nothing if target is null
Add missing
rootslotAdd slots and slotProps
Fix ResizeObserver causing infinite
selectionchangeloop
6.4.7
5 Mar 2025- Deprecated
Deprecate *Props and complete slots, slotProps
Add
storageManagerprop toThemeProviderFix
inputPropsnot forwarded (@siriwatknp) (#4547
6.4.6
26 Feb 2025- Deprecated
Deprecate *Props and complete
slots,slotProps - Deprecated
Deprecate composed classes
- Deprecated
Deprecate *Props and complete
slots,slotProps
@mui/material@6.4.6Add slots and slotProps
- Deprecated
Deprecate *Props and complete
slots,slotProps Improve Grid2 upgrade experience
- Deprecated
Deprecate composed classes
Fix
slotProps.transitiontypesAllow nested theme creation with
varsFix wrong slotProps of DetailsHTMLAttributes types
- Deprecated
Deprecate *Props and complete
slots,slotProps Add slots and slotProps
Fix css class selector in migration guide
Fix spacings in .md files
Add Slots and SlotProps
Add slots and slotProps
- Deprecated
Deprecate
inputPropsand complete slots, slotProps - Deprecated
Deprecate *Props and complete slots, slotProps
- Deprecated
Deprecate *Props and complete
slots,slotProps
6.4.5
18 Feb 2025- Removed
Remove legacy
aria-ownsattribute for combobox Apply id only if loading indicator is present
6.4.4
11 Feb 2025- Deprecated
Deprecate
LinearProgressPropsand completeslots,slotProps - Deprecated
Deprecate composed classes
Merge
sxinstead of override when usingmergeSlotProps
6.4.3
4 Feb 2025- Removed
Remove deprecated props from documentation
Add variant overrides for module augmentation
6.4.2
29 Jan 2025Prevent shrink animation in uncontrolled Autocomplete when default value is set
Fix arrow keys past the end for Slider with custom marks
Temporarily disconnect ResizeObserver to avoid loop error
6.4.1
21 Jan 2025- Deprecated
Deprecate composed classes
Export types used in ButtonBase props
Add slots and slotProps
@mui/material@6.4.1Export types used in ButtonBase props
Add slots and slotProps
- Deprecated
Deprecate composed classes
Set default loading to
nullAdd codemod for deprecated props
Add migration guide and codemod for deprecated props
Fix filled state to be synced with autofill
6.4.0
14 Jan 2025- Deprecated
Deprecate
*TypographyPropsand completeslots,slotProps - Deprecated
Deprecate composed classes
Complete
slotsandslotProps
@mui/material@6.4.0Complete
slotsandslotPropsSync runtime and TS types for key in grouped options
Add
loadingprop- Deprecated
Deprecate
*TypographyPropsand completeslots,slotProps Improve indeterminate animation to be symmetric and smooth
- Deprecated
Deprecate composed classes
Fix error for using custom palette with underline
Do not set
aria-controlswhen closedAdd missing root class
Set onChangeCommitted to receive the last argument passed to onChange
Add
mergeSlotPropsfor extending componentsUpdate
mergeSlotPropsto mergestyleFix slots typing for Tooltip and StepLabel
Remove unnecessary blank lines
6.3.1
3 Jan 2025- Deprecated
Deprecate composed classes
Fix options list rendering in freeSolo mode
Warn instead of error when trigger is disabled
@mui/material@6.3.1Fix options list rendering in freeSolo mode
Warn instead of error when trigger is disabled
Add slots and slotProps
- Deprecated
Deprecate composed classes
6.3.0
23 Dec 2024Fix invalid HTML inside heading
Improve TS typing of
groupedOptionspropPrevent
ownerStatepropagation for transition slots
@mui/material@6.3.0Fix invalid HTML inside heading
Improve TS typing of
groupedOptionspropPrevent
ownerStatepropagation for transition slotsAdd slots and slotProps
Add the rest of
slotsandslotProps.
6.2.1
17 Dec 2024Update
overridesResolverreturn from object to array of stylesUse correct
aria-currentvalueSet
aria-required&aria-invalidoncomboboxinstead of hidden input
6.2.0
11 Dec 2024Add missing
componenttoBoxPropstypeFix spacing when using css variables
Add
slotsandslotProps
6.1.10
4 Dec 2024Fix
slotProps.imgnot spread to hookUse
slotPropsinstead ofcomponentsPropsFix theme scoping error
@mui/material@6.1.10Fix
slotProps.imgnot spread to hookUse
slotPropsinstead ofcomponentsPropsFix theme scoping error
Add container styles from styleOverrides
Skip
tonalOffsetfrom setting color channelRemove few more React.ReactElement<any> types
Fix
ScrollbarSizeref being overridenFix screen reader from saying
&ZeroWidthSpace
6.1.9
27 Nov 2024Omit
placeholderfrom propsAdd container class to
Grid2Classes
6.1.8
20 Nov 2024- Breaking
Add generic back to
useMediaQueryto prevent a breaking change - Deprecated
Deprecate
*Componentand*Propsfor v6 Use
ulelement for the listbox
@mui/material@6.1.8Use
ulelement for the listboxRemove item and zeroMinWidth classes from grid2Classes
Add SvgIconOwnProps type to StepIcon props
- Breaking
Add generic back to
useMediaQueryto prevent a breaking change - Deprecated
Deprecate
*Componentand*Propsfor v6
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.