# What changed in @mui/material

> 46 changes in @mui/material 9 from its official release notes, upgrade guides and advisories: 45 breaking. Each one cited. Sources checked 2026-10-19. HTML: https://unstale.sh/npm/@mui/material/

To see which of these apply to a repository, run `npx @unstale/cli init` in it.

## @mui/material 9

### Breaking changes

- The legacy icon export was removed; use AddCircleOutlined instead. (9.0.0) — [upgrade guide](https://mui.com/material-ui/migration/upgrade-to-v9)
- The params shape passed to TextField from Autocomplete changed to match the new TextField API, including slotProps.htmlInput. (9.0.0) — [upgrade guide](https://mui.com/material-ui/migration/upgrade-to-v9)
- The legacy icon export was removed; use ChatBubbleOutlined instead. (9.0.0) — [upgrade guide](https://mui.com/material-ui/migration/upgrade-to-v9)
- The legacy icon export was removed; use CheckCircleOutlined instead. (9.0.0) — [upgrade guide](https://mui.com/material-ui/migration/upgrade-to-v9)
- The deprecated Tooltip prop was removed; use slots instead. (9.0.0) — [upgrade guide](https://mui.com/material-ui/migration/upgrade-to-v9)
- The deprecated Tooltip prop was removed; use slotProps instead. (9.0.0) — [upgrade guide](https://mui.com/material-ui/migration/upgrade-to-v9)
- The legacy icon export was removed; use DeleteOutlined instead. (9.0.0) — [upgrade guide](https://mui.com/material-ui/migration/upgrade-to-v9)
- The legacy icon export was removed; use DoneOutlined instead. (9.0.0) — [upgrade guide](https://mui.com/material-ui/migration/upgrade-to-v9)
- The legacy icon export was removed; use DriveFileMoveOutlined instead. (9.0.0) — [upgrade guide](https://mui.com/material-ui/migration/upgrade-to-v9)
- The legacy icon export was removed; use ErrorOutlined instead. (9.0.0) — [upgrade guide](https://mui.com/material-ui/migration/upgrade-to-v9)
- The deprecated Tabs CSS class was removed; use the list class instead. (9.0.0) — [upgrade guide](https://mui.com/material-ui/migration/upgrade-to-v9)
- The deprecated Tabs CSS class was removed; combine the list and vertical classes instead. (9.0.0) — [upgrade guide](https://mui.com/material-ui/migration/upgrade-to-v9)
- The deprecated TextField prop was removed; use slotProps.formHelperText instead. (9.0.0) — [upgrade guide](https://mui.com/material-ui/migration/upgrade-to-v9)
- The deprecated ToggleButtonGroup CSS class was removed; use the horizontal and grouped class combination instead. (9.0.0) — [upgrade guide](https://mui.com/material-ui/migration/upgrade-to-v9)
- The deprecated ToggleButtonGroup CSS class was removed; use the vertical and grouped class combination instead. (9.0.0) — [upgrade guide](https://mui.com/material-ui/migration/upgrade-to-v9)
- The legacy icon export was removed; use HelpOutlined instead. (9.0.0) — [upgrade guide](https://mui.com/material-ui/migration/upgrade-to-v9)
- The deprecated TableSortLabel CSS class was removed; combine MuiTableSortLabel-directionAsc and MuiTableSortLabel-icon instead. (9.0.0) — [upgrade guide](https://mui.com/material-ui/migration/upgrade-to-v9)
- The deprecated TableSortLabel CSS class was removed; combine MuiTableSortLabel-directionDesc and MuiTableSortLabel-icon instead. (9.0.0) — [upgrade guide](https://mui.com/material-ui/migration/upgrade-to-v9)
- The deprecated Tab CSS class was removed; use the icon class instead. (9.0.0) — [upgrade guide](https://mui.com/material-ui/migration/upgrade-to-v9)
- The legacy icon export was removed; use InfoOutlined instead. (9.0.0) — [upgrade guide](https://mui.com/material-ui/migration/upgrade-to-v9)
- The deprecated TextField prop was removed; use slotProps.inputLabel instead. (9.0.0) — [upgrade guide](https://mui.com/material-ui/migration/upgrade-to-v9)
- The deprecated TextField prop was removed; use slotProps.input instead. (9.0.0) — [upgrade guide](https://mui.com/material-ui/migration/upgrade-to-v9)
- The deprecated TextField prop was removed; use slotProps.htmlInput instead. (9.0.0) — [upgrade guide](https://mui.com/material-ui/migration/upgrade-to-v9)
- The legacy icon export was removed; use LabelImportantOutlined instead. (9.0.0) — [upgrade guide](https://mui.com/material-ui/migration/upgrade-to-v9)
- The legacy icon export was removed; use LightbulbOutlined instead. (9.0.0) — [upgrade guide](https://mui.com/material-ui/migration/upgrade-to-v9)
- The legacy icon export was removed; use LockOutlined instead. (9.0.0) — [upgrade guide](https://mui.com/material-ui/migration/upgrade-to-v9)
- The legacy icon export was removed; use MailOutlined instead. (9.0.0) — [upgrade guide](https://mui.com/material-ui/migration/upgrade-to-v9)
- The legacy icon export was removed; use ModeEditOutlined instead. (9.0.0) — [upgrade guide](https://mui.com/material-ui/migration/upgrade-to-v9)
- The deprecated Typography CSS class and prop were removed; style paragraph elements with .MuiTypography-root:where(p), and use sx for margin bottom. (9.0.0) — [upgrade guide](https://mui.com/material-ui/migration/upgrade-to-v9)
- The legacy icon export was removed; use PauseCircleOutlined instead. (9.0.0) — [upgrade guide](https://mui.com/material-ui/migration/upgrade-to-v9)
- The legacy icon export was removed; use PeopleOutlined instead. (9.0.0) — [upgrade guide](https://mui.com/material-ui/migration/upgrade-to-v9)
- The legacy icon export was removed; use PersonOutlined instead. (9.0.0) — [upgrade guide](https://mui.com/material-ui/migration/upgrade-to-v9)
- The legacy icon export was removed; use PieChartOutlined instead. (9.0.0) — [upgrade guide](https://mui.com/material-ui/migration/upgrade-to-v9)
- The legacy icon export was removed; use PlayCircleOutlined instead. (9.0.0) — [upgrade guide](https://mui.com/material-ui/migration/upgrade-to-v9)
- The legacy icon export was removed; use RemoveCircleOutlined instead. (9.0.0) — [upgrade guide](https://mui.com/material-ui/migration/upgrade-to-v9)
- The deprecated Tabs prop was removed; use slots.scrollButtons instead. (9.0.0) — [upgrade guide](https://mui.com/material-ui/migration/upgrade-to-v9)
- The deprecated TextField prop was removed; use slotProps.select instead. (9.0.0) — [upgrade guide](https://mui.com/material-ui/migration/upgrade-to-v9)
- The deprecated Tabs slot name was removed; use slots.endScrollButtonIcon instead. (9.0.0) — [upgrade guide](https://mui.com/material-ui/migration/upgrade-to-v9)
- The deprecated Tabs slot name was removed; use slots.startScrollButtonIcon instead. (9.0.0) — [upgrade guide](https://mui.com/material-ui/migration/upgrade-to-v9)
- The legacy icon export was removed; use StarOutlined instead. (9.0.0) — [upgrade guide](https://mui.com/material-ui/migration/upgrade-to-v9)
- Deprecated system props were removed from Box, DialogContentText, Grid, Link, Stack, Typography, TimelineContent, and TimelineOppositeContent; use sx instead. (9.0.0) — [upgrade guide](https://mui.com/material-ui/migration/upgrade-to-v9)
- The deprecated Tabs prop was removed; use slotProps.indicator instead. (9.0.0) — [upgrade guide](https://mui.com/material-ui/migration/upgrade-to-v9)
- The deprecated Tabs prop was removed; use slotProps.scrollButtons instead. (9.0.0) — [upgrade guide](https://mui.com/material-ui/migration/upgrade-to-v9)
- The legacy icon export was removed; use WorkOutlined instead. (9.0.0) — [upgrade guide](https://mui.com/material-ui/migration/upgrade-to-v9)
- The legacy icon export was removed; use WorkspacesOutlined instead. (9.0.0) — [upgrade guide](https://mui.com/material-ui/migration/upgrade-to-v9)

### Fixes and other changes

- When a system prop such as color is supplied with the component prop, it is now correctly forwarded to the rendered element instead of being consumed. (9.0.0) — [upgrade guide](https://mui.com/material-ui/migration/upgrade-to-v9)