diff --git a/docs/data/material/components/material-icons/SizeMaterialIcon.js b/docs/data/material/components/material-icons/SizeMaterialIcon.js
new file mode 100644
index 00000000000000..a5a9aa734b7a25
--- /dev/null
+++ b/docs/data/material/components/material-icons/SizeMaterialIcon.js
@@ -0,0 +1,15 @@
+import * as React from 'react';
+import Stack from '@mui/material/Stack';
+import AcUnitIcon from '@mui/icons-material/AcUnit';
+import AccountBalanceIcon from '@mui/icons-material/AccountBalance';
+import AddAPhotoIcon from '@mui/icons-material/AddAPhoto';
+
+export default function SizeMaterialIcon() {
+ return (
+
+
+
+
+
+ );
+}
diff --git a/docs/data/material/components/material-icons/SizeMaterialIcon.tsx b/docs/data/material/components/material-icons/SizeMaterialIcon.tsx
new file mode 100644
index 00000000000000..a5a9aa734b7a25
--- /dev/null
+++ b/docs/data/material/components/material-icons/SizeMaterialIcon.tsx
@@ -0,0 +1,15 @@
+import * as React from 'react';
+import Stack from '@mui/material/Stack';
+import AcUnitIcon from '@mui/icons-material/AcUnit';
+import AccountBalanceIcon from '@mui/icons-material/AccountBalance';
+import AddAPhotoIcon from '@mui/icons-material/AddAPhoto';
+
+export default function SizeMaterialIcon() {
+ return (
+
+
+
+
+
+ );
+}
diff --git a/docs/data/material/components/material-icons/SizeMaterialIcon.tsx.preview b/docs/data/material/components/material-icons/SizeMaterialIcon.tsx.preview
new file mode 100644
index 00000000000000..9bb311a4167085
--- /dev/null
+++ b/docs/data/material/components/material-icons/SizeMaterialIcon.tsx.preview
@@ -0,0 +1,3 @@
+
+
+
\ No newline at end of file
diff --git a/docs/data/material/components/material-icons/material-icons.md b/docs/data/material/components/material-icons/material-icons.md
index fcc8997547c097..9b9f645ac6285e 100644
--- a/docs/data/material/components/material-icons/material-icons.md
+++ b/docs/data/material/components/material-icons/material-icons.md
@@ -8,13 +8,13 @@ githubLabel: 'package: icons'
# Material Icons
-2,100+ ready-to-use React Material Icons from the official website.
+2,100+ ready-to-use React Material Icons.
{{"component": "modules/components/ComponentLinkHeader.js"}}
-
-[@mui/icons-material](https://www.npmjs.com/package/@mui/icons-material)
-includes the 2,100+ official [Material Icons](https://fonts.google.com/icons?icon.set=Material+Icons) converted to [`SvgIcon`](/material-ui/api/svg-icon/) components.
+## Introduction
+
+The [`@mui/icons-material`](https://www.npmjs.com/package/@mui/icons-material) package includes the 2,100+ official [Material Icons](https://fonts.google.com/icons?icon.set=Material+Icons) converted to [`SvgIcon`](/material-ui/icons/#svgicon/) components.
It depends on `@mui/material`, which requires Emotion packages.
Use one of the following commands to install it:
@@ -36,7 +36,31 @@ pnpm add @mui/icons-material @mui/material @emotion/styled @emotion/react
See the [Installation](/material-ui/getting-started/installation/) page for additional docs about how to make sure everything is set up correctly.
-
+## Basics
+
+Material Icons use the Material UI [SVG Icon](/material-ui/icons/#svgicon/) component under the hood, so they render without any customization, and feature several props for quickly customizing styles.
+
+{{"demo": "BasicMaterialIcon.js"}}
+
+:::info
+Visit [the SVG Icon component section in the Icon doc](/material-ui/icons/#svgicon/) for further information about its other props, as well as how to use it with other icon libraries.
+:::
+
+### Size
+
+Use the `fontSize` prop to toggle between small, medium (default, 24x24px), or large icon sizes.
+You can also use the `sx` prop to pick arbitrary values that are outside of this built-in scale.
+
+{{"demo": "SizeMaterialIcon.js"}}
+
+### Color
+
+Use the `color` prop to choose a palette key from the theme.
+It defaults to the `main` value of its respective palette.
+
+{{"demo": "ColorMaterialIcon.js"}}
+
+## Browse the library
Browse through the icons below to find the one you need.
The search field supports synonyms—for example, try searching for "hamburger" or "logout."
diff --git a/docs/pages/material-ui/material-icons.js b/docs/pages/material-ui/material-icons.js
index d408a15f74d935..550e0814c4a0b5 100644
--- a/docs/pages/material-ui/material-icons.js
+++ b/docs/pages/material-ui/material-icons.js
@@ -3,5 +3,5 @@ import MarkdownDocs from 'docs/src/modules/components/MarkdownDocs';
import * as pageProps from 'docs/data/material/components/material-icons/material-icons.md?@mui/markdown';
export default function Page() {
- return ;
+ return ;
}