Include a font icon in a single widget

  • リリースバージョン: Australia
  • 更新日 2026年03月12日
  • 所要時間：3分

    • If you only want one widget to have access to a font icon, include the font icon in a single widget.

    始める前に

    Role required: admin or sp_admin

    このタスクについて

    Adding an icon to a specific widget keeps the icon scoped and prevents it from interfering with other CSS on the page.

    手順

    1. In the platform UI, navigate to Service Portal > Widgets, then click the widget you want to add an icon to.
    2. Attach the individual icon file to the widget record.
    3. In the HTML template, include something like the following: 
      <div>
<i class='font-family'>icon_name</i> you did it!
</div>

      Make sure that the class is exactly the same as the font family called out in the CSS. For example, <i class='material-icons'> should be the same as the .material-icons included in the CSS. The icon_name should match the name of the file you attached.

    4. In the CSS field for the widget, add the CSS for the font-icon definition.

      Most font-icon sets include a CSS file similar to the material icons one used below. Use the sys_id of the attachment as the src in the CSS. For example:

      /* fallback */
@font-face {
  font-family: 'Material Icons';
  font-style: normal;
  font-weight: 400;
  src: url('/828b8ca8b7033010897725cbde11a9f7.iix') format('woff2');
}

.material-icons {
  font-family: 'Material Icons';
  font-weight: normal;
  font-style: normal;
  font-size: 24px;  /* Preferred icon size */
  display: inline-block;
  line-height: 1;
  text-transform: none;
  letter-spacing: normal;
  word-wrap: normal;
  white-space: nowrap;
  direction: ltr;

  /* Support for all WebKit browsers. */
  -webkit-font-smoothing: antialiased;
  /* Support for Safari and Chrome. */
  text-rendering: optimizeLegibility;

  /* Support for Firefox. */
  -moz-osx-font-smoothing: grayscale;

  /* Support for IE. */
  font-feature-settings: 'liga';
}

    タスクの結果

    An icon that you can select in the widget or widget instance. For example:

    Example icon that matches the HTML in the widget example, with a check circle that says "you did it!"

    次のタスク

    To use custom font-icons across widgets, add the icon to a page or make it a widget dependency.