All system icons are inline SVG files, invoked via a Razor helper. The helper will insert a properly formatted and minified SVG file into your view. All icons are managed and stored within the Icons repository.

Using the icon helper

The SVG Razor helper function should be used for all system icons in lieu of SVG sprite sheets or raster image assets. This ensures a single source of truth for all icons. The SVG helper is invoked by @Svg. and then adding the icon name, like so:

<div class="example">

By default, every icon will inherit the text color of its parent. To override this and show the icon with its native colors (Our logos, for example), you can include the native class in the helper.

<div class="example">

In fact, our helper supports arbitrary classes as well.

<div class="example">
  @Svg.Logo.With("native js-dropdown-target another-class-name")
Note: Our @Svg helper isn’t available within our documentation. You can call SVGs using our custom Icon liquid tag: {% icon Search | optional additional classes | pixel dimension %}

Requesting an icon

If an icon you need isn’t here, please do one of the following two options:

  1. Submit a request outlining the desired icon, the icon’s intended purposed, and where it will be used.
  2. If the icon is ready, submit a pull request to have it to be reviewed. Please be sure to provide the same information as above.

If you have further questions, visit the project’s Slack channel: #stacks.

Icon set