Guide

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

FileWhat it should beapp.json key
icon.png1024 × 1024 PNG, square, opaque, no rounded cornersicon
adaptive-icon.pngYour logo on a transparent square, kept inside the centre safe zoneandroid.adaptiveIcon.foregroundImage
BackgroundA colour, or an image the same size as the foregroundbackgroundColor or backgroundImage
monochrome-icon.pngA single-colour version of the logo on transparentandroid.adaptiveIcon.monochromeImage
favicon.pngA small PNG for the web build (48 × 48 is common)web.favicon
splash-icon.png1024 × 1024 PNG with a transparent backgroundexpo-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.adaptiveIcon overrides the top-level icon on Android. backgroundColor defaults to white.
  • If your background is a gradient or texture, use backgroundImage instead of only a colour. It must be the same size as the foreground.
  • For separate iOS dark and tinted icons, ios.icon takes an object with light, dark and tinted paths, or from SDK 54 a path to an Icon Composer .icon file.
  • The splash plugin also accepts a dark object with its own image and backgroundColor.

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.json needs a new native build, for example npx expo run:ios, npx expo run:android or your usual EAS build. An over-the-air update can’t change the icon.
  • Committed native folders. If your project keeps ios/ and android/ in git, Expo only writes icons into them during prebuild, so run npx expo prebuild again (add --clean if 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.png and adaptive-icon-background.png: the mark on transparent and its background, sized for Android’s safe zone.
  • monochrome-icon.png for themed icons, when the mark separates cleanly from its background.
  • favicon.png (48 px) and splash-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.

Sources