NewYour coding agent can read the release notes before it upgrades.Set up the MCP server →
npm · #3421 most downloaded on npm
Material Design icons distributed as SVG React components.
Last release 1 months ago
27 Aug 2026
Ships fairly regularly
a new release about every 3 weeks
Nearly every release is documented
notes for 59 of the last 60 stable releases
Nothing withdrawn
no release was ever pulled
5 years old
194 releases · first in 2021
One column per quarter.
A big thanks to the 15 contributors who made this release possible. Here are some highlights ✨:
Jan 17, 2022
A big thanks to the 15 contributors who made this release possible. Here are some highlights ✨:
@mui/material@5.3.0Paper component (#30515) @ZeeshanTamboli@mui/system@5.3.0textTransform prop should work directly on component (#30437) @hbjORbjstyleOverrides slot (#30524) @siriwatknp@mui/lab@5.0.0-alpha.65@mui/codemod@5.3.0jscodeshift to remove colors dependency (#30578) @siriwatknp@mui/styled-engine-sc@5.3.0@mui/joy@5.0.0-alpha.11SvgIcon component (#30570) @hbjORbj@mui/base@5.0.0-alpha.65</p> from header of README.md (#30530) @yaboidocs:api script for Windows OS (#30533) @ZeeshanTamboliAll contributors of this release in alphabetical order: @alexfauquette, @alisasanib, @Atralbus, @cherniavskii, @danilo-leal, @eps1lon, @garronej, @glaucoheitor, @hbjORbj, @kkirsche, @mnajdova, @oliviertassinari, @siriwatknp, @VicHofs, @yaboi, @ZeeshanTamboli
A big thanks to the 16 contributors who made this release possible. Here are some highlights ✨:
Dec 20, 2021
A big thanks to the 16 contributors who made this release possible. Here are some highlights ✨:
@mui/material@5.2.5Partial<> type around TabIndicatorProps type (#30254) @ZeeshanTamboli@mui/system@5.2.5useEnhancedEffect to prevent flicker (#30216) @hbjORbj@mui/lab@5.0.0-alpha.61anchorOrigin prop (#30147) @daniel-sachsAll contributors of this release in alphabetical order: @daniel-sachs, @danilo-leal, @eps1lon, @hbjORbj, @jamesmelzer, @Janpot, @KThompso, @lemol, @michaldudak, @mikk5829, @mnajdova, @oliviertassinari, @rejetto, @ShuPink, @siriwatknp, @ZeeshanTamboli
A big thanks to the 16 contributors who made this release possible. Here are some highlights ✨:
Dec 14, 2021
A big thanks to the 16 contributors who made this release possible. Here are some highlights ✨:
✨ Add not operator to theme.breakpoints (#29311) @Philipp000
const styles = (theme) => ({
root: {
backgroundColor: 'blue',
// Match [xs, md) and [md + 1, ∞)
// [xs, md) and [lg, ∞)
// [0px, 900px) and [1200px, ∞)
[theme.breakpoints.not('md')]: {
backgroundColor: 'red',
},
},
});
And many more 🐛 bug fixes and 📚 improvements.
@mui/material@5.2.4theme type (#30072) @mnajdovaOutlinedInput's label (#29630) @alisasanibThemeOptions (#30095) @fmeum@mui/system@5.2.4not operator to breakpoints (#29311) @Philipp000@mui/base@5.0.0-alpha.60@mui/icons-material@5.2.4All contributors of this release in alphabetical order: @alisasanib, @bryan-hunter, @danilo-leal, @eps1lon, @fmeum, @Janpot, @kkorach, @l10nbot, @ladygo93, @michaldudak, @mnajdova, @oliviertassinari, @Philipp000, @rvsia, @TheodosiouTh, @yaboi
<!-- generated comparing v5.2.0..master -->
<!-- generated comparing v5.2.0..master -->
Nov 25, 2021
A big thanks to the 7 contributors who made this release possible. Here are some highlights ✨:
This is an early release to fix export 'useId' (imported as 'React') was not found in 'react' when bundling code depending on MUI Core.
experimental_sx utility (#29833) @mnajdovaAll contributors of this release in alphabetical order: @eps1lon, @karakib2k18, @kegi, @mbrookes, @mnajdova, @newguy-123, @oliviertassinari
[CHANGELOG] Explain why we do breaking changes @oliviertassinari
Nov 23, 2021
A big thanks to the 18 contributors who made this release possible. Here are some highlights ✨:
@mui/material@5.2.0disableRipple is set (#29298) @adamfitzgibbonvariants.style to accept callbacks (#29610) @mnajdova@mui/codemod@5.2.0jss-to-styled to support multiple withStyles (#29824) @siriwatknp@mui/icons-material@5.2.0@mui/system@5.2.0sx prop runtime issue when used as function (#29830) @mnajdovasx throw error when value is null or undefined (#29756) @siriwatknp@mui/styled-engine@5.2.0@mui/base@5.0.0-alpha.56focused is always false unless explicitly set to true @mwilkins91@mui/lab@5.0.0-alpha.56luxon version range (#29761) @eps1lon@mui/core is an alias for @mui/base (#29762) @eps1lonnext branch (#29748) @eps1loncreateRenderer (#29684) @eps1lonAll contributors of this release in alphabetical order: @abhinav-22-tech, @adamfitzgibbon, @bharatkashyap, @chao813, @DanailH, @danilo-leal, @eps1lon, @gnowland, @Janpot, @longzheng, @michaldudak, @mmacu, @mnajdova, @mwilkins91, @NatiG100, @oliviertassinari, @scallaway, @siriwatknp
<!-- generated comparing v5.1.0..master -->
<!-- generated comparing v5.1.0..master -->
Nov 16, 2021
A big thanks to the 15 contributors who made this release possible. Here are some highlights ✨:
@mui/core to @mui/base (#29585) @michaldudak.@mui/material@5.1.1multiple class (#29566) @aaronhollaSelect is not a root component (#29593) @hbjORbj@mui/base@5.0.0-alpha.55<!-- 27 -->[core] Rename mui/core to mui/base (#29585) @michaldudak
Based on the results of the poll and our internal discussions, we decided to rename the @mui/core package to @mui/base. The main rationale for this is the fact that we use the term "Core" to refer to the core components product family, the one that includes Material Design components, unstyled components, System utilities, etc. Therefore, @mui/core was effectively a subset of MUI Core. This was confusing.
The new name better reflects the purpose of the package: it contains unstyled components, hooks, and utilities that serve as a base to build on.
-import { useSwitch } from '@mui/core/SwitchUnstyled';
+import { useSwitch } from '@mui/base/SwitchUnstyled';
@mui/lab@5.0.0-alpha.55ThemeProvider API link (#29573) @siriwatknpexperiments index page (#29582) @siriwatknpgetJsxPreview util (#29586) @ZeeshanTamboliraf helper is for (#29683) @eps1loncreateServerRender with createRenderer (#29503) @eps1lonAll contributors of this release in alphabetical order: @aaronholla, @alexfauquette, @anikcreative, @daniel-sachs, @eps1lon, @flipvrijn, @hbjORbj, @joshua-lawrence, @michaldudak, @mnajdova, @netizer, @oliviertassinari, @petermikitsh, @siriwatknp, @ZeeshanTamboli
A big thanks to the 33 contributors who made this release possible. Here are some highlights ✨:
Nov 8, 2021
A big thanks to the 33 contributors who made this release possible. Here are some highlights ✨:
ButtonGroup (#28645) @ZeeshanTambolisx prop (#29297) @siriwatknp@mui/material@5.1.0hiddenLabel prop of TextField variant={filled} inside Autocomplete (#29234) @jatinsandilyaenableColorScheme prop so enable using color-scheme property to deal with dark mode (#29454) @alexfauquetteopen prop in componentsProps.popper can be optional (#29370) @ZeeshanTamboliclassName not getting applied from PopperProps (#29023) @ZeeshanTamboli@mui/system@5.1.0mode to CssVarsProvider (#29418) @siriwatknpsx prop (#29297) @siriwatknp@mui/codemod@5.1.0@mui/lab@5.0.0-alpha.54children (#29351) @hbjORbj@mui/joy@5.0.0-alpha.0private to leverage CodeSandbox (#29280) @siriwatknpprocess.browser (#29438) @oliviertassinariMuiTextField's default props in the migration guide (#29174) @tm1000Print export feature info on the pricing page (#29484) @DanailHdocs:api (#28828) @m4theushwcreateClientRender with new createRenderer API (#29471) @eps1lonAbortController on global (#29360) @eps1lonname in Rating (#29329) @eps1lonAll contributors of this release in alphabetical order: @adamfitzgibbon, @ainatenhi, @alexfauquette, @busches, @ChrisClaude, @dan-mba, @DanailH, @danilo-leal, @DASPRiD, @ElonVolo, @eps1lon, @eric-burel, @flaviendelangle, @gssakash, @hbjORbj, @IPJT, @jacklaurencegaray, @Jareechang, @jatinsandilya, @m4theushw, @mbeltramin, @mbrookes, @michaldudak, @mnajdova, @nicbarajas, @oliviertassinari, @Pablion, @robcaldecott, @siriwatknp, @tanay123456789, @tm1000, @Wimukti, @ZeeshanTamboli
<!-- 32 -->[CSSBaseline] Remove incorrect @deprecated annotation (#29069) @adamfitzgibbon
<!-- generated comparing v5.0.4..master -->
Oct 26, 2021
A big thanks to the 19 contributors who made this release possible. Here are some highlights ✨:
Masonry using Flexbox by @hbjORbj.@mui/core by @rebeccahongsf and @hbjORbj.@mui/codemod@5.0.5link-underline-hover transformer (#29214) @siriwatknp@mui/core@5.0.0-alpha.52@mui/lab@5.0.0-alpha.52@mui/icons@5.0.5@mui/material@5.0.5img role instead of custom image role (#29172) @eps1lonfullWidth styling (#28652) @nikitabobersiconPosition prop added in Tab (#28764) @deepanshu2506@mui/system@5.0.5sx prop (#29198) @hbjORbjcolorScheme conflict between application (#29139) @siriwatknpunstable_createCssVarsProvider api (#28965) @siriwatknpDataGrid CSV export options page (#29220) @DanailHjustifyContent values and update box styling (#29117) @omarmosiduseEventCallback (#28910) @NMinhNguyenunstable_ClassNameGenerator API (#29051) @siriwatknpAll contributors of this release in alphabetical order: @adamfitzgibbon, @DanailH, @deepanshu2506, @Devesh21700Kumar, @eps1lon, @gnowland, @hbjORbj, @jatinsandilya, @JuliaNeumann, @LorenzHenk, @michal-perlakowski, @michaldudak, @mnajdova, @nikitabobers, @NMinhNguyen, @omarmosid, @rebeccahongsf, @siriwatknp, @waxidiotic
A big thanks to the 17 contributors who made this release possible. Here are some highlights ✨:
Oct 14, 2021
A big thanks to the 17 contributors who made this release possible. Here are some highlights ✨:
UnstyledInput and useInput hook in the the first component in @mui/core package @michaldudak (#28053)@mui/material@5.0.4... triggering onChange with page value null (#28884) @ZeeshanTambolichildren as required where nullish children would crash at runtime (#29028) @eps1lon@mui/system@5.0.4style function (#28744) @hbjORbj@mui/core@5.0.0-alpha.51@mui/lab@5.0.0-alpha.51theme.breakpoints (#29039) @eps1lon@mui/material (#29006) @visualfanaticmui-image related project (#28621) @benmnebBox import for sx-prop example (#28873) @phudekarpeerDependencies to require latest instead of next (#29007) @eps1lonprivate Joy package (#28957) @siriwatknpAll contributors of this release in alphabetical order: @amen-souissi, @benmneb, @epodol, @eps1lon, @goncalovf, @hbjORbj, @Jareechang, @kgregory, @michaldudak, @mnajdova, @mottox2, @officialpiyush, @phudekar, @siriwatknp, @tanyabouman, @visualfanatic, @ZeeshanTamboli
A big thanks to the 19 contributors who made this release possible. Here are some highlights ✨:
Oct 7, 2021
A big thanks to the 19 contributors who made this release possible. Here are some highlights ✨:
@mui/material-next - our v6 prototype package.@mui/material@5.0.3addEndListener not being called with the DOM node (#28715) @eps1lon@mui/codemod@5.0.3optimal-imports to support v4 and v5-alpha, beta (#28812) @siriwatknp@mui/system@5.0.3@mui/styled-engine-sc@5.0.3@mui/core@5.0.0-alpha.50@mui/lab@5.0.0-alpha.50onViewChange is set (#28765) @eps1lon@mui/material-next@6.0.0-alpha.4--exact from release:version (#28840) @siriwatknpstyled function (#28862) @hbjORbjAll contributors of this release in alphabetical order: @AnilSeervi, @avranju94, @cacpgomes, @danilo-leal, @epodol, @eps1lon, @hbjORbj, @iamsergo, @michaldudak, @mnajdova, @owais635, @saeedseyfi, @Sharry0, @siriwatknp, @smmoosavi, @taghi-khavari, @veerreshr, @yevheniiminin, @ZeeshanTamboli
<!-- generated comparing v5.0.0..master -->
<!-- generated comparing v5.0.0..master -->
Sep 22, 2021
A big thanks to the 15 contributors who made this release possible. Here are some highlights ✨:
@mui/material@5.0.1@mui/codemod@5.0.1@mui/lab@5.0.0-alpha.48seconds view (#25095) @breitembach<Alert icon={false} /> behaves (#28348) @nguyenkhanhnamscreen (#28507) @eps1lonAll contributors of this release in alphabetical order: @breitembach, @chetrit, @coder-freestyle, @danilo-leal, @danwoods, @eps1lon, @hbjORbj, @michaldudak, @mnajdova, @nguyenkhanhnam, @oliviertassinari, @sakura90, @siriwatknp, @valse, @xenostar
<!-- generated comparing v5.0.0-rc.1..next -->
<!-- generated comparing v5.0.0-rc.1..next -->
Sep 16, 2021
After over 400 days of development and over 40 canary releases, we are excited to introduce MUI Core v5.0.0!
Some statistics with the release of v5.0.0 compared to the one of v4.0.0:
A big thanks to the 600+ contributors who made the release possible!
The 5.0.0 version includes all changes done in the alpha, beta, and rc releases listed below. These are the changes done from the last release candidate version (5.0.0-rc.1):
@mui/material@5.0.0@mui/system@5.0.0@mui/codemod@5.0.0@mui/lab@5.0.0-alpha.46All contributors of this release in alphabetical order: @aghArdeshir, @Aurelain, @eps1lon, @goncalovf, @jedwards1211, @m4theushw, @mbrookes, @michaldudak, @mnajdova, @nikitabobers, @praveenkumar-kalidass, @siriwatknp, @sydneyjodon-wk, @tamboliasir1, @tholman, @zadeviggers, @ZeeshanTamboli
A big thanks to the 13 contributors who made this release possible. Here are some highlights ✨:
Sep 8, 2021
A big thanks to the 13 contributors who made this release possible. Here are some highlights ✨:
@mui/material@5.0.0-rc.1ref type from component (#28101) @eps1lonref of Select and input element (#28054) @DouglasPdsvalue (#28172) @eps1lon@mui/system@5.0.0-rc.1@mui/codemod@5.0.0-rc.1preset-safe (#28183) @mnajdova@mui/lab@5.0.0-alpha.46All contributors of this release in alphabetical order: @akashshyamdev, @aleccaputo, @DouglasPds, @eps1lon, @goncalovf, @hbjORbj, @michaldudak, @mnajdova, @oliviertassinari, @outofgamut, @paullaros, @RomarQ, @siriwatknp
A big thanks to the 18 contributors who made this release possible. Here are some highlights ✨:
Sep 1, 2021
A big thanks to the 18 contributors who made this release possible. Here are some highlights ✨:
🎉 Renamed packages to @mui/* as part of rebranding the company, following the strategy of expanding the library scope beyond Material Design. For more details about it, check the GitHub discussion.
🛠 Added mui-replace codemod for migrating @material-ui/* to new packages @mui/*. Check out this codemod detail or head to migration guide
🧪 Added new <Mansory> component to the lab, check it out. It has been crafted by our first intern, @hbjORbj 👏!
<img width="538" alt="" src="https://user-images.githubusercontent.com/3165635/131869894-32011cad-0420-4063-926a-339458eb4b85.png">
@mui/material@5.0.0-rc.0<!-- 33 -->[core] Rename packages (#28049) @mnajdova
replace @material-ui/* prefix with @mui/*:
@material-ui/system -> @mui/system
@material-ui/styles -> @mui/styles
@material-ui/lab -> @mui/lab
@material-ui/types -> @mui/types
@material-ui/styled-engine -> @mui/styled-engine
@material-ui/styled-engine-sc ->@mui/styled-engine-sc
@material-ui/private-theming -> @mui/private-theming
@material-ui/codemod -> @mui/codemod
except these 3 packages that are renamed.
@material-ui/core => @mui/material // represents Material Design components.
@material-ui/icons => @mui/icons-material // represents Material Design icons.
@material-ui/unstyled => @mui/core // fully functional components and hooks with no/minimum styles.
Note:
@mui/core(previously@material-ui/unstyled) is not the same as@material-ui/core.
We encourage you to use the codemod for smooth migration.
value prop (#27977) @vedadeeptaimage role if image prop is specified but no image component is specified (#27676) @eps1lon@mui/core@5.0.0-alpha.45@mui/lab@5.0.0-rc.0@mui/codemod@5.0.0-rc.0mui-replace codemod transform (#28060) @siriwatknpno-use-before-define (#27984) @eps1lonrelease:changelog script (#27941) @eps1lonAll contributors of this release in alphabetical order: @aaronlademann-wf, @bene-we, @chetas411, @eps1lon, @flaviendelangle, @hbjORbj, @iamhosseindhv, @m4theushw, @michaldudak, @mnajdova, @oliviertassinari, @rajzik, @rsxdalv, @siriwatknp, @StefanBRas, @StefanTobler, @tdmiller1, @vedadeepta
Your coding agent can read these notes before it upgrades. Set up the MCP server →