Skip to content

Apple Touch Icons and Home Screen Icons

Reviewed on 15 November 2026

When someone adds a page to an iPhone or iPad home screen, the device looks for an Apple touch icon. A normal favicon isn't what it asks for first. This page rests on Apple's Safari Web Content Guide, which sits in Apple's documentation archive and was last updated on 2016-12-121. Apple's current guidance on sizes may differ, so check it for your own icon.

What Apple calls it

Apple calls a home screen link a Web Clip. In its words, these links, represented by an icon, are called Web Clips1.

Two ways to name the icon

For the whole site. Place a PNG file called apple-touch-icon.png in the root document folder1. Apple says that sets an icon for every page on the website.

For one page. Add a link element to that page, such as <link rel="apple-touch-icon" href="/custom_icon.png">1.

Replace the file name with your own. This also lets a single page override the site-wide icon, according to Apple1.

Several sizes for several devices

Apple's guide shows link tags with a sizes attribute so that iPhone and iPad can each get a fitting icon. Its examples list 152x152, 180x180 and 167x167 files, plus one with no sizes attribute1. One of them reads <link rel="apple-touch-icon" sizes="180x180" href="touch-icon-iphone-retina.png">1.

Apple says the icon with the most appropriate size for the device is used. It sends readers to the iOS Human Interface Guidelines for current icon sizes1.

How Apple's page describes the lookupPage has link tags with sizesDevice picks the closest sizeNo link tags: root folder searchedIcon is used on the home screen
From the link tags to the file that gets used.

When no size matches

Apple spells out a fallback. If no icon matches the recommended size, the smallest icon larger than the recommended size is used. If none is larger, the largest icon is used1.

If no size matchesFind the recommended sizeUse smallest icon that's largerElse use the largest icon
The fallback rule from Apple's guide.

If you add no tag at all

Apple says that when no link element names an icon, the website root directory is searched for files starting with apple-touch-icon1. MDN agrees that Apple automatically requests /apple-touch-icon.png and similar files. It still says explicit links protect you against changes2.

One large file instead

MDN says it's usually sufficient to provide one large image, such as 192x192, and let the browser scale it down. You may want separate images with different levels of detail for different sizes, and smaller files for lower resolutions save bandwidth2.

The name under the icon

Apple says the default title for the launch icon comes from the page's title tag. A meta tag called apple-mobile-web-app-title can set a different one1.

How Google treats these tags

Google's favicon documentation lists apple-touch-icon as an iOS-friendly icon that represents your site, and apple-touch-icon-precomposed as an alternative for earlier versions of iOS3. Rules for search results are on the search results rules.

Android and installed web apps use a different file, the manifest. That's on the manifest page. For the ordinary tab icon, see the tag-by-tag guide.

Sources used

  1. Configuring Web Applications (Safari Web Content Guide, archive), Apple Developer Documentation Archive
  2. <link>: The External Resource Link element, MDN Web Docs
  3. Define a favicon to show in search results, Google Search Central