Apple Touch Icons and Home Screen Icons
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.
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 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
- Configuring Web Applications (Safari Web Content Guide, archive), Apple Developer Documentation Archive
- <link>: The External Resource Link element, MDN Web Docs
- Define a favicon to show in search results, Google Search Central