How to set up your Expo app icon for iOS, Android and web
An Expo app needs one square icon for iOS, two or three layers for Android, a favicon and a splash image. Here is what each file is and where it goes in app.json.
Updated 10 November 2026 · Checked against Apple, Google and Expo docs
The files you need
| File | What it should be | app.json key |
|---|---|---|
icon.png | 1024 × 1024 PNG, square, opaque, no rounded corners | icon |
adaptive-icon.png | Your logo on a transparent square, kept inside the centre safe zone | android.adaptiveIcon.foregroundImage |
| Background | A colour, or an image the same size as the foreground | backgroundColor or backgroundImage |
monochrome-icon.png | A single-colour version of the logo on transparent | android.adaptiveIcon.monochromeImage |
favicon.png | A small PNG for the web build (48 × 48 is common) | web.favicon |
splash-icon.png | 1024 × 1024 PNG with a transparent background | expo-splash-screen plugin image |
Expo generates every smaller size from these when it builds the app.
The app.json lines
{
"expo": {
"icon": "./assets/images/icon.png",
"android": {
"adaptiveIcon": {
"foregroundImage": "./assets/images/adaptive-icon.png",
"backgroundColor": "#1E3A5F",
"monochromeImage": "./assets/images/monochrome-icon.png"
}
},
"web": { "favicon": "./assets/images/favicon.png" },
"plugins": [
["expo-splash-screen", {
"image": "./assets/images/splash-icon.png",
"imageWidth": 200,
"resizeMode": "contain",
"backgroundColor": "#1E3A5F"
}]
]
}
}
android.adaptiveIconoverrides the top-leveliconon Android.backgroundColordefaults to white.- If your background is a gradient or texture, use
backgroundImageinstead of only a colour. It must be the same size as the foreground. - For separate iOS dark and tinted icons,
ios.icontakes an object withlight,darkandtintedpaths, or from SDK 54 a path to an Icon Composer.iconfile. - The splash plugin also accepts a
darkobject with its ownimageandbackgroundColor.
For the iOS side, see dark, clear and tinted iOS icons.
Getting the Android foreground right
Android draws your foreground over the background and then crops both to the phone maker’s shape: a circle, a squircle or a rounded square. On a 1024 px foreground, only the centre circle of about 626 px (66 of Android’s 108 dp) is guaranteed to show. Keep your logo inside it, and at least about 455 px (48 dp) wide so it doesn’t look lost.
The most common mistake is using the full iOS icon, background and all, as the foreground. The result is a small square sitting inside a circle. The foreground should be the logo alone on transparent. Our Android adaptive icon guide has the full sizes.
Why your new icon doesn’t show up
- Expo Go shows its own icon. Your icon only appears in a development, preview or production build of your app.
- Icons are native. Changing
app.jsonneeds a new native build, for examplenpx expo run:ios,npx expo run:androidor your usual EAS build. An over-the-air update can’t change the icon. - Committed native folders. If your project keeps
ios/andandroid/in git, Expo only writes icons into them during prebuild, so runnpx expo prebuildagain (add--cleanif you’re happy to regenerate those folders). - Splash screens. Expo recommends checking the splash screen in a preview or production build, not Expo Go or a development build. Only PNG is supported.
- Launchers cache icons. On Android, uninstall the old build first if the launcher keeps showing the old icon.
Where Iconic Icons helps
Iconic Icons makes the icon from a sentence about your app (four options in about a minute, then changes in plain words) and its free export has an expo/ folder with exactly the files above:
icon.png: the opaque 1024 icon.adaptive-icon.pngandadaptive-icon-background.png: the mark on transparent and its background, sized for Android’s safe zone.monochrome-icon.pngfor themed icons, when the mark separates cleanly from its background.favicon.png(48 px) andsplash-icon.png.app.json.snippet.json: the lines above, filled in with your icon’s background colour (and the background image when it’s a gradient).
Copy the PNGs into assets/images/, merge the snippet into app.json, and rebuild.
Questions people ask
A 1024 × 1024 PNG: square, with no transparency and no rounded corners. Expo makes the smaller sizes when it builds the app.
Icons are part of the native build. Rebuild the app, and re-run npx expo prebuild if you keep the ios and android folders in git. Expo Go always shows its own icon, and over-the-air updates can’t change it.
The top layer of the Android adaptive icon: your logo on a transparent square, kept inside the centre safe zone, drawn over backgroundColor or backgroundImage.
Add android.adaptiveIcon.monochromeImage: a single-colour version of your logo on a transparent background. On Android 13 and later, the phone tints it to match the wallpaper when themed icons are on.
Yes. Its export has an expo folder with the icon, the adaptive layers, a monochrome layer when the mark separates cleanly, a favicon and a splash image, plus an app.json snippet.