Skip to main content

Table of Contents

Converting the icon font for imported applications


Only available versions of this content are shown in the dropdown

Convert the font files that contain application icons to ensure that the mobile app is displayed properly with the Mobile – Slide Up layout, when you do not add the latest UI Kit to your application stack.

When you upgrade Pega Platform or import applications from previous Pega Platform releases, upgrade the UI Kit to the most recent version, to avoid displaying incorrect icons in your mobile app. However, if you choose not to upgrade to the latest UI Kit, convert your icon font to the .ttf format, and then upload the font to Pega Platform. For more information about upgrading applications, see Performing application validation after upgrades.

  1. Determine the font that the application uses by displaying the CSS file of the skin rule for the application:

    1. In the header of Dev Studio, click the name of the application, and then click Skin.

    2. Expand the Actions menu, and then click Preview JSON.

    3. Look for a snippet of code that contains the font family attribute.

      @font-face {
          font-family: "UIKitIcons";
          src: url("webwb/uikit-icons.woff2?") format("woff2"), url("webwb/uikit-icons.woff?") format("woff");
  2. In the navigation pane of Dev Studio, click Records Technical Binary File .

  3. In the list of instances, search for and open the woff binary file that corresponds to the icon font for your application.

  4. On the Binary File form, click Download file, and then download the .woff file with the icon font for your application.

  5. Save the values of two parameters:

    1. Determine and note down the path to the CSS file of the skin rule for the application, for example, webwb/py-icons.css.

    2. Display the metadata of the font file by opening the file with a tool of your choice, and then note down the value of the fontFamily parameter, for example, pega-uik-13.

    You need these parameters to customize the fonts.
  6. Convert the .woff file to the .ttf format by using a tool of your choice.

Upload the font files to Pega Platform. For more information, see Uploading custom font files.
Suggest Edit
Did you find this content helpful?

Have a question? Get answers now.

Visit the Collaboration Center to ask questions, engage in discussions, share ideas, and help others.

Ready to crush complexity?

Experience the benefits of Pega Community when you log in.

We'd prefer it if you saw us at our best.

Pega Community has detected you are using a browser which may prevent you from experiencing the site as intended. To improve your experience, please update your browser.

Close Deprecation Notice
Contact us