Skip to content

Apple touch icons and home screen icons

What icon appears when someone saves your site to a phone's home screen, how to set an Apple touch icon, and what Android does instead.

Reviewed 15 November 2026

When someone saves your site to a phone's home screen, the phone picks a picture. If you haven't supplied one, it makes its own choice. Here's how to take control, one platform at a time.

What happens with no icon

Two phones, two defaults.

  • On iOS, with no custom icon, the home screen gets a small thumbnail picture of your page instead1.
  • On Android, if no favicon is provided, a generic icon is used1.

Neither default is a picture you chose.

iOS: the Apple touch icon

Apple calls saved links Web Clips, shown as an icon2. Safari on iOS doesn't use the standard tab-icon link. MDN says iOS does not use that link type, nor the sizes attribute, and uses the non-standard apple-touch-icon instead3.

Setting a home screen icon for iOSMake a square PNGName it apple-touch-icon.pngUpload it to the site's root folderOr add a link tag on a page
The file name does the work if you use the root folder.

There are two ways to set it.

The whole site

Apple says to place an icon file in PNG format in the root document folder, called apple-touch-icon.png2. The root document folder is the top folder of your site. No HTML is needed for this route.

One page

To give a single page its own icon, add a link element to that page2:

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

Replace the file name with your own2.

Several sizes

To support different devices, add a sizes attribute to each link element, for example sizes="180x180"2. Use one link per file.

Wikipedia lists 152×152 for iPads up to the iPad 2, 167×167 for iPads with Retina screens (iPad 3 and later) and 180×180 for iPhones1. That's a reference page. Don't treat it as final. Apple's own guide sends readers to the iOS Human Interface Guidelines for current icon sizes and recommendations2.

How iOS chooses

Apple describes the rule in two lines.

  • If no icon matches the size the device wants, the smallest icon larger than that size is used2.
  • If no icon is larger, the largest icon is used2.

In practice, a larger square PNG gives the phone something to work down from.

Effects and shape

iOS changes the file you supply. Wikipedia says the icon file referenced by apple-touch-icon is modified to add rounded corners1. So don't draw your own rounded corners. Supply a full square.

Older versions of Safari add effects too. Apple says they won't add effects for files named with the -precomposed.png suffix2.

The name under the icon

The title is separate from the picture. By default the page's title tag is used2. Apple also describes a meta tag called apple-mobile-web-app-title that sets a different one2. Short titles fit better, so check what yours looks like.

Android and the web app manifest

  • Wikipedia says Android app icons are sized in 48x48 points, so websites should provide favicons in multiples of 48x48 pixels1.
  • For modern high-resolution devices, it says Google recommends 192x192 pixels1.
  • A web manifest is a JSON file with information about a web app, including its icons. In it, the icons member lists one or more image files that represent the app4.
  • Of each icon's properties, only src is required4.
  • A manifest isn't strictly needed. Wikipedia says providing one is not necessary for the "Add to home screen" feature to work1.

JSON is a plain text format for lists of settings. MDN says these icons show up in places like the home screen and app listings4.

Google also reads Apple touch icons

Google lists apple-touch-icon as a link value it supports, described as an iOS-friendly icon that represents your site5. The search page has more on that: Google's icon rules.

Before you rely on it

  • Apple's guide is an archive page, updated 2016-12-12 according to its footer. Check Apple's current documentation before relying on any size2.
  • Test by saving your own site to a phone's home screen.
  • Tab icon wrong as well? The troubleshooting list covers it.
  • Browser tab icons have their own set-up notes, on the add-a-favicon page.

References

  1. Favicon, Wikipedia
  2. Configuring Web Applications (Safari Web Content Guide), Apple Developer Documentation Archive
  3. rel attribute values (HTML attributes), MDN Web Docs, Mozilla
  4. icons (Web app manifest), MDN Web Docs, Mozilla
  5. Define a favicon to show in search results, Google Search Central