Storefront & themesUpdated 2026-06-01
Progressive Web App (PWA)
Make your storefront installable with a manifest, icons, and Web Push notifications.
Enable PWA to let shoppers install your store as an app on their phone or desktop, with offline support and push notifications.
Where to find it
Settings → PWA. Toggle enabled and configure the app identity and icons.
PWA settings
| Field | Type | Description |
|---|---|---|
| appName | string | The install prompt and home-screen name. |
| shortName | string | A short name for the home screen icon label. |
| themeColor | string | Browser chrome and status bar color. |
| backgroundColor | string | Splash screen background color. |
| displayMode | enum | standalone, fullscreen, minimal-ui, or browser. |
| icon192 / icon512 | url | PWA icons (192px and 512px PNGs). |
| maskableIcon | url | An adaptive icon for Android. |
| offlineCache | boolean | Enable offline caching of pages. |
| installPrompt | boolean | Show a custom install prompt to shoppers. |
Web Push notifications
PWA includes Web Push support using VAPID keys. Generate a keypair with the /pwa/generate-vapid-keys endpoint, then configure push prompt copy. Shoppers subscribe via the /push/subscribe endpoint, and you can send push campaigns from the Marketing section.
PWA & push endpoints
GET
/storefront/manifestPWA web app manifest (application/manifest+json).
PublicPOST
/shop/pwa/generate-vapid-keysGenerate a VAPID keypair for Web Push.
SessionPOST
/storefront-public/push/subscribeSubscribe a browser to Web Push (if PWA push enabled).
Public