Skip to main content
close Search
Close search

Customizing the image assets of mobile apps

Pega Community logo

Note: The following content, referenced from Pega Community, is included here to help you better achieve the module learning objectives.

Match the icons in your mobile app with the branding requirements of your company or project by replacing the default image assets with a set of custom graphics.

By uploading your custom assets in a single .zip file, you can customize the icons that appear on the home screen and on the launch screen when the mobile app starts.
Before you begin: Create a mobile channel for your mobile app. For more information, see Setting up mobile apps.

Note: Perform this procedure only in the following scenarios:
  • To specify different icons for iOS and Android apps.
  • To upload icon images in a format other than the default SVG format, for example, .png.
  • To upload icon images in a resolution other than the recommended 512 x 512 pixels.
  • For Android apps, to upload a custom notification icon for the status bar of your mobile app.

Otherwise, customize the icon and launch screen of your mobile app in a low-code environment. For more information, see Customizing the icon and launch screen of mobile apps.

Note: When you replace the default image files in the assets .zip file, ensure that you keep the directory structure, file names, and image dimensions of your custom assets .zip file identical to the setup in the default .zip file. If a specific image asset is missing in your custom assets .zip file, the operating system of the mobile device rescales the existing assets (Android), or replaces the missing assets with the system-default resources (iOS).
  1. Download the simplified assets .zip file that matches your version of Pega Mobile Client.

    For more information, see Branding assets templates for Pega Mobile Client.

  2. Extract the contents of the .zip file.

  3. Replace the image assets in the folders that you extracted from the .zip file to customize any of the following graphics:

    Choices Actions
    Mobile app icon (iOS)
    1. Open the common_assets folder, and then replace the icon.svg file with the image file that you want to use.

      Note: If you plan to publish your mobile app in the Apple App Store, use a rectangular icon. iOS mobile devices also rescale the icon.svg file and use it as an icon to display notifications on the status bar of your mobile app.
    Mobile app icon (Android)
    1. Open the common_assets folder, and then replace the icon.svg file with the image file that you want to use.

    2. Open the android folder, and then replace the icon_round.svg file with the image file that you want to use.

      Note: Use a circular icon. Android devices that support circular launcher icons use the icon_round.svg file instead of the icon.svg file as the app icon.
    3. Open the android folder, and then replace the notification_icon.svg file with the image file that you want to use.

      Android mobile devices use this icon to display notifications on the status bar of your mobile app.

      Note: Use an icon that matches the following requirements:
      • Image format – 32-bit .png (with alpha)
      • Transparent image
      • Transparency Color Index – White (#FFFFFF)
    Splash screen logo (iOS) Open the ios folder, and then replace the splashlogo@3x.png file with the image file that you want to use.
    Splash screen logo (Android) Open the android/drawable-resolution folder for each resolution of the target mobile device that you want to support, and then replace the splashlogo.png file with the image file that you want to use.
  4. Select the folders that you extracted from the .zip file that now contain your custom assets, and then compress them into a single .zip file.

  5. Open your mobile channel:

    1. In the navigation pane of App Studio, click Channels.

    2. In the Current channel interfaces section, click the tile that represents a mobile channel for your app.

  6. On the mobile channel page, on the Layout tab, click Branding.

  7. In the Branding section, click the Configure advanced branding icon, and then select the Advanced Branding check box.

  8. In the Upload custom branding file section, click Choose file, and then select the .zip file that contains your custom assets.

  9. Confirm your selection by clicking OK.

  10. Click Save.

Note: At run time, your mobile app now uses the custom image assets from the .zip assets file that you uploaded in the mobile channel.
Note: Verify the changes to your mobile app by generating, installing, and launching the app. For more information, see Generating native mobile apps.
If you are having problems with your training, please review the Pega Academy FAQs.

Did you find this content helpful?

Want to help us improve this content?

Suggest an edit

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

Pega Academy 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