Manifest widgets browser support
Published Updated
The widgets manifest member is an array of widget definitions; each registers one widget for an operating-system widgets board, which the PWA’s service worker renders and updates through a widgets attribute on ServiceWorkerGlobalScope.
Microsoft’s Edge documentation covers Windows 11 only. The PWA-driven Widgets explainer is an “Active” incubation proposal intended for the W3C Web Incubator Community Group; it has not become a finished standard. Neither source provides per-browser support data, so support beyond Microsoft’s documentation is unknown.
What Microsoft documents for Windows 11
Section titled “What Microsoft documents for Windows 11”name,description,tag,ms_ac_template, andscreenshotsare required;short_name,icons,template,data,type,auth,update, andmultipleare optional. Only Adaptive Cards templates supplied throughms_ac_templateare supported;templateis informational.- Installing the PWA adds its widgets to the Widgets Board but does not install them; a widget is installed when the user adds it from the board and is rendered only after the service worker calls
widgets.updateByTag().updateis an interval in seconds that the service worker must act on itself. - The service worker receives
widgetinstall,widgetuninstall,widgetresume, andwidgetclick. Widgeticonsandscreenshotslarger than 1024x1024 pixels are ignored, and a screenshot’splatformacceptsWindowsandany. Local testing requires WinAppSDK 1.2 and Developer Mode on Windows 11.
See also
Section titled “See also”- Manifest widgets: PWA content on the OS widgets board
- Periodic Background Sync browser support
- Build PWA-driven widgets (learn.microsoft.com)
- PWA-driven Widgets explainer (microsoftedge.github.io)