Lion Logo Lion Fundamentals Guides Components Blog Toggle darkmode

Icon: Use Cases

Icon sets

Icons are displayed using icon sets. These are collections of icons, lazily loaded on demand for performance. See the system documentation to learn more about icon sets.

export const iconSets = () => html`
    name => html`
        .demo-icon__container {
          display: inline-flex;
          position: relative;
          flex-grow: 1;
          flex-direction: column;
          align-items: center;
          width: 80px;
          height: 80px;
          padding: 4px;
        .demo-icon__name {
          font-size: 10px;
      <div class="demo-icon__container">
        <lion-icon icon-id="lion:space:${name}" aria-label="${name}"></lion-icon>
        <span class="demo-icon__name">${name}</span>

If for some reason you don't want to lazy load icons, you can still import and use them synchronously.


It is recommended to add an aria-label to provide information to visually impaired users:

A lion-icon without an aria-label attribute will be automatically given an aria-hidden attribute.

export const accessibleLabel = () => html`
  <lion-icon icon-id="lion:misc:arrowLeft" aria-label="Pointing left"></lion-icon>


By default, a lion-icon will be 1em × 1em (the current line-height).

lion-icon uses SVGs and may be styled with CSS, including using CSS properties such as fill:

export const Styling = () => html`
    .demo-icon {
      width: 160px;
      height: 160px;
      fill: blue;
  <lion-icon icon-id="lion:bugs:bug02" aria-label="Bug" class="demo-icon"></lion-icon>

See SVG and CSS on MDN web docs for more information.