{
    "componentChunkName": "component---src-pages-iconography-ui-icons-usage-mdx",
    "path": "/iconography/ui-icons/usage/",
    "result": {"pageContext":{"frontmatter":{"title":"UI icons","description":"Icons are important aids to the user experience. Employ icons strategically with careful view to sizing, alignment, clearance and color in usage.","tabs":["Library","Design","Usage","Contribute"]},"relativePagePath":"/iconography/ui-icons/usage.mdx","titleType":"append","MdxNode":{"id":"20e11c92-b67d-5a2a-9eaa-d23697c48b2d","children":[],"parent":"e45a0485-a425-5c9c-b01c-83dc52f725e8","internal":{"content":"---\ntitle: UI icons\ndescription:\n  Icons are important aids to the user experience. Employ icons strategically\n  with careful view to sizing, alignment, clearance and color in usage.\ntabs: [Library, Design, Usage, Contribute]\n---\n\nimport Carousel from \"../../../components/Carousel\"\n\n<PageDescription>\n\nIconography is highly functional in a user interface. When used wisely, icons become an elegant, yet efficient, way to communicate with and help guide a user through an experience. To maintain this functionality, it’s important to reduce cognitive load on users by employing icons sparingly and strategically throughout your designs.\n\n</PageDescription>\n\n<Row style=\"{margin-left: 0}\">\n<Column colMd={4} colLg={4}>\n<AnchorLinks>\n  <AnchorLink>Sizing</AnchorLink>\n  <AnchorLink>Alignment</AnchorLink>\n  <AnchorLink>Clearance</AnchorLink>\n  <AnchorLink>Color</AnchorLink>\n</AnchorLinks>\n</Column>\n\n<Column colMd={5} colLg={5}>\n<AnchorLinks>\n  <AnchorLink>Third-party UI icons</AnchorLink>\n  <AnchorLink>UI icons in action</AnchorLink>\n</AnchorLinks>\n</Column>\n</Row>\n\n## Sizing\n\nIcons have been designed to work best in four sizes: 16px, 20px, 24px and 32px. Be sure to use icons at their originally produced size. These icons are provided in SVG format or can be used directly from the Figma, Carbon and IBM Design Language libraries.\n\n| Icon size                                     | Stroke width | Padding | Live area | Corner radius | Type sizes |\n| --------------------------------------------- | ------------ | ------- | --------- | ------------- | ---------- |\n| 32px                                          | 2px          | 2px     | 28px      | 2px           | —          |\n| 24px                                          | 1.5px        | 1.5px   | 21px      | 1.5px         | —          |\n| <span class=\"footnote__highlight\">20px</span> | 1.25px       | 1.25px  | 17.5px    | 1.25px        | 16pt       |\n| <span class=\"footnote__highlight\">16px</span> | 1px          | 1px     | 14px      | 1px           | 14pt       |\n\n<Caption>\n  <span class=\"footnote__highlight\" />\n  <span class=\"footnote\">\n    16px and 20px icons are optimized to feel balanced when paired with 14pt and\n    16pt IBM Plex. Use 24px and 32px when larger icons are needed.\n  </span>\n</Caption>\n\n![](./assets/usage/01-idl-iconography-ui-icons-usage.png)\n\n<DoDontRow>\n<DoDont caption=\"Use the correct icon size with IBM Plex®.\">\n\n![](./assets/usage/02-idl-iconography-ui-icons-usage.png)\n\n</DoDont>\n<DoDont type=\"dont\" caption=\"Don’t alter icon sizes.\">\n\n![](./assets/usage/03-idl-iconography-ui-icons-usage.png)\n\n</DoDont>\n</DoDontRow>\n<DoDontRow>\n<DoDont caption=\"Center-align icons when they’re next to text.\">\n\n![](./assets/usage/04-idl-iconography-ui-icons-usage.png)\n\n</DoDont>\n<DoDont type=\"dont\" caption=\"Don’t baseline align icons to the text.\">\n\n![](./assets/usage/05-idl-iconography-ui-icons-usage.png)\n\n</DoDont>\n</DoDontRow>\n\n## Alignment\n\nIcons are optically aligned to the center of the icon grid within the boundary box. Centering ensures all icons will be aligned correctly when exported and used side by side in a line or a row. Visually center an icon where the visual weight is heaviest. In some situations, mechanically centering doesn’t work.\n\n<Carousel carouselLabel=\"Alignment\" style={{marginTop: \"2rem\"}}>\n\n![](./assets/usage/06-idl-iconography-ui-icons-usage.png)\n\n![](./assets/usage/07-idl-iconography-ui-icons-usage.png)\n\n</Carousel>\n\n## Clearance\n\nWhen designing icons for touch surfaces, all targets should be 44px or greater. The icon can be smaller than 44px if padding is added to the touch target with cascading style sheets (CSS) to meet the 44px minimum.\n\n![](./assets/usage/08-idl-iconography-ui-icons-usage.png)\n\n<DoDontRow>\n<DoDont caption=\"Follow the clearance rule to allow for legibility and an optimal touch experience.\">\n\n![](./assets/usage/09-idl-iconography-ui-icons-usage.png)\n\n</DoDont>\n<DoDont type=\"dont\" caption=\"Don’t collapse the icon clearance area.\">\n\n![](./assets/usage/10-idl-iconography-ui-icons-usage.png)\n\n</DoDont>\n</DoDontRow>\n\n## Color\n\nIcons are always a solid, monochromatic color and must pass the same color contrast ratio as typography (4.5:1). The color of the icon should reflect the importance of the icon’s action, which should always be to help guide a user. For more information about color, see [Color in UI](https://carbondesignsystem.com/elements/icons/usage/#color).\n\n<DoDontRow>\n<DoDont caption=\"Match your icon color with your text color when pairing them.\">\n\n![](./assets/usage/11-idl-iconography-ui-icons-usage.png)\n\n</DoDont>\n<DoDont type=\"dont\" caption=\"Don’t use different colors for text and icons.\">\n\n![](./assets/usage/12-idl-iconography-ui-icons-usage.png)\n\n</DoDont>\n</DoDontRow>\n<DoDontRow>\n<DoDont caption=\"Make icons monotone.\">\n\n![](./assets/usage/13-idl-iconography-ui-icons-usage.png)\n\n</DoDont>\n<DoDont type=\"dont\" caption=\"Don’t use more than one color within an icon.\">\n\n![](./assets/usage/14-idl-iconography-ui-icons-usage.png)\n\n</DoDont>\n</DoDontRow>\n\n## Third-party UI icons\n\nThird-party UI icons require permission from that third party before the icon can be used and added to our libraries. Requestors are responsible for securing permission. These icons may come in various styles and formats and must not be visually altered. However, they should be visually balanced with existing IBM UI icons to ensure consistency within interfaces.\n\n![](./assets/usage/15-idl-iconography-ui-icons-usage.png)\n\n### Alignment\n\nWhile most third-party icons don’t align perfectly to the icon grid, it’s important to align any icon artwork to the grid as best as possible. Center and align edges to grid divisions while respecting icon padding guidelines.\n\n<DoDontRow>\n<DoDont caption=\"Optically center icons and align them to the icon grid as best as possible.\">\n\n![](./assets/usage/16-idl-iconography-ui-icons-usage.png)\n\n</DoDont>\n<DoDont type=\"dont\" caption=\"Don’t left align, right align, top align or bottom align logos.\">\n\n![](./assets/usage/17-idl-iconography-ui-icons-usage.png)\n\n</DoDont>\n</DoDontRow>\n<DoDontRow>\n<DoDont caption=\"Use the padding for optical centering.\">\n\n![](./assets/usage/18-idl-iconography-ui-icons-usage.png)\n\n</DoDont>\n<DoDont type=\"dont\" caption=\"Don’t place logos in the padding unless absolutely necessary.\">\n\n![](./assets/usage/19-idl-iconography-ui-icons-usage.png)\n\n</DoDont>\n</DoDontRow>\n\n## UI icons in action\n\n<Video src=\"./assets/usage/20-idl-iconography-ui-icons-usage-v2.mp4\" />\n\n<ImageGallery>\n<ImageGalleryImage col={4}>\n\n![](./assets/usage/21-idl-iconography-ui-icons-usage.png)\n\n</ImageGalleryImage>\n<ImageGalleryImage col={8}>\n\n![](./assets/usage/22-idl-iconography-ui-icons-usage.png)\n\n</ImageGalleryImage>\n<ImageGalleryImage col={12}>\n\n![](./assets/usage/23-idl-iconography-ui-icons-usage.png)\n\n</ImageGalleryImage>\n<ImageGalleryImage col={8}>\n\n![](./assets/usage/24-idl-iconography-ui-icons-usage.png)\n\n</ImageGalleryImage>\n<ImageGalleryImage col={4}>\n\n![](./assets/usage/25-idl-iconography-ui-icons-usage.png)\n\n</ImageGalleryImage>\n<ImageGalleryImage col={4}>\n\n![](./assets/usage/26-idl-iconography-ui-icons-usage.png)\n\n</ImageGalleryImage>\n<ImageGalleryImage col={8}>\n\n![](./assets/usage/27-idl-iconography-ui-icons-usage.png)\n\n</ImageGalleryImage>\n</ImageGallery>\n","type":"Mdx","contentDigest":"05a67f8b9d03a59ae41601f9733015c5","owner":"gatsby-plugin-mdx","counter":1940},"frontmatter":{"title":"UI icons","description":"Icons are important aids to the user experience. Employ icons strategically with careful view to sizing, alignment, clearance and color in usage.","tabs":["Library","Design","Usage","Contribute"]},"exports":{},"rawBody":"---\ntitle: UI icons\ndescription:\n  Icons are important aids to the user experience. Employ icons strategically\n  with careful view to sizing, alignment, clearance and color in usage.\ntabs: [Library, Design, Usage, Contribute]\n---\n\nimport Carousel from \"../../../components/Carousel\"\n\n<PageDescription>\n\nIconography is highly functional in a user interface. When used wisely, icons become an elegant, yet efficient, way to communicate with and help guide a user through an experience. To maintain this functionality, it’s important to reduce cognitive load on users by employing icons sparingly and strategically throughout your designs.\n\n</PageDescription>\n\n<Row style=\"{margin-left: 0}\">\n<Column colMd={4} colLg={4}>\n<AnchorLinks>\n  <AnchorLink>Sizing</AnchorLink>\n  <AnchorLink>Alignment</AnchorLink>\n  <AnchorLink>Clearance</AnchorLink>\n  <AnchorLink>Color</AnchorLink>\n</AnchorLinks>\n</Column>\n\n<Column colMd={5} colLg={5}>\n<AnchorLinks>\n  <AnchorLink>Third-party UI icons</AnchorLink>\n  <AnchorLink>UI icons in action</AnchorLink>\n</AnchorLinks>\n</Column>\n</Row>\n\n## Sizing\n\nIcons have been designed to work best in four sizes: 16px, 20px, 24px and 32px. Be sure to use icons at their originally produced size. These icons are provided in SVG format or can be used directly from the Figma, Carbon and IBM Design Language libraries.\n\n| Icon size                                     | Stroke width | Padding | Live area | Corner radius | Type sizes |\n| --------------------------------------------- | ------------ | ------- | --------- | ------------- | ---------- |\n| 32px                                          | 2px          | 2px     | 28px      | 2px           | —          |\n| 24px                                          | 1.5px        | 1.5px   | 21px      | 1.5px         | —          |\n| <span class=\"footnote__highlight\">20px</span> | 1.25px       | 1.25px  | 17.5px    | 1.25px        | 16pt       |\n| <span class=\"footnote__highlight\">16px</span> | 1px          | 1px     | 14px      | 1px           | 14pt       |\n\n<Caption>\n  <span class=\"footnote__highlight\" />\n  <span class=\"footnote\">\n    16px and 20px icons are optimized to feel balanced when paired with 14pt and\n    16pt IBM Plex. Use 24px and 32px when larger icons are needed.\n  </span>\n</Caption>\n\n![](./assets/usage/01-idl-iconography-ui-icons-usage.png)\n\n<DoDontRow>\n<DoDont caption=\"Use the correct icon size with IBM Plex®.\">\n\n![](./assets/usage/02-idl-iconography-ui-icons-usage.png)\n\n</DoDont>\n<DoDont type=\"dont\" caption=\"Don’t alter icon sizes.\">\n\n![](./assets/usage/03-idl-iconography-ui-icons-usage.png)\n\n</DoDont>\n</DoDontRow>\n<DoDontRow>\n<DoDont caption=\"Center-align icons when they’re next to text.\">\n\n![](./assets/usage/04-idl-iconography-ui-icons-usage.png)\n\n</DoDont>\n<DoDont type=\"dont\" caption=\"Don’t baseline align icons to the text.\">\n\n![](./assets/usage/05-idl-iconography-ui-icons-usage.png)\n\n</DoDont>\n</DoDontRow>\n\n## Alignment\n\nIcons are optically aligned to the center of the icon grid within the boundary box. Centering ensures all icons will be aligned correctly when exported and used side by side in a line or a row. Visually center an icon where the visual weight is heaviest. In some situations, mechanically centering doesn’t work.\n\n<Carousel carouselLabel=\"Alignment\" style={{marginTop: \"2rem\"}}>\n\n![](./assets/usage/06-idl-iconography-ui-icons-usage.png)\n\n![](./assets/usage/07-idl-iconography-ui-icons-usage.png)\n\n</Carousel>\n\n## Clearance\n\nWhen designing icons for touch surfaces, all targets should be 44px or greater. The icon can be smaller than 44px if padding is added to the touch target with cascading style sheets (CSS) to meet the 44px minimum.\n\n![](./assets/usage/08-idl-iconography-ui-icons-usage.png)\n\n<DoDontRow>\n<DoDont caption=\"Follow the clearance rule to allow for legibility and an optimal touch experience.\">\n\n![](./assets/usage/09-idl-iconography-ui-icons-usage.png)\n\n</DoDont>\n<DoDont type=\"dont\" caption=\"Don’t collapse the icon clearance area.\">\n\n![](./assets/usage/10-idl-iconography-ui-icons-usage.png)\n\n</DoDont>\n</DoDontRow>\n\n## Color\n\nIcons are always a solid, monochromatic color and must pass the same color contrast ratio as typography (4.5:1). The color of the icon should reflect the importance of the icon’s action, which should always be to help guide a user. For more information about color, see [Color in UI](https://carbondesignsystem.com/elements/icons/usage/#color).\n\n<DoDontRow>\n<DoDont caption=\"Match your icon color with your text color when pairing them.\">\n\n![](./assets/usage/11-idl-iconography-ui-icons-usage.png)\n\n</DoDont>\n<DoDont type=\"dont\" caption=\"Don’t use different colors for text and icons.\">\n\n![](./assets/usage/12-idl-iconography-ui-icons-usage.png)\n\n</DoDont>\n</DoDontRow>\n<DoDontRow>\n<DoDont caption=\"Make icons monotone.\">\n\n![](./assets/usage/13-idl-iconography-ui-icons-usage.png)\n\n</DoDont>\n<DoDont type=\"dont\" caption=\"Don’t use more than one color within an icon.\">\n\n![](./assets/usage/14-idl-iconography-ui-icons-usage.png)\n\n</DoDont>\n</DoDontRow>\n\n## Third-party UI icons\n\nThird-party UI icons require permission from that third party before the icon can be used and added to our libraries. Requestors are responsible for securing permission. These icons may come in various styles and formats and must not be visually altered. However, they should be visually balanced with existing IBM UI icons to ensure consistency within interfaces.\n\n![](./assets/usage/15-idl-iconography-ui-icons-usage.png)\n\n### Alignment\n\nWhile most third-party icons don’t align perfectly to the icon grid, it’s important to align any icon artwork to the grid as best as possible. Center and align edges to grid divisions while respecting icon padding guidelines.\n\n<DoDontRow>\n<DoDont caption=\"Optically center icons and align them to the icon grid as best as possible.\">\n\n![](./assets/usage/16-idl-iconography-ui-icons-usage.png)\n\n</DoDont>\n<DoDont type=\"dont\" caption=\"Don’t left align, right align, top align or bottom align logos.\">\n\n![](./assets/usage/17-idl-iconography-ui-icons-usage.png)\n\n</DoDont>\n</DoDontRow>\n<DoDontRow>\n<DoDont caption=\"Use the padding for optical centering.\">\n\n![](./assets/usage/18-idl-iconography-ui-icons-usage.png)\n\n</DoDont>\n<DoDont type=\"dont\" caption=\"Don’t place logos in the padding unless absolutely necessary.\">\n\n![](./assets/usage/19-idl-iconography-ui-icons-usage.png)\n\n</DoDont>\n</DoDontRow>\n\n## UI icons in action\n\n<Video src=\"./assets/usage/20-idl-iconography-ui-icons-usage-v2.mp4\" />\n\n<ImageGallery>\n<ImageGalleryImage col={4}>\n\n![](./assets/usage/21-idl-iconography-ui-icons-usage.png)\n\n</ImageGalleryImage>\n<ImageGalleryImage col={8}>\n\n![](./assets/usage/22-idl-iconography-ui-icons-usage.png)\n\n</ImageGalleryImage>\n<ImageGalleryImage col={12}>\n\n![](./assets/usage/23-idl-iconography-ui-icons-usage.png)\n\n</ImageGalleryImage>\n<ImageGalleryImage col={8}>\n\n![](./assets/usage/24-idl-iconography-ui-icons-usage.png)\n\n</ImageGalleryImage>\n<ImageGalleryImage col={4}>\n\n![](./assets/usage/25-idl-iconography-ui-icons-usage.png)\n\n</ImageGalleryImage>\n<ImageGalleryImage col={4}>\n\n![](./assets/usage/26-idl-iconography-ui-icons-usage.png)\n\n</ImageGalleryImage>\n<ImageGalleryImage col={8}>\n\n![](./assets/usage/27-idl-iconography-ui-icons-usage.png)\n\n</ImageGalleryImage>\n</ImageGallery>\n","fileAbsolutePath":"/home/runner/work/design-language-website/design-language-website/src/pages/iconography/ui-icons/usage.mdx"}}},
    "staticQueryHashes": ["1364590287","137577622","2102389209","2456312558","2746626797","2881613939","3037994772","768070550"]}