Skip to content

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.

  • name, description, tag, ms_ac_template, and screenshots are required; short_name, icons, template, data, type, auth, update, and multiple are optional. Only Adaptive Cards templates supplied through ms_ac_template are supported; template is 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(). update is an interval in seconds that the service worker must act on itself.
  • The service worker receives widgetinstall, widgetuninstall, widgetresume, and widgetclick. Widget icons and screenshots larger than 1024x1024 pixels are ignored, and a screenshot’s platform accepts Windows and any. Local testing requires WinAppSDK 1.2 and Developer Mode on Windows 11.