An adaptive icon, or
can display differently depending on individual device capabilities and user
theming. Adaptive icons are primarily used by the launcher on the home screen,
but they can also be used in shortcuts, the Settings app, sharing dialogs, and
the overview screen.
An adaptive icon can adapt to different use cases:
Different shapes: an adaptive icon can display a variety of shapes across different device models. For example, it can display a circular shape on one OEM device, and display a squircle (a shape between a square and a circle) on another device. Each device OEM must provide a mask, which the system uses to render all adaptive icons with the same shape.
Visual effects: an adaptive icon supports a variety of engaging visual effects, which display when users place or move the icon around the home screen.
User theming: starting with Android 13 (API level 33), users can theme their adaptive icons. If a user enables themed app icons, by turning on the Themed icons toggle in system settings, and the launcher supports this feature, the system uses the coloring of the user's chosen wallpaper and theme to determine the tint color.
In the following scenarios, the home screen doesn't display the themed app icon, and instead displays the adaptive or standard app icon:
- If the user doesn't enable themed app icons.
- If your app doesn't provide a monochromatic app icon.
- If the launcher doesn't support themed app icons.
Design adaptive icons
To ensure that your adaptive icon supports different shapes, visual effects, and user theming, the design must meet the following requirements:
You must provide two layers for the color version of the icon: one for the foreground, and one for the background.
If you want to support user theming of app icons, provide a single layer for the monochrome version of the icon.
Size all layers to 108x108 dp.
Use icons with clean edges. The layers must not have masks or background shadows around the outline of the icon.
Use a logo that's at least 48x48 dp. It must not exceed 72x72 dp, because the inner 72x72 dp of the icon appears within the masked viewport.
The outer 18 dp on each of the four sides of the layers is reserved for masking and to create visual effects such as parallax or pulsing.
To learn how to create adaptive icons using Android Studio, see our Android App icon Figma template or Android Studio documentation for creating launcher icons. Also, check out the blog post Designing Adaptive Icons .
Add your adaptive icon to your app
To add an adaptive icon to your app, update the
android:icon attribute in your
app manifest to specify a drawable resource. You can also define an icon
drawable resource using the
android:roundIcon attribute, but only if you
require a different icon asset for circular masks—for example, if your
branding relies on a circular shape.
The following code snippet illustrates both of these attributes, but most apps
<application ... android:icon="@mipmap/ic_launcher" android:roundIcon="@mipmap/ic_launcher_round" ...> </application>
res/mipmap-anydpi-v26/ic_launcher.xml, create alternative drawable
resources in your app for backward compatibility with Android 8.0 (API level
26). Use the
<adaptive-icon> element to define the foreground, background, and
monochromatic layer drawables for your icons. The
<monochrome> inner elements support the
The following example shows how to define
<monochrome> elements inside
<?xml version="1.0" encoding="utf-8"?> ... <adaptive-icon xmlns:android="http://schemas.android.com/apk/res/android"> <background android:drawable="@drawable/ic_launcher_background" /> <foreground android:drawable="@drawable/ic_launcher_foreground" /> // Starting with Android 13 (API level 33), you can opt-in to providing a // <monochrome> drawable. <monochrome android:drawable="@drawable/ic_launcher_monochrome" /> </adaptive-icon> ...
You can also define drawables as elements by enclosing them in the
<monochrome> elements. The following
snippet shows an example of doing this with the foreground drawable.
<?xml version="1.0" encoding="utf-8"?> ... <foreground> <inset android:insetBottom="18dp" android:insetLeft="18dp" android:insetRight="18dp" android:insetTop="18dp"> <shape android:shape="oval"> <solid android:color="#0000FF" /> </shape> </inset> </foreground> ...
If you want to apply the same mask and visual effect to your shortcuts as regular adaptive icons, use one of the following techniques:
- For static shortcuts, use the
- For dynamic shortcuts, call the
createWithAdaptiveBitmap()method when you create them.
See the following resources for additional information about designing and implementing adaptive icons.
- Figma community page template
- Understanding Android Adaptive Icons
- Designing Adaptive Icons
- Implementing Adaptive Icons
- Google Play icon design specifications