--- title: "Icon customization" slug: "mas-5-ig-icon-customization-5-8-0" updated: 2026-08-28T08:53:12Z published: 2026-08-28T08:53:12Z canonical: "docs.onespan.com/mas-5-ig-icon-customization-5-8-0" --- > ## Documentation Index > Fetch the complete documentation index at: https://docs.onespan.com/llms.txt > Use this file to discover all available pages before exploring further. # Icon customization You can customize the Mobile Authenticator Studio app's different types of icons: - [launcher icon](/mobile/docs/mas-5-ig-icon-customization-5-8-0#launcher-icon) - [notification icon](/mobile/docs/mas-5-ig-icon-customization-5-8-0#notification-icon) - [splash screen icon](/mobile/docs/mas-5-ig-icon-customization-5-8-0#customization-of-the-splash-screen-icon) To customize the icon(s), you create an image in the required format and upload the image files on the [Mobile Authenticator Studio Portal](https://mobile.onespan.com/mas). For detailed instructions how to build and customize the app, see the [Mobile Authenticator Studio Portal documentation](/mobile/docs/mobile-authenticator-studio-portal). > With the exception of the PNG launcher icon for Android on versions prior to Android 8, the customization of any of the icons is optional. However, to ensure compatibility with different devices and Android versions, we recommend customizing the launcher and splash screen icons and use adaptive icons in SVG format. The specifications for customization of the different icon types vary, see the sections below for more information. ## Launcher icon The launcher icon is displayed on the device dashboard. ### iOS To customize the launcher and / or navigation icons on iOS, create a PNG file in square mode, 1024x1024 px, for upload in the Mobile Authenticator Studio Portal. For more information about app icons on iOS, refer to the [iOS developer documentation](https://developer.apple.com/design/human-interface-guidelines/app-icons). ### Android Android supports two types of app icons: legacy PNG and adaptive SVG icons. An adaptive icon consists of two layers, foreground and background, each defined in a separate SVG file. This type of icon can display a variety of shapes across different device models. While adaptive icons are the new standard on Android 8.0 and later, a PNG icon is still needed to support versions prior to Android 8.0. For more information about Android adaptive icons, refer to the [Android developer documentation on adaptive icons](https://developer.android.com/develop/ui/views/launch/icon_design_adaptive). A legacy PNG icon does not have a foreground, and background resources can have any shape. Any PNG files you use must be in the highest available resolution. However, we recommend using SVG files instead. > Legacy PNG icons are required for all versions prior to Android 8. For the customization of the Mobile Authenticator Studio launcher icon, you must always provide a legacy PNG icon. If no adaptive SVG icons are provided, the legacy PNG icons will be used instead across all Android versions. If adaptive SVG icons are provided, they will be used by default on supported system versions, while the legacy PNG icon will serve as fallback on devices running Android versions earlier than 8.0 which do not support adaptive icons. #### Specifications for launcher icons The following table provides the required customization keys and dimensions for each type of launcher icon on Android. | Parameters | Adaptive SVG icons | Legacy PNG icons | | --- | --- | --- | | Customization keys | `launcherAdaptiveIconForeground` `launcherAdaptiveIconBackground` | `launcherIcon` | | Dimensions | - Size: 108x108 dp Both layers must have this size! - Logo size minimum: 48x48 dp - Logo size maximum: 66x66 dp This is the safe zone which will not be clipped by a mask. The exact dimension of the mask depends on the device's OEM and determines the final shape which an icon will display (i.e. circular or rounded square). | - Between 48x48 px and 192x192 px We recommend 192x192 px to cover the highest possible screen densities. | ### Special considerations for adaptive SVG icons - The foreground and background layers are stacked on top of each other. The foreground layer may include transparency, while the background layer must be completely opaque. - Usually a logo is placed in the foreground layer but this is not a requirement. Placing elements in different layers gives you the opportunity to create advanced visual effects. - Use clean edges. The layers should not have masks or background shadows around the outline. - The generated launcher icon can be of a poor quality (scale up or down depending on the device resolution, which can lead to a blurry icon). The background of the icon will be white. ### Customization examples On devices running Android 8.0 and later, a launcher icon will be created from the ic_launcher_background.svg and ic_launcher_foreground.svg files, on devices running Android 7.1 and lower, ic_launcher.png will be used as a launcher icon. 1. Customization using adaptive SVG icons ```plaintext "assets": {   "android": {      "launcherIcon": "android/icons/ic_launcher.png",      "launcherAdaptiveIconBackground": "android/icons/ic_launcher_background.svg",      "launcherAdaptiveIconForeground": "android/icons/ic_launcher_foreground.svg",   } } ``` 2. Customization using legacy PNG icons ```plaintext "assets": {   "android": {      "launcherIcon": "android/icons/ic_launcher.png",   } } ``` ## Notification icon The notification icon is displayed for notifications. On Android, you can also customize the icon to use for push notifications from the Mobile Authenticator Studio app. Add the customized icon as PNG or SVG file to the customization of your integration. If you do not provide a file for customization, Mobile Authenticator Studio displays the launcher icon. #### Specifications for the notification icon The following table provides the required customization keys and dimensions for each type of the notification icon on Android. | Parameters | SVG icon | Legacy PNG icon | | --- | --- | --- | | Customization keys | `notificationIcon` | `notificationIcon` | | Dimensions | - Size: 108x108 dp | - Between 48x48 px and 192x192 px We recommend 192x192 px to cover the highest possible screen densities. | ## Splash screen icon The splash screen is briefly displayed at app start. In Mobile Authenticator Studio, it consists of two elements: - A static app icon in an SVG format. If you do not provide a separate static app icon, the launcher icon will be used by default. - Window background The window background color is a HEX value representing a plain color, which must be a single opaque color. Define this value in the customization file you upload in the OneSpan Mobile Authenticator Studio Portal. The customization key attribute is `splashScreen`. The implementation and customization of a splash screen icon is optional but recommended. ### iOS On iOS, the splash screen must be an SVG file. For more information about icons on iOS, refer to the [iOS developer documentation](https://developer.apple.com/design/human-interface-guidelines/app-icons). ### Android On Android, if you do not provide an SVG file for the splash screen, the launcher icon is automatically used as a fallback. This may have different visual effects depending on what was used for the launcher icon: - If an adaptive SVG icon is used, the splash screen will be displayed correctly. - If a legacy PNG icon is provided, the splash screen might appear slightly blurred, depending on the quality of the PNG used. #### Specifications for the splash screen icon - Customization key: `splashScreen` - Dimensions: 288x288 dp. The icon must fit within a circle 192 dp in diameter. Everything outside the circle will become invisible (masked). Animations are not supported in Mobile Authenticator Studio. For more information and best practices regarding splash screens on Android, refer to the [Android developer documentation on splash screens](https://developer.android.com/develop/ui/views/launch/splash-screen).