Add support to iOS Safari in Add to Home Screen option


Safari supports iOS push notifications from the version 16.4, however, it requires manifest.json file implementation. You can setup your manifest.json yourself or generate it via any online service like: Manifest Generator

Your manifest attributes should contain:

  • $schema (required)

  • display standalone or fullscreen (required)

  • icons to reference icons of several sizes (recommended)

  • id (optional)

Example manifest file:

  "$schema": "",
  "display": "standalone",
  "start_url": "/",
  "name": "PPG Demo",
  "icons": [
      "src": "/images/ca.png",
      "sizes": "40x40",
      "type": "image/png"


  1. Once you have your manifest, add manifest.json to your root path of website. It must be accessible via

  2. Place index.html file in <head> section reference to manifest:

<link rel="manifest" href="/manifest.json"/>


The implementation will work only if you pin your website to home screen in iOS Safari.

  1. Navigate to your website

  2. Tap "share" button

  3. Tap "Add to Home Screen" option

Run the app pinned to the home screen.

All Safari browser versions requires user gesture (click on desktop, tap on mobile device) to display subscription prompt.

If you have completed all steps correctly, the web push subscription prompt will appear.

Invite users to pin your website to iOS home screen

If you wish to promote this feature in iOS Safari, you can use any open-source solution or create your own prompt to engage users. An example of such an implementation can be found in this repository:

Last updated