TL;DR

Material UI v9.0.1 delivers numerous accessibility and usability improvements, particularly for complex components like Autocomplete, Select, and Drawers, enhancing the experience for all users.

Fixes Worth Knowing

• Autocomplete now correctly handles highlighting, scrolling, input values, and iOS-specific issues.
• Drawer components have improved swipe close behavior and transition stability.
• Input components address layout shifts and prevent unintended prop leakage.
• Select components now support single-pointer selection and pointer cancellation.
• Tooltips now close when their child component is disabled.
• Accessibility is improved for Avatar, Badge, Slider, Switch, CircularProgress, and LinearProgress.
• Fixed issues with focus targeting in dialogs, drawers, and focus traps.

Before You Upgrade

If you rely on wildcard imports for icons, be aware they have been reverted to explicit paths.

TL;DR

Material UI’s autocomplete, button, dialog, drawer, input, and switch components received numerous fixes improving stability and visual correctness.

Fixes Worth Knowing

• Autocomplete now maintains highlight and scroll position during updates.
• Button start icons (small icons at the beginning) are now aligned correctly.
• Layout shifts with flexbox inputs are resolved.
• Focus trapping in dialogs and drawers is more reliable.
• Checkboxes now correctly indicate a mixed state with aria-checked=mixed.

TL;DR

Material UI v9 removes deprecated icons and changes grid direction options, requiring updates to existing code that uses these features.

Breaking

• grid direction prop: Removed column and column-reverse options. (Affects grid layout)
• icons: Removed legacy *Outline icons. (Requires updating icon imports)
• list-item-icon: Min width now uses theme spacing. (May affect list item layout)

New

• buttonbase: Added nativeButton prop. (Allows using native button behavior)

Fixes Worth Knowing

• autocomplete: Helper text no longer obscures input. (Improves usability)
• input: Fixed high contrast text cutoff. (Improves accessibility)
• menu: Resolved issues with focus management. (Improves keyboard navigation)

Before You Upgrade

• Update any code using the removed *Outline icons to their modern equivalents.
• Adjust grid layouts if you were relying on the column or column-reverse direction options.

TL;DR

Material UI now supports CSS layers, simplifying style overrides without needing to use !important or complex selectors.

New

CSS layers allow developers to organize and apply styles in a more predictable and maintainable way (styling methodology).

Fixes Worth Knowing

The Dialog component now includes a codemod (automated code transformation) to assist with updating deprecated properties.

Before You Upgrade

Review the CSS layers documentation to understand how to best leverage this new feature for your custom styling.

TL;DR

Material UI now supports CSS layers, simplifying style overrides without needing !important or complex selectors.

New

CSS layers allow developers to organize and apply styles with greater specificity and maintainability (styling methodology).

Fixes Worth Knowing

Migration documentation has been improved, specifically regarding changes to the AccordionSummary component (UI component).

Before You Upgrade

Review the CSS layers documentation to understand how to best utilize this new feature for style customization.

TL;DR

Material UI v7 introduces new slots and slotProps to several components, enhancing customization options for developers using a component-centric approach (customizing parts of a component).

Breaking

• createTypography exports have been renamed in @mui/material/styles. (Update your imports accordingly.)

New

• Component Slots: Accordion, AccordionSummary, ListItemText, Switch, and SpeedDial now expose slots and slotProps for greater styling control.
• Tooltip Placement: Tooltips can now automatically determine their best placement.

Fixes Worth Knowing

• Fixed an infinite loop in TextareaAutosize (automatic resizing text areas).
• Resolved issues with negative spacing values in CSS variables.
• useScrollTrigger now handles null target elements gracefully.

Before You Upgrade

• Review your usage of @mui/material/styles/createTypography and update any imports to reflect the renamed exports.

TL;DR

Material UI v6 introduces significant performance improvements and prepares for React 19 compatibility, while also adopting Pigment CSS (a modern CSS-in-JS solution) for enhanced theming.

Breaking

• Box Component: The component prop is removed from the Box component; use div or cast to typeof Box instead.

New

• React 19 Compatibility: Types have been refactored to support the upcoming React 19 release.
• Pigment CSS Integration: Components are updated to work with Pigment CSS for improved styling and theming.

Fixes Worth Knowing

• Autocomplete: Resolved warnings related to mismatched values and options.
• IconButton: Corrected hover background color behavior.
• Typography: Color values now work correctly with Pigment CSS.

Before You Upgrade

• If you are using the component prop on Box, update your code to use div or cast the styled component to typeof Box.

TL;DR

Material-UI now fully supports TypeScript 4.7, ensuring compatibility for developers using the latest TypeScript version.

Breaking

• TypeScript 4.7 compatibility issues fixed (ensures code compiles correctly)

