/material-icons documentation page is hard to find

[azz0r]

Hello,

I've been attempting to add icons to my site and I've find the process of finding the icon I need quite difficult.

Most of the material ui documentation links back to this page: https://material-ui.com/components/icons/

That page has some information on how icons work and potential issues etc, but it doesn't provide any listing of icons I can use.

I've ended up relying on sites like this: https://www.materialui.co/icons?s=load

It seems to me that the icon page on the material ui website should have functionality like this instead.

Edit: I've found https://material-ui.com/components/material-icons/ digging around more, it seems this should be easier to surface?

Thoughts?

[eps1lon]

Edit: I've found material-ui.com/components/material-icons digging around more, it seems this should be easier to surface?

It's mentioned on the page.

The goal is that the page will rank higher in search engine but it got added recently so this might take some time.

[oliviertassinari]

it seems this should be easier to surface?

@azz0r Right on spot! I'm all ears to proposals to improve it. I was thinking of this very problem recently but I made no progress.

#17435 changes this link to redirect to the icons search page:

[azz0r]

My personal opinion is that it would be better suited on the right hand side quick menu with a name that indicates its a way to view all icons available. Something like this:

[oliviertassinari]

@azz0r I would propose the following diff to reduce the distractions, would it help?:

diff --git a/docs/src/pages/components/icons/icons.md b/docs/src/pages/components/icons/icons.md
index 15b38f076..03d0fcae1 100644
--- a/docs/src/pages/components/icons/icons.md
+++ b/docs/src/pages/components/icons/icons.md
@@ -7,13 +7,7 @@ components: Icon, SvgIcon

 <p class="description">Guidance and suggestions for using icons with Material-UI.</p>

-A [system icon](https://material.io/design/iconography/system-icons.html) or UI icon,
-symbolizes a command, file, device, or directory.
-System icons are also used to represent common actions like trash, print, and save,
-and are commonly found in app bars, toolbars, buttons, and lists.
-Google has provided a set of [Material icons](https://material.io/tools/icons/?style=baseline) that follow these guidelines.
-
-Material-UI provides two components to render system icons: `SvgIcon` for rendering SVG paths, and `Icon` for rendering font icons.
+Material-UI provides two components to render [system icons](https://material.io/design/iconography/system-icons.html): `SvgIcon` for rendering SVG paths, and `Icon` for rendering font icons.

 ## SVG Icons

@@ -38,7 +32,7 @@ It's interesting to have the building blocks needed to implement custom icons, b

 #### Usage

-You can use the [internal search](/components/material-icons/) or [material.io/tools/icons](https://material.io/tools/icons/?style=baseline) to find a specific icon.
+You can use the [dedicated search](/components/material-icons/) (recommended) or [material.io/tools/icons](https://material.io/tools/icons/?style=baseline) to find a specific icon.
 When importing an icon, keep in mind that the names of the icons are `PascalCase`, for instance:

 - [`delete`](https://material.io/tools/icons/?icon=delete&style=baseline) is exposed as `@material-ui/icons/Delete`

[oliviertassinari]

@azz0r Your proposal with available icons is interesting too as I expect most people to want to use theme. Do you want to work on a pull request? :)

[croraf]

Indeed I remember that I too had the trouble of finding these icons. (but actually there wasn't a mui specific finder page before?)

I would maybe add Icons as the top level item of the leftside menu. I think this is the same proposal as the one from @azz0r