NewYour coding agent can read the release notes before it upgrades.Set up the MCP server →
npm · #2936 most downloaded on npm
Internal package to track number of downloads of our design system libraries.
Last release 21 days ago
27 Aug 2026
Ships fairly regularly
a new release about every 2 weeks
Nearly every release is documented
notes for 60 of the last 60 stable releases
Nothing withdrawn
no release was ever pulled
4 years old
204 releases · first in 2022
One column per quarter.
A big thanks to the 17 contributors who made this release possible. This release was mostly about 🐛 bug fixes and 📚 documentation improvements.
Jan 17, 2023
A big thanks to the 17 contributors who made this release possible. This release was mostly about 🐛 bug fixes and 📚 documentation improvements.
@mui/material@5.11.5strictNullChecks is false (#35367) @fenghan34SliderUnstyled with useSlider hook (#35770) @ZeeshanTamboli@mui/system@5.11.5createBox types (#35532) @mnajdova@mui/codemod@5.11.5joy-text-field-to-input codemod (#35462) @hbjORbj@mui/base@5.0.0-alpha.114@mui/joy@5.0.0-alpha.63:hover, :active styles when selected (#35750) @sai6855TextField component and replace its usage in docs with FormControl/FormLabel/Input (#35462) @hbjORbjmui-x usage (#35740) @LukasTyTypography docs (#35796) @atrefonasnext-env.d.ts from Next.js examples (#35772) @JuneezeeAll contributors of this release in alphabetical order: @alexfauquette, @atrefonas, @fenghan34, @hbjORbj, @HeVictor, @Juneezee, @LukasTy, @mnajdova, @msoyka, @nnmax, @oliviertassinari, @pupudu, @sai6855, @samuelsycamore, @siriwatknp, @volhalink, @ZeeshanTamboli
A big thanks to the 14 contributors who made this release possible. This release was mostly about 🐛 bug fixes and 📚 documentation improvements.
Jan 9, 2023
A big thanks to the 14 contributors who made this release possible. This release was mostly about 🐛 bug fixes and 📚 documentation improvements.
@mui/material@5.11.4useAutocomplete (#35723) @hamirmahalrenderValue prop's TypeScript type (#34177)" (#35733) @michaldudakTab is hidden, not the whole Tabs (#34026) @Ryczkodata-foo attribute (#35736) @koolskateguy89@mui/joy@5.0.0-alpha.62type attribute for popup indicator (#35648) @hbjORbjonKeyDown event handler for demo (#35642) @hbjORbj@mui/base@5.0.0-alpha.113MenuItem to list all valid props (#35561) @mnajdovaVite.js with TypeScript example (#35683) @miha53cevicAll contributors of this release in alphabetical order: @CowDotDev, @flaviendelangle, @hamirmahal, @hbjORbj, @koolskateguy89, @michaldudak, @miha53cevic, @mnajdova, @oliviertassinari, @Ryczko, @sai6855, @samuelsycamore, @siriwatknp, @ZeeshanTamboli
A big thanks to the 6 contributors who made this release possible. This release was mostly about 🐛 bug fixes and 📚 documentation improvements.
Jan 2, 2023
A big thanks to the 6 contributors who made this release possible. This release was mostly about 🐛 bug fixes and 📚 documentation improvements.
@mui/material@5.11.3renderValue prop's TypeScript type (#34177) @ZeeshanTamboli@mui/joy@5.0.0-alpha.61Input component (#35482) @hbjORbjAll contributors of this release in alphabetical order: @badalsaibo, @hbjORbj, @mbranch, @oliviertassinari, @rjhcnf, @ZeeshanTamboli
<!-- 20 -->[docs] Fix ListItem button deprecated use (#33970) @MickaelAustoni
Dec 26, 2022
A big thanks to the 20 contributors who made this release possible. Here are some highlights ✨:
@mui/material@5.11.2faIR locale (#35587) @hootan-rockyscope prop to be not set when a data cell is rendered within a table head (#35559) @sai6855@mui/utils@5.11.2mergedeep deeply clones source key if it's an object (#35364) @sldk-yuri@mui/base@5.0.0-alpha.112isRtl from Material UI's Slider props (#35564) @michaldudak@mui/joy@5.0.0-alpha.60@mui/material-next@6.0.0-alpha.68sortStability() use case (#35570) @frontendlanelight theme mode when activePage is null (#35575) @LukasTyProgress docs (#35553) @jasonsturgesStack component (#35373) @hbjORbjGrid component (#35374) @hbjORbjAll contributors of this release in alphabetical order: @boutahlilsoufiane, @danhuynhdev, @danilo-leal, @EduardoSCosta, @ekusiadadus, @frontendlane, @hbjORbj, @hootan-rocky, @JagarYousef, @jasonsturges, @leventdeniz, @LukasTy, @michaldudak, @MickaelAustoni, @mnajdova, @oliviertassinari, @sai6855, @siriwatknp, @sldk-yuri, @trizotti
A big thanks to the 15 contributors who made this release possible. Here are some highlights ✨:
A big thanks to the 15 contributors who made this release possible. Here are some highlights ✨:
@mui/material@5.11.1size prop overrides via TypeScript module augmentation (#35460) @MickaelAustoniexperimental_sx back with error code (#35528) @siriwatknp@mui/utils@5.11.1@mui/material-next@6.0.0-alpha.67@mui/joy@5.0.0-alpha.59@mui/base@5.0.0-alpha.111Select component onChange event type in the migration guide (#35509) @tzynwangProviding the colors directly section (#35507) @cassidooCardMedia example without component="img" prop (#35470) @lucasmfredmarkunstable_sxConfig typo (#35478) @siriwatknpAll contributors of this release in alphabetical order: @42tte, @cassidoo, @danilo-leal, @DimaAbr, @lucasmfredmark, @michaldudak, @MickaelAustoni, @Miigaarino, @mnajdova, @oliviertassinari, @sai6855, @siriwatknp, @sydneyjodon-wk, @talgautb, @tzynwang
The breaking change is regarding an experimental API:
Dec 13, 2022
A big thanks to the 19 contributors who made this release possible. Here are some highlights ✨:
sx prop in the theme (#35150)@mui/material@5.11.0MenuProps.PopoverClasses being overriden (#35394) @vitorfrs-dev@mui/icons-material@5.11.0@mui/system@5.11.0[system] Enable configuring the sx prop in the theme (#35150) @mnajdova
The breaking change is regarding an experimental API:
-import { styled, experimental_sx } from '@mui/material/styles';
+import { styled } from '@mui/material/styles';
-const Component = styled('div)(experimental_sx({ p: 1 }});
+const Component = styled('div)(({ theme }) => theme.unstable_sx({ p: 1 }});
@mui/joy@5.0.0-alpha.58@mui/base@5.0.0-alpha.110@mui/material-next@6.0.0-alpha.66Responsive App bar with Drawer demo (#35418) @ZeeshanTamboliToggleButtonSizes demo (#35375) @Armanio/core page to use CSS variables (#35366) @siriwatknpAll contributors of this release in alphabetical order: @alexfauquette, @Armanio, @danilo-leal, @EduardoSCosta, @flaviendelangle, @jesrodri, @joserodolfofreitas, @kraftware, @michaldudak, @mnajdova, @oliviertassinari, @PratikDev, @samuelsycamore, @siriwatknp, @Spanishiwa, @timbset, @tsollbach, @vitorfrs-dev, @ZeeshanTamboli
A big thanks to the 15 contributors who made this release possible. Here are some highlights ✨:
Dec 6, 2022
A big thanks to the 15 contributors who made this release possible. Here are some highlights ✨:
components / componentProps to slots / slotProps prop in Joy UI to create consistency across products (#34997)@mui/material@5.10.17markActive theme class not getting applied (#35067) @ZeeshanTambolilabelEmptyValueActive style overrides from theme (#35315) @sai6855@mui/system@5.10.17@mui/joy@5.0.0-alpha.57<!-- 08 -->[Joy] Add slots/slotProps props to the typing of all components and apply useSlot to all components (#34997) @hbjORbj
components and componentsProps props in Joy UI components to slots and slotProps, respectively.-<Autocomplete components={{listbox: CustomListbox}} componentsProps={{listbox: { className: 'custom-listbox' }}} />
+<Autocomplete slots={{listbox: CustomListbox}} slotProps={{listbox: { className: 'custom-listbox' }}} />
You can use this codemod to help with the migration.
All contributors of this release in alphabetical order: @flaviendelangle, @guotie, @happyincent, @hbjORbj, @Juneezee, @michaldudak, @mnajdova, @nomandhoni-cs, @oliviertassinari, @Pandey-utkarsh, @sai6855, @samuelsycamore, @siriwatknp, @Uzwername, @zignis
A big thanks to the 13 contributors who made this release possible. This release contains various 🐛 bug fixes, 📚 documentation, and ⚙️ infrastructure
Nov 28, 2022
A big thanks to the 13 contributors who made this release possible. This release contains various 🐛 bug fixes, 📚 documentation, and ⚙️ infrastructure improvements.
@mui/material@5.10.16multiple prop is true (#35275) @fenghan34skipFocusWhenDisabled prop to not allow focussing deletable chip if disabled (#35065) @sai6855useFormControl (#35168) @ZeeshanTamboli@mui/system@5.10.16@mui/base@5.0.0-alpha.108describeConformance to TypeScript (#35193) @flaviendelangleAll contributors of this release in alphabetical order: @58bits, @alexfauquette, @fenghan34, @flaviendelangle, @iamxukai, @leventdeniz, @m4theushw, @michaldudak, @oliviertassinari, @sai6855, @siriwatknp, @ZeeshanTamboli, @Zetta56
A big thanks to the 9 contributors who made this release possible. Here are some highlights ✨:
A big thanks to the 9 contributors who made this release possible. Here are some highlights ✨:
@mui/material@5.10.15background.defaultChannel to CssVarsPalette (#35174) @alexfauquette@mui/icons-material@5.10.15@mui/material-next@6.0.0-alpha.63@mui/base@5.0.0-alpha.107error prop works in the Unstyled Input (#35171) @michaldudakAll contributors of this release in alphabetical order: @alexfauquette, @danilo-leal, @iamxukai, @Janpot, @MBilalShafi, @michaldudak, @oliviertassinari, @samuelsycamore, @siriwatknp
A big thanks to the 17 contributors who made this release possible. Here are some highlights ✨:
Nov 15, 2022
A big thanks to the 17 contributors who made this release possible. Here are some highlights ✨:
@mui/material@5.10.14palette.background.defaultChannel token (#35061) @siriwatknp@mui/system@5.10.14@mui/joy@5.0.0-alpha.54FormControl, LinearProgress and ListSubheader components from @mui/joy (#35003) @Studio384Autocomplete component (#34315) @siriwatknpMarkdownElement regression from adding CSS variables (#35096) @siriwatknpAll contributors of this release in alphabetical order: @alexfauquette, @bharatkashyap, @cherniavskii, @danilo-leal, @hbjORbj, @Janpot, @kennethbigler, @kushagra010, @michaldudak, @mnajdova, @ofir5300, @oliviertassinari, @sai6855, @sfavello, @sidtohan, @siriwatknp, @Studio384
A big thanks to the 12 contributors who made this release possible. Here are some highlights ✨:
Nov 7, 2022
A big thanks to the 12 contributors who made this release possible. Here are some highlights ✨:
@mui/material@5.10.13@mui/system@5.10.13@mui/base@5.0.0-alpha.105@mui/joy@5.0.0-alpha.53All contributors of this release in alphabetical order: @akshaya-venkatesh8, @alexfauquette, @hbjORbj, @Janpot, @jesrodri, @michaldudak, @oliviertassinari, @PetroSilenius, @samuelsycamore, @shivam1646, @siriwatknp, @trizotti
A big thanks to the 16 contributors who made this release possible. Here are some highlights ✨:
Oct 31, 2022
A big thanks to the 16 contributors who made this release possible. Here are some highlights ✨:
@mui/material@5.10.12@mui/base@5.0.0-alpha.104@mui/joy@5.0.0-alpha.52value changes (#34897) @hbjORbjLinearProgress component (#34514) @hbjORbjspan for icon image (#34914) @siriwatknpAll contributors of this release in alphabetical order: @cherniavskii, @DanailH, @EduardoSCosta, @emlai, @hbjORbj, @Janpot, @michaldudak, @mnajdova, @oliviertassinari, @punithnayak, @PunitSoniME, @renovate[bot], @RoodyCode, @samuelsycamore, @siriwatknp, @VinceCYLiao
This is a breaking change for anyone who depends on the class names applied to Base components. If you use the UnstyledClasses objects, you won't noti…
A big thanks to the 10 contributors who made this release possible. Here are some highlights ✨:
components to slots prop starting at MUI Base to create consistency across products@mui/material@5.10.11onInvalid to use HTMLInputElement | HTMLTextAreaElement Element type (#33162) @KuShcomponents and componentsProps props to allow close action overrides (#33582) @jake-collibra@mui/base@5.0.0-alpha.103[base] components -> slots API rename (#34693) @michaldudak
-<SwitchUnstyled components={{Root: CustomRoot}} componentsProps={{rail: { className: 'custom-rail' }}} />
+<SwitchUnstyled slots={{root: CustomRoot}} slotProps={{rail: { className: 'custom-rail' }}} />
[base] Make CSS class prefixes consistent (#33411) @michaldudak
This is a breaking change for anyone who depends on the class names applied to Base components.
If you use the <component>UnstyledClasses objects, you won't notice a difference. Only if you depend on the resulting class names (e.g. in CSS stylesheets), you'll have to adjust your code.
-.ButtonUnstyled-root { ... };
+.MuiButton-root { ... };
@mui/joy@5.0.0-alpha.51size prop in components (#34805) @hbjORbjAll contributors of this release in alphabetical order: @bharatkashyap, @hbjORbj, @jake-collibra, @joserodolfofreitas, @KuSh, @marceliwac, @michaldudak, @oliviertassinari, @pixelass, @siriwatknp
A big thanks to the 21 contributors who made this release possible. Here are some highlights ✨:
A big thanks to the 21 contributors who made this release possible. Here are some highlights ✨:
@mui/material@5.10.10defaultProps overridable (#34643) @hbjORbj@mui/system@5.10.10grey color in sx (#34548) @TheUnlocked@mui/styles@5.10.10@mui/joy@5.0.0-alpha.50@mui/base@5.0.0-alpha.102react/no-unstable-nested-components (#34518) @eps1lonAll contributors of this release in alphabetical order: @AbayKinayat, @alexfauquette, @bharatkashyap, @DanailH, @eps1lon, @hayawata3626, @hbjORbj, @Janpot, @joserodolfofreitas, @m4theushw, @mbayucot, @michaldudak, @mohd-akram, @ndresx, @oliviertassinari, @pedroprado010, @rvrvrv, @samuelsycamore, @siriwatknp, @TheUnlocked, @zee-bit
A big thanks to the 7 contributors who made this release possible. Here are some highlights ✨:
A big thanks to the 7 contributors who made this release possible. Here are some highlights ✨:
@mui/material@5.10.9@mui/system@5.10.9<!-- 17 -->[system] Fix color-scheme implementation (#34639) @siriwatknp
The enableColorScheme prop has been removed from CssVarsProvider and getInitColorScheme (both Material UI and Joy UI).
Migration:
<CssBaseline enableColorScheme />.<CssBaseline />, see the docs.@mui/base@5.0.0-alpha.101@mui/joy@5.0.0-alpha.49All contributors of this release in alphabetical order: @HexM7, @joserodolfofreitas, @kushagra010, @michaldudak, @mnajdova, @oliviertassinari, @vanyaxk
A big thanks to the 18 contributors who made this release possible. Here are some highlights ✨:
A big thanks to the 18 contributors who made this release possible. Here are some highlights ✨:
@mui/material@5.10.8disabled class to FAB button (#34245) @meenaramaownerState on the paper slot (#34445) @kabernardes@mui/base@5.0.0-alpha.100useSnackbar hook (#33227) @ZeeshanTamboli@mui/joy@5.0.0-alpha.48variantPlain classname missing in few components (#34534) @hbjORbjnewFeature to the typing of MuiPage (#34511) @flaviendelangleAll contributors of this release in alphabetical order: @Aporim2051, @Dustin-Digitar, @flaviendelangle, @Garz4, @hbjORbj, @hghmn, @kabernardes, @kskd1804, @meenarama, @minkyngkm, @mnajdova, @ndebeiss, @oliviertassinari, @peippo, @rolule, @samuelsycamore, @siriwatknp, @ZeeshanTamboli
A big thanks to the 21 contributors who made this release possible. Here are some highlights ✨:
A big thanks to the 21 contributors who made this release possible. Here are some highlights ✨:
@mui/material@5.10.7:root stylesheet (#34131) @siriwatknpalternativeLabel is used (#34335) @ZeeshanTambolititle (#34289) @abhinav-22-tech@mui/system@5.10.7enableSystem with defaultMode (#33960) @siriwatknpshape.borderRadius in theme (#34076) @ZeeshanTamboli@mui/material@5.0.0-alpha.101@mui/base@5.0.0-alpha.99[TrapFocus] Rename TrapFocus to FocusTrap (#34216) @kabernardes
- import TrapFocus from ‘@mui/base/TrapFocus’;
+ import FocusTrap from ‘@mui/base/FocusTrap’;
@mui/joy@5.0.0-alpha.47value, required, and readOnly to input (#34477) @siriwatknponClick prop (#34455) @HexM7Divider component (#34403) @siriwatknpreadOnly and required to input (#34478) @siriwatknpuseMenu and useMenuItem hooks demo (#34166) @ZeeshanTamboliGrid docs (#34475) @Dustin-DigitarBack to top section in AppBar docs (#34479) @Dustin-Digitarwebpack.config.js (#34446) @CodingItWrongonChange call (#34408) @siriwatknpAll contributors of this release in alphabetical order: @abhinav-22-tech, @alexfauquette, @CodingItWrong, @Dustin-Digitar, @garronej, @HexM7, @howlettt, @Janpot, @joserodolfofreitas, @kabernardes, @MBilalShafi, @Methuselah96, @michaldudak, @mnajdova, @oliviertassinari, @prakhargupta1, @pratikkarad, @ptrfrncsmrph, @samuelsycamore, @siriwatknp, @ZeeshanTamboli
BREAKING CHANGE: replace start/endIcon with start/endDecorator.
Sep 19, 2022
A big thanks to the 11 contributors who made this release possible. This release was mostly about 🐛 bug fixes and 📚 documentation improvements.
@mui/material@5.10.6Bootstrap even when label is not defined (#34343) @ZeeshanTamboli@mui/joy@5.0.0-alpha.46[button][joy] Replace start/endIcon prop with start/endDecorator (#34288) @hbjORbj
BREAKING CHANGE: replace start/endIcon with start/endDecorator.
// before
<Button startIcon={...} endIcon={...} />
// after
<Button startDecorator={...} endDecorator={...} />
Input and Textarea styles (#34281) @siriwatknp@mui/base@5.0.0-alpha.98[Select][base] Add event parameter to the onChange callback (#34158) @michaldudak
The SelectUnstyled and MultiSelectUnstyled onChange callbacks did not have event as the first parameter, leading to inconsistency with other components and native HTML elements.
This PR adds the event parameter as the first one and moves the newly selected value to the second position. Because of this, it's a breaking change.
This also affects Select from Joy UI.
// before
<SelectUnstyled onChange={(newValue) => { /* ... */ }} />
// after
<SelectUnstyled onChange={(event, newValue) => { /* ... */ }} />
typescript-to-proptypes, respect the value pass to the generic (#34311) @flaviendelangleAll contributors of this release in alphabetical order: @alexfauquette, @flaviendelangle, @hbjORbj, @Janpot, @michaldudak, @oliviertassinari, @renovate[bot], @samuelsycamore, @siriwatknp, @tomasz-sodzawiczny, @ZeeshanTamboli
A big thanks to the 12 contributors who made this release possible. Here are some highlights ✨:
Sep 12, 2022
A big thanks to the 12 contributors who made this release possible. Here are some highlights ✨:
Alert, Modal, ListSubheader, FormControl, CircularProgress components to Joy UI (#33859) @hbjORbj @siriwatknp@mui/material@5.10.5primaryTypography (#33880) @iamxukai@mui/joy@5.0.0-alpha.45CircularProgress component (#33869) @hbjORbjFormControl component (#34187) @siriwatknpListSubheader component (#34191) @siriwatknpModal component (#34043) @siriwatknptextarea props from componentsProps (#34223) @HexM7Usage docs (#34200) @zillion504All contributors of this release in alphabetical order: @bytasv, @ChrystianDeMatos, @hbjORbj, @HexM7, @iamxukai, @kushagra010, @LukasTy, @michaldudak, @oliviertassinari, @siriwatknp, @ZeeshanTamboli, @zillion504
A big thanks to the 11 contributors who made this release possible. Here are some highlights ✨:
A big thanks to the 11 contributors who made this release possible. Here are some highlights ✨:
Alert component to Joy UI (#33859) @hbjORbj@mui/material@5.10.4@mui/joy@5.0.0-alpha.44componentsProps generic (#34140) @hbjORbjAlert component (#33859) @hbjORbjBreadcrumbs component (#33860) @hbjORbjcomponent prop (#34172) @siriwatknp@mui/base@5.0.0-alpha.96mui-color-input, mui-chips-input and mui-tel-input into the related projects page (#34123) @viclafouchtypes field to packages without index.d.ts (#33952) @michaldudakmousePress function (#34124) @cherniavskiiAll contributors of this release in alphabetical order: @cherniavskii, @DanailH, @hbjORbj, @Janpot, @michaldudak, @oliviertassinari, @paulschreiber, @ropereraLK, @samuelsycamore, @siriwatknp, @viclafouch
A big thanks to the 16 contributors who made this release possible. Here are some highlights ✨:
Aug 29, 2022
A big thanks to the 16 contributors who made this release possible. Here are some highlights ✨:
@mui/material@5.10.3disableClearable is used (#34053) @mnajdova@mui/system@5.10.3@mui/base@5.0.0-alpha.95@mui/joy@5.0.0-alpha.43role proptypes (#34119) @siriwatknpcomponentsProps for all components (#34077) @siriwatknpcomponentsProps as a function (#34022) @siriwatknpTextarea component (#33975) @siriwatknpSelect component (#34091) @HexM7DatePicker component demo on the home page (#34054) @NaveenPantraOverridableComponent via module augmentation for better performance (#32735) @mnajdovaAll contributors of this release in alphabetical order: @alexfauquette, @bharatkashyap, @bicstone, @danilo-leal, @EthanStandel, @HexM7, @hoangph271, @JonathanAsbury-SPS, @michaldudak, @mnajdova, @NaveenPantra, @oliviertassinari, @pieetrus, @renovate[bot], @siriwatknp, @ZeeshanTamboli
A big thanks to the 11 contributors who made this release possible. Here are some highlights ✨:
Aug 22, 2022
A big thanks to the 11 contributors who made this release possible. Here are some highlights ✨:
@mui/material@5.10.2keepMounted Popper prop not working (#33957) @ZeeshanTamboli@mui/system@5.10.2@mui/joy@5.0.0-alpha.42@mui/icons-material@5.8.5test folder's README (#33976) @ropereraLKgetInitialProps with getStaticProps" (#33991) @mnajdovaAll contributors of this release in alphabetical order: @AjeetSingh2016, @alirezahekmati, @Cerebro92, @danilo-leal, @djohalo2, @jsakas, @michaldudak, @mnajdova, @oliviertassinari, @ropereraLK, @samuelsycamore, @TheUnlocked, @tomasz-sodzawiczny, @ZeeshanTamboli
A big thanks to the 18 contributors who made this release possible. This release was mostly around 🐛 bug fixes and 📚 documentation improvements.
Aug 16, 2022
A big thanks to the 18 contributors who made this release possible. This release was mostly around 🐛 bug fixes and 📚 documentation improvements.
@mui/material@5.10.1@mui/system@5.10.1ContainerProps export (#33923) @bugzpodder@mui/base@5.0.0-alpha.93@mui/joy@5.0.0-alpha.41Link component (#32839) @TKrishnasamyAspectRatio docs (#33895) @IsaacInsoll/system/getting-started/advanced/ does not exist (#33867) @MonstraGAll contributors of this release in alphabetical order: @arjunvijayanathakurup, @bugzpodder, @cherewaty, @cherniavskii, @cmdcolin, @danilo-leal, @EthanStandel, @hayawata3626, @IsaacInsoll, @l10nbot, @michaldudak, @mmostafavi, @MonstraG, @oliviertassinari, @PunitSoniME, @samuelsycamore, @TKrishnasamy, @ZeeshanTamboli
Nothing published for this version
Your coding agent can read these notes before it upgrades. Set up the MCP server →