Skip to main content


         This documentation site is for previous versions. Visit our new documentation site for current releases.      
 

Replacing the icon font in imported applications

Updated on March 3, 2022

Ensure that your mobile app is displayed properly with the Mobile – Slide Up layout, by replacing the font for icons on the header or the bottom bar. Complete this procedure when the UI Kit in your application is in an earlier version than version 14, and you do not add the latest UI Kit to your application stack.

Icons in native components of Pega Mobile Client derive glyphs from a font file in the true type font (.ttf) format that is embedded in the mobile app executable file. Pega Platform stores font settings for Pega Mobile Client in the pyMobileFontsList file. When you import a mobile app that uses UI Kit in a version that is earlier than version 14, icons in the imported app derive glyphs from a font file in the .woff format, and the pyMobileFontsList file is missing from the app definition. Therefore, if you import applications from previous Pega Platform releases without upgrading to UI Kit from a version earlier than 14, convert and replace the icon font to avoid displaying incorrect icons in your mobile app.
  1. Download the .woff font files with icons, and then convert them to the .ttf format.
  2. Upload the font files.
    For more information, see Uploading custom font files.
  3. In the context of your application, manually create an empty pyMobileFontsList file.
  4. Modify the fonts list.
Result: The uploaded icon font overrides the default font for icons on the header or the bottom bar of your mobile app. You can now generate the mobile app distributable files that include the icon font. For more information, see Building mobile apps.
  • Converting the icon font for imported applications

    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.

  • Uploading custom font files

    Ensure that your user interface meets the branding requirements of your company by adding new fonts to Pega Platform. Your custom font files can comprise standard fonts or icon fonts, which you can then add to the default icon set for your application.

  • Creating the font settings file for imported applications

    To ensure that your imported mobile app is displayed properly with the Mobile – Slide Up layout, you customize the icon font for the native elements of your mobile app. After you upload the converted font file, create an empty text file for font settings.

  • Modifying the font settings file for imported applications

    To ensure that your imported mobile app is displayed properly with the Mobile – Slide Up layout, you customize the icon font for the native elements of your mobile app. After you create an empty font settings file, modify the fonts list.

  • Previous topic Modifying the application skin for font customization
  • Next topic Converting the icon font for imported applications

Have a question? Get answers now.

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

Did you find this content helpful?

Want to help us improve this content?

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

Pega.com is not optimized for Internet Explorer. For the optimal experience, please use:

Close Deprecation Notice
Contact us