Add an Apple touch icon to your Progressive Web App
Safari for iOS users can manually add Progressive Web Apps (PWAs) to their home screen. The icon that appears on the iOS home screen when a PWA is added is called the Apple touch icon. This codelab shows you how to add an Apple touch icon to a PWA. It assumes that you have access to an iOS device.
iOS Safari users can add any webpage to their home screen. It doesn't have to be a PWA. In fact, the example app used in this codelab isn't a PWA. But in most cases a PWA would be the kind of app that a user would most likely want to add to their home screen.
Open the example app in a new tab:
Click Remix to Edit to make the project editable.
To preview the site, press View App. Then press Fullscreen .
Note the URL of your example app. It'll be something like
Run a Lighthouse PWA audit on your example app in Chrome DevTools:
Command+Option+Jon Mac) to open DevTools.
- Click the Audits tab.
- Select the Progressive Web App checkbox.
- Click Run audits.
In the PWA Optimized section, Lighthouse reports that the example app doesn't provide a valid Apple touch icon.
Add the example app to an iOS home screen
To demonstrate how an Apple touch icon provides a more polished user experience, first try adding the example app to your iOS device's home screen when an Apple touch icon hasn't been specified.
- Open Safari for iOS.
- Open the URL of your example app. This is the URL like
https://example.glitch.methat you noted earlier.
- Tap Share > Add to Home Screen. You'll probably have to swipe left to see this option.
- Tap Add.
Because the site hasn't specified an Apple touch icon, iOS just generates an icon for the site from the page's content.
Add an Apple touch icon to the example app
- Uncomment the
<link rel="apple-touch-icon">tag at the bottom of the
<link rel="stylesheet" href="/index.css">
<link rel="shortcut icon" href="https://cdn.glitch.com/49d34dc6-8fbd-46bb-8221-b99ffd36f1af%2Ftouchicon-180.png?v=1566411949736">
<!-- <link rel="apple-touch-icon" href="https://cdn.glitch.com/49d34dc6-8fbd-46bb-8221-b99ffd36f1af%2Ftouchicon-180.png?v=1566411949736"> -->
Add the example app to an iOS home screen (again)
- Try adding the example app to an iOS home screen again. This time, a proper icon is generated for
the site. If you audit the page again with Lighthouse you'll also see that the
Does not provide a valid
apple-touch-iconaudit now passes.
Except as otherwise noted, the content of this page is licensed under the Creative Commons Attribution 4.0 License, and code samples are licensed under the Apache 2.0 License. For details, see the Google Developers Site Policies. Java is a registered trademark of Oracle and/or its affiliates.