If you want to opt-in to supporting user theming of app icons, provide a An example of how foreground and background layers look together, with a circular mask applied. The 72 x 72 safe zone in the second image shows where your icon and foreground layers will never be clipped by a shaped mask defined by an OEM.įigure 5.

Adaptive icons defined using foreground and background layers. Provide two layers for the color version of the icon: one for theįoreground, and one for the background. User theming, the design must meet the following requirements: To ensure that your adaptive icon supports different shapes, visual effects, and Visual effects may vary from one launcher to another. Note: Animated visual effects are generated by supported launchers. Visual effects An adaptive icon supports a variety of engaging visualĮffects, which display when users place or move the icon around the Examples of visual effects displayed by an adaptive icon If the launcher doesn't support themed app icons Figure 2. If your app doesn't provide a monochromatic app icon.If the user hasn't enabled themed app icons.

The home screen does NOT display the themed app icon-and instead displays the adaptive or standard app icon-in any of the following scenarios: Launcher supports this feature, the system uses the coloring of the user’sĬhosen wallpaper and theme to determine the tint color.įigure 3: Adaptive icons inheriting from the user's wallpaper and themes Words, turned on the Themed icons toggle in system settings), and the If a user has enabled themed app icons (in other User themingStarting with Android 13 (API level 33), users can theme Must provide a mask, which the system uses to render all adaptive icons with On one OEM device, and display a squircle on another device. For example, it can display a circular shape Adaptive icons are primarily used by the launcher on the homescreen,īut can also be used in shortcuts, the Settings app, sharing dialogs, and theĪn adaptive icon can adapt to different use cases as follows:įigure 1: Adaptive icons support a variety of masks, which vary from one device to anotherĭifferent shapes An adaptive icon can display a variety of shapesĪcross different device models. Can display differently depending on individual device capabilities and user

Vector calendar icon