Back to overview
Progressive Web App (PWA)
Make your website installable as an app on mobile and desktop.
What is a PWA?
A Progressive Web App (PWA) allows your website to be installed as an app on phones, tablets, and desktops. Visitors can open your site via an icon on their home screen — no App Store or Play Store needed. The site loads faster on repeat visits thanks to smart caching.
Enabling PWA
Go to Settings → General → scroll to 'Progressive Web App'. Switch the toggle on and fill in the required fields:
• App name — the name visitors see after installation
• Short name — displayed under the icon on the home screen (max 12 characters)
• App icon — upload a square icon of 512×512 pixels. A smaller version (192×192) is generated automatically.
• Theme colour — determines the colour of the browser bar and splash screen
• Background colour — colour of the loading screen when opening the app
• Display mode — 'Standalone' (recommended) provides an app-like experience without the browser bar
Tips
- Use a clear, recognisable icon with sufficient contrast.
- The short name must be 12 characters or fewer — pick the most recognisable word.
How do visitors see the install prompt?
Once PWA is enabled, visitors see a prompt at the bottom of the screen after 30 seconds, asking them to install the site as an app.
• Chrome, Edge, Samsung Browser — the browser shows a native install dialog
• Safari (iPhone/iPad) — visitors receive an instruction: 'Tap the Share icon and choose Add to Home Screen'
• Firefox — the install option appears in the address bar
If a visitor chooses 'Not now', the prompt reappears after 7 days. Visitors who have already installed the app never see the prompt.
Tips
- The install prompt is fully automatic — no action required on your part.
- The prompt adapts to the visitor's browser language.
Offline caching
The PWA automatically stores the page structure and images in the browser. On a subsequent visit the site loads faster. If the internet connection drops briefly, the last visited page remains available.
Your page content is always fetched fresh from the server — visitors always see the latest version of your content.
Note
- Offline caching only works for previously visited pages. New pages require an internet connection.
Disabling PWA
Switch the toggle off at Settings → General → Progressive Web App. The install prompt disappears immediately. Visitors who have already installed the app can continue using it, but over time the app will automatically fall back to the regular website.
Frequently asked questions
Does a PWA cost extra?
No, the PWA feature is free and requires no separate hosting or app store account.
Can my website crash because of PWA?
No. If something goes wrong with the PWA settings, your website simply works as a normal website. PWA is an extra layer on top of your existing site.
Does PWA work on all devices?
Yes, on all modern browsers. The install experience differs per browser, but the website itself works everywhere.
Do I need to redeploy after enabling or disabling?
No, the change takes effect immediately after saving the settings.