updated feature: Window shape API

0 views
Skip to first unread message

Chromestatus

unread,
Jul 3, 2026, 10:42:33 AM (yesterday) Jul 3
to iwa...@chromium.org
Chrome Platform Status
 Updated feature entry:
Window shape API
Updates made by edm...@google.com:
  • name:
    Old: setShape for allowlisted IWAs in ChromeOS
    New: Window shape API

Your next steps:

You are receiving this email because:

  • You are subscribed to all IWA features

Unsubscribe

Chromestatus

unread,
Jul 3, 2026, 10:42:42 AM (yesterday) Jul 3
to iwa...@chromium.org
Chrome Platform Status
 Updated feature entry:
Window shape API
Updates made by edm...@google.com:
  • explainer_links:
    Old: []
    New: https://github.com/explainers-by-googlers/chromeos-iwa-apis/blob/main/window-shape-explainer.md

Your next steps:

Chromestatus

unread,
Jul 3, 2026, 10:43:18 AM (yesterday) Jul 3
to iwa...@chromium.org
Chrome Platform Status
 Updated feature entry:
Window shape API
Updates made by edm...@google.com:
  • api_spec:
    Old: False
    New: True

  • spec_link:
    Old: None
    New: https://explainers-by-googlers.github.io/chromeos-iwa-apis/

Your next steps:

Chromestatus

unread,
Jul 3, 2026, 10:47:47 AM (yesterday) Jul 3
to iwa...@chromium.org
Chrome Platform Status
 Updated feature entry:
Window shape API
Updates made by edm...@google.com:
  • all_platforms_descr:
    Old: None
    New: This feature is implemented as a Blink extensions for Chrome on ChromeOS. It will not be available in any other platform.

  • flag_name:
    Old: None
    New: enable-chromeos-isolated-web-app-set-shape

  • privacy_review_status:
    Old: Pending
    New: Issues addressed

  • sample_links:
    Old: []
    New: https://github.com/paulinagacek/Set-Shape-demo https://goto.google.com/set-shape-try-it-out

  • security_review_status:
    Old: Pending
    New: Issues addressed

Your next steps:

Chromestatus

unread,
Jul 3, 2026, 10:49:09 AM (yesterday) Jul 3
to iwa...@chromium.org
Chrome Platform Status
 Updated feature entry:
Window shape API
Updates made by edm...@google.com:
  • tag_review:
    Old: None
    New: N/A - TAG review is not needed for IWA APIs https://crsrc.org/c/docs/website/site/blink/launching-features/isolated-web-apps/index.md;l=73;drc=a5459539e0dfc093d8dc137fb9f8a72ddf5dcbb3

Your next steps:

Chromestatus

unread,
Jul 3, 2026, 10:53:01 AM (yesterday) Jul 3
to iwa...@chromium.org
Chrome Platform Status
 Updated feature entry:
Window shape API
Updates made by edm...@google.com:
  • shipped_milestone:
    Old: None
    New: 152

  • adoption_expectation:
    Old: None
    New: Feature is used by allowlisted IWAs within 12 months of launch in Chrome.

  • adoption_plan:
    Old: None
    New: Work with partners: The feature is currently available behind a feature flag in ChromeOS, and two partners already use it to develop new IWAs. The target release of their IWAs is 26Q4.

  • anticipated_spec_changes:
    Old: None
    New: N/A

  • availability_expectation:
    Old: None
    New: Feature is available only in Chrome on ChromeOS, and only for allowlisted IWAs.

  • non_oss_deps:
    Old: None
    New: N/A

  • tag_review_status:
    Old: Pending
    New: Not applicable

  • webview_risks:
    Old: None
    New: N/A

Your next steps:

Chromestatus

unread,
Jul 3, 2026, 10:53:55 AM (yesterday) Jul 3
to iwa...@chromium.org
Chrome Platform Status
 Updated feature entry:
Window shape API
Updates made by edm...@google.com:
Your next steps:

Chromestatus

unread,
Jul 3, 2026, 10:59:42 AM (yesterday) Jul 3
to iwa...@chromium.org
Chrome Platform Status
 Updated feature entry:
Window shape API
Updates made by edm...@google.com:
  • activation_risks:
    Old: None
    New: N/A, the feature is a single JS API that follows the same behavior as a pre-existing Chrome App API. Developers already know how to use it.

  • debuggability:
    Old: None
    New: N/A

  • doc_links:
    Old: []
    New: https://docs.google.com/document/d/1zPr1QgS-bXsJE7nrO44zx9RBopR4gHuvHxfcqxsX5Ag/edit?tab=t.0#heading=h.pcgro84kqnh3

  • ergonomics_risks:
    Old: None
    New: N/A

  • interop_compat_risks:
    Old: None
    New: N/A, this feature is not meant to be implemented by other browsers.

  • security_risks:
    Old: None
    New: See https://github.com/explainers-by-googlers/chromeos-iwa-apis/blob/main/window-shape-explainer.md#security--privacy-considerations In summary: The custom shape can be used to create a hidden window, or for clickjacking. We mitigate this by requiring a minimum shape size of 10x10 pixels, and by enforcing an allowlist of partners that can use this API.

Your next steps:
Reply all
Reply to author
Forward
0 new messages