New

[None]

Fixes Worth Knowing

• TextField component now correctly flags deprecated properties (helps identify outdated code).
• Documentation links updated to the new domain (improves access to information).

Before You Upgrade

• If using TypeScript 4.7, upgrade to this version to avoid compilation errors.

TL;DR

Material-UI has been rebranded to MUI with a significant package renaming – @material-ui/* is now @mui/*. Use the provided codemod for easy migration.

Breaking

• Package Renaming: All packages have been renamed from @material-ui/* to @mui/* (except @mui/material, @mui/icons-material, and @mui/core).

New

• Masonry Component: A new <Masonry> component has been added to @mui/lab for flexible, grid-like layouts.
• ButtonUnstyled: A new unstyled Button component has been added to @mui/core for maximum customization.

Fixes Worth Knowing

• Autocomplete: Resolved a virtualization regression.
• InputBase: Fixed an autofill issue.
• Tabs: Improved indicator positioning when tab sizes change.

Before You Upgrade

• Run the mui-replace codemod to automatically update your import statements to the new package names. See the migration guide for details: [https://next.material-ui.com/guides/migration-v4/#preset-safe](https://next.material-ui.

TL;DR

Prepare for Material-UI v5! These releases introduce numerous deprecation warnings to help smooth the transition, flagging changes like prop renames and removed features.

Breaking

• css prop on Box is deprecated, use sx instead.
• fade color utility is deprecated, use alpha (color manipulation function) instead.
• Grid's justify prop is being renamed.
• GridList is being renamed to ImageList.
• theme.mixins.gutters is deprecated.

New

None

Fixes Worth Knowing

• Resolved a version resolution issue impacting installation.

Before You Upgrade

Install the "deprecations" tag ("@material-ui/core": "deprecations") to see these warnings in your console and begin planning your v5 migration. Report any issues with the deprecations on GitHub.

TL;DR

TypeScript 3.7 users should upgrade to resolve type definition issues with the Portal component (a way to render content outside of a component's normal DOM hierarchy).

Breaking

• PortalProps Types: Fixes compatibility with TypeScript 3.7.

Fixes Worth Knowing

• Portal: Resolves type definition errors when using TypeScript 3.7.

Before You Upgrade

No action needed unless you are using TypeScript 3.7 and experiencing type errors with the Portal component.

TL;DR

Material-UI received numerous refinements, improving component behavior and documentation, particularly around TextField, Table, Drawer, and Dialog components.

Breaking

[None]

New

[None]

Fixes Worth Knowing

• TextField: The disabled prop now correctly disables the entire field (input and label).
• Drawer: Height is now set to 100% instead of 100vh, potentially resolving layout issues.
• Table: Typings have been synchronized and padding issues resolved.
• Tab: fullWidth styling is corrected.

Before You Upgrade

[None]

TL;DR

This release updates the underlying react-event-listener dependency, improving event handling reliability across Material-UI components.

Breaking

None.

New

None.

Fixes Worth Knowing

Improved reliability of event handling (listening for events outside of components) across Material-UI.

Before You Upgrade

No action needed.

TL;DR

Material-UI has undergone significant changes in preparation for v1.0, primarily restructuring imports to improve bundle size and tree-shaking.

Breaking

• Import Paths: Components are now imported from @material-ui/core/ComponentName instead of material-ui/ComponentName. A codemod is available to automate this migration.
• React Version: Requires React 16.3.0 or greater.
• TypeScript: Requires TypeScript 2.8 or later.
• Grid: The hidden property on Grid has been removed; use the Hidden component instead.
• TextField Underline: Underline color customization now uses borderBottomColor instead of backgroundColor.

New

• NativeSelect: A new NativeSelect component has been added.
• Outlined Buttons: An outlined variant for the Button component is now available.

Fixes Worth Knowing

• Improved performance for ButtonBase.
• Fixed issues with Popover on mobile browsers.
• Resolved regressions related to Babel and npm dependencies.

Before You Upgrade

• Run the

TL;DR

The latest updates to Material-UI improve component stability and add styling options, particularly for Date/Time pickers, buttons, and snackbars.

Breaking

• [TimePicker] Removing redundant onDismiss callback when onAccept is already defined.

New

• [RaisedButton] Added buttonStyle property for custom styling.
• [Switch] Added thumbSwitchedStyle and trackSwitchedStyle for customized appearance.

Fixes Worth Knowing

• [Snackbar] Fixed issue where snackbars covered the entire screen width.
• [AppBar, DatePicker, Tabs] Resolved various touch, RTL (right-to-left), and state update issues for improved reliability.

Before You Upgrade

Ensure your React version is 15.0.0 or higher, as this is now a required dependency.