Platform in Platforms
PWAs on Firefox
Published Updated
Firefox lets you install web apps on Windows and Android: Firefox 143 and later on Windows pins a
site to the taskbar and runs it in a simplified window, and Firefox for Android adds a
manifest-described site to the Home Screen from its menu. Neither path fires
beforeinstallprompt, so install-flow code written for Chromium has to branch.
How it works
Section titled “How it works”Firefox has no address-bar install icon of the Chromium kind and no in-page install event. Installation is available through Firefox’s own UI on Windows and Android.
Taskbar web apps on Windows (Firefox 143+)
Section titled “Taskbar web apps on Windows (Firefox 143+)”The Firefox 143.0 release notes (2025-09-16) describe the feature as “running websites as web apps pinned directly to the taskbar”: the user pins a site, and it opens in a simplified window launched from the taskbar that keeps the user’s installed add-ons. The same notes exclude Firefox installed from the Microsoft Store, and the feature is Windows-only in that release. The user starts the flow from the address bar; the site’s manifest cannot start it.
Home Screen web apps on Firefox for Android
Section titled “Home Screen web apps on Firefox for Android”On Android the path is menu-driven. Mozilla’s support article Use Web Apps with Firefox for Android gives the steps: open the site, tap the menu button, tap Install, and the Android Add to Home Screen panel appears, where the user drags the icon into place or taps Add automatically (English UI). The icon launches the site in Firefox; removing Firefox removes the web app with it.
Desktop Firefox on macOS and Linux
Section titled “Desktop Firefox on macOS and Linux”Firefox 143 on macOS and Linux has no manifest-driven install flow. MDN’s installing guide notes that desktop Firefox requires a third-party PWA extension to install a site. Offer those users a bookmark or an ordinary tab, and make sure the app works fully in that tab.
What Firefox does not implement
Section titled “What Firefox does not implement”BeforeInstallPromptEvent is non-standard and
MDN lists no Firefox or Firefox for Android version
that implements it (Chrome 44+, Edge 79+, Samsung Internet 4.0+ do). A page cannot defer,
trigger, or detect an install prompt on Firefox, and appinstalled is not fired either.
Examples
Section titled “Examples”Both examples run unchanged in Chromium browsers; the branches exist for Firefox and Safari.
Showing an install button only after the event fires
Section titled “Showing an install button only after the event fires”Code that offers an “Install app” button must test whether the event is available, and must say something useful on the browsers where it does not exist.
<button id="install-button" hidden>Install app</button><p id="install-instructions" hidden> This browser has no one-click install from this page. Use it as a tab, or bookmark it. On Firefox for Android, open the menu and tap Install.</p>
<script> let deferredPrompt = null; const installButton = document.getElementById('install-button'); const installInstructions = document.getElementById('install-instructions');
if (!('onbeforeinstallprompt' in window)) { // Firefox (any OS) and Safari: the event does not exist here. installInstructions.hidden = false; } else { window.addEventListener('beforeinstallprompt', (event) => { event.preventDefault(); deferredPrompt = event; installButton.hidden = false; });
installButton.addEventListener('click', async () => { if (!deferredPrompt) return; deferredPrompt.prompt(); deferredPrompt = null; }); }</script>The 'onbeforeinstallprompt' in window test is a property check, so it works before any
event has had a chance to fire; waiting for the event itself would leave the fallback text
hidden on Firefox for ever.
Detecting the simplified window
Section titled “Detecting the simplified window”A Firefox taskbar web app and a Firefox for Android Home Screen web app both report
display-mode: standalone once the manifest asks for it, which is the same media feature
Chromium and WebKit use.
function runsAsInstalledApp() { if (typeof window.matchMedia !== 'function') { // No matchMedia: treat the page as an ordinary tab. return false; } return window.matchMedia('(display-mode: standalone)').matches;}
document.body.dataset.installed = runsAsInstalledApp() ? 'yes' : 'no';Use this to hide an install hint inside the installed window; do not use it to gate features, because the same user may open the site in a normal tab next.
Observed behaviour
Section titled “Observed behaviour”The Windows feature is controlled by a preference that ships enabled, which is also the only documented way to hide its address-bar entry point.
Because the pinned window keeps add-ons (release notes, 2025-09-16), content blockers and password managers keep working inside the web app; test the app with a blocker enabled before assuming a third-party script loads there.
See also
Section titled “See also”- PWAs on Chrome and Android
- PWAs on iOS and Safari
- Install prompt
- Install prompt compatibility
- Firefox 143.0 release notes (firefox.com)
- Use Web Apps with Firefox for Android (support.mozilla.org)
- BeforeInstallPromptEvent (developer.mozilla.org)
Specifications
| Specification | Status |
|---|---|
| None. | |