Skip to content

Apple touch icons and home screen icons

Last checked 19 November 2026

Someone saves your site to their phone, and the new shortcut shows a small picture of your home page instead of a logo. That's what a missing touch icon looks like on an Apple device.

How the home screen icon gets chosenVisitor taps Add to Home ScreenPhone looks for a touch iconIcon file found: shown as the iconNo icon file: page thumbnail shown
No touch icon means a page thumbnail on an Apple device.

What happens without an icon

Wikipedia explains that for iOS to display the shortcut with an icon, the website needs to supply a link with rel="apple-touch-icon" in the head. If the custom icon isn't provided, a thumbnail of the web page goes on the home screen instead.1

Android is a little different. Wikipedia says that if no favicon is provided there, a generic icon is used.1

Fix one: name the file apple-touch-icon.png

Apple's older guide gives the easiest route. To set an icon for every page, place an icon file in PNG format in the root document folder called apple-touch-icon.png.2 The root folder is the top level of your site.

No HTML is needed for that. But you can add a line anyway, and it's the tidier habit:

<link rel="apple-touch-icon" href="/apple-touch-icon.png">

A note on dates. The Apple guide was last updated on 2016-12-12 and sits in Apple's documentation archive.2 Check Apple's current developer pages before relying on fine detail.

Fix two: give sizes to different devices

Apple's guide shows several link lines with a sizes attribute, for devices with different screens. The examples use 152x152 for iPad, 180x180 for iPhone with a Retina screen and 167x167 for iPad with a Retina screen.2 The file names in those examples say "retina", which refers to high-resolution screens.

If none match, there's a fallback. The guide says that if there is no icon that matches the recommended size for the device, the smallest icon larger than the recommended size is used.2 So when sizes don't match exactly, a larger icon is picked over a smaller one.

MDN offers a simpler view. It says it is usually sufficient to provide a large image, such as 192x192, and let the browser scale it down as needed.3

The text under the icon

The icon has a name beneath it. Apple's guide says you can specify a web application title for the launch icon, and that by default the title tag is used.2 The meta tag looks like this:

<meta name="apple-mobile-web-app-title" content="Your site name">

Android home screen icons

On Android, the Add to home screen option in Chrome pins a page to the home screen. Wikipedia says that as Android app icons are sized in 48x48 points, sites should provide favicons sized in multiples of 48x48 pixels. It also says Google recommends providing icons in 192x192 pixels for modern high resolution devices.1

A web app manifest is a small file that lists icons and other details. It isn't required for adding to the home screen.1 If you do write one, MDN says each icon needs only a src, the path to the image file.4

MDN also describes a maskable purpose for icons. It means the icon is designed with icon masks and a safe zone in mind, so the edges can be cut away.4 If you'd like your picture to survive trimming, keep the important part in the middle.

Check your work

Save your own site to a phone and look at the result. Then compare it with the tab icon you set up in the HTML link tag steps. They're separate files, so one can work while the other doesn't. If the old icon lingers, why your favicon isn't showing has the causes.

Notes and sources

  1. Favicon, Wikipedia
  2. Configuring Web Applications (Safari Web Content Guide, archive), Apple Developer Documentation Archive
  3. <link>: The External Resource Link element, MDN Web Docs
  4. icons, Web app manifest, MDN Web Docs