Skip to content

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.

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.

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.

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.

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.

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.

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.

Specifications

SpecificationStatus
None.