v148 · PWA · install element · origin trial

Install Button Designer

Configure a <install> element visually. Preview states, toggle dark/light theme, generate the HTML, and see the beforeinstallprompt fallback pattern for older browsers.

Origin Trial The Web App HTML install element is in origin trial. The element name and attributes may shift before GA. Enable via chrome://flags/#web-app-install-element or join the origin trial at aka.ms/installelement.

designer

Properties

Button text

Manifest URL

Icon URL

Theme

Size

Cross-origin

Preview

generated HTML

test install

Trigger the real install flow (if API is available)

Install prompt status will appear here.

browser support matrix

Browser	install element	beforeinstallprompt	Notes
Chrome 148+	Origin Trial	Yes	Enable flag or OT token
Chrome < 148	No	Yes	Use beforeinstallprompt fallback
Edge 148+	Origin Trial	Yes	Chromium-based, same OT
Firefox	No	No	No PWA install prompt
Safari	No	No	Add to Home Screen via share sheet

beforeinstallprompt fallback

For browsers without the <install> element, use the classic beforeinstallprompt pattern:

implementation reference

Need the exact API surface, compatibility boundaries, errors, lifecycle, and source links? Read the matching gendn reference ↗