updated feature: Window shape API

72 views
Skip to first unread message

Chromestatus

unread,
Jul 3, 2026, 10:42:33 AMJul 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 AMJul 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 AMJul 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 AMJul 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 AMJul 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 AMJul 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 AMJul 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 AMJul 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:

Chromestatus

unread,
Jul 7, 2026, 5:33:45 PMJul 7
to iwa...@chromium.org
Chrome Platform Status
 Updated feature entry:
Window shape API
Updates made by edm...@google.com:
  • standard_maturity:
    Old: 0
    New: Unknown standards status - check spec link for status

Your next steps:

Chromestatus

unread,
Jul 8, 2026, 12:30:12 PMJul 8
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 8, 2026, 12:57:16 PMJul 8
to iwa...@chromium.org
Chrome Platform Status
 Updated feature entry:
Window shape API
Updates made by edm...@google.com:
  • summary:
    Old: Allows developers to set a custom window shape for allowlisted Isolated Web Apps (IWAs) on ChromeOS using the `window.chromeos.isolatedWebApp.setShape` API. The custom shape is flexible enough to allow creation of non-rectangular and non-contiguous window layouts. The API requires the window to be in the "unframed" display mode and have the "window-management" permission granted. Administrators can manage this feature with the existing policies for the window-management permission: * DefaultWindowManagementSetting: Configures the default state for the window-management permission for all apps. The policies below can override this default. * WindowManagementAllowedForUrls: Grants the permission to specified IWA origins, allowing them to enter unframed mode and set a custom shape without any user interaction. * WindowManagementBlockedForUrls: Blocks the permission for specified origins, forcing Chrome to remove any custom shapes and to fallback from unframed to other display modes the app uses.
    New: Window Shape API enables allowlisted [Isolated Web Apps](https://chromeos.dev/en/web/isolated-web-apps) on ChromeOS to customize their window shape. By enabling non-rectangular and non-contiguous window layouts, developers can implement unique user experiences (such as widgets, floating panels, and overlays) that match the look-and-feel of native applications. The API `window.chromeos.isolatedWebApp.setShape` requires the window to be in the unframed display mode and requires the window-management permission to be granted. Administrators can manage this feature with existing policies for window management: - [DefaultWindowManagementSetting](https://chromeenterprise.google/policies/#DefaultWindowManagementSetting) configures the default state for the window management for all apps. The policies below can override this default. - [WindowManagementAllowedForUrls](https://chromeenterprise.google/policies/#WindowManagementAllowedForUrls) allows IWAs with specified origins to enter unframed mode and set custom window shapes without any user interaction. - [WindowManagementBlockedForUrls](https://chromeenterprise.google/policies/#WindowManagementBlockedForUrls) blocks the permission for specified origins, forcing Chrome to remove any custom window shapes and fallback to other available display modes.

Your next steps:

Chromestatus

unread,
Jul 9, 2026, 2:53:35 AMJul 9
to iwa...@chromium.org
Chrome Platform Status
 Updated feature entry:
Window shape API
Updates made by alexr...@google.com:
Your next steps:

Chromestatus

unread,
Jul 10, 2026, 6:20:16 AMJul 10
to iwa...@chromium.org
Chrome Platform Status
 Updated feature entry:
Window shape API
Updates made by secur...@google.com:
Your next steps:

Chromestatus

unread,
Jul 10, 2026, 1:30:44 PMJul 10
to iwa...@chromium.org
Chrome Platform Status
 Updated feature entry:
Window shape API
Updates made by aa...@google.com:
Your next steps:

Chromestatus

unread,
Jul 13, 2026, 10:11:11 AM (12 days ago) Jul 13
to iwa...@chromium.org
Chrome Platform Status
 Updated feature entry:
Window shape API
Updates made by rachel...@google.com:
Your next steps:

Chromestatus

unread,
Jul 13, 2026, 12:06:52 PM (12 days ago) Jul 13
to iwa...@chromium.org
Chrome Platform Status
 Updated feature entry:
Window shape API
Updates made by elmira...@google.com:
  • enterprise_impact:
    Old: 2
    New: 1

Your next steps:

Chromestatus

unread,
Jul 13, 2026, 12:15:37 PM (12 days ago) Jul 13
to iwa...@chromium.org
Chrome Platform Status
 Updated feature entry:
Window shape API
Updates made by elmira...@google.com:
  • enterprise_impact:
    Old: 2
    New: 2

Your next steps:

Chromestatus

unread,
Jul 13, 2026, 12:15:41 PM (12 days ago) Jul 13
to iwa...@chromium.org
Chrome Platform Status
 Updated feature entry:
Window shape API
Updates made by elmira...@google.com:
  • enterprise_impact:
    Old: 1
    New: 2

Your next steps:

Chromestatus

unread,
Jul 13, 2026, 9:04:45 PM (12 days ago) Jul 13
to iwa...@chromium.org
Chrome Platform Status
 Updated feature entry:
Window shape API
Updates made by elmira...@google.com:
  • is_releasenotes_content_reviewed:
    Old: False
    New: True

Your next steps:

Chromestatus

unread,
Jul 13, 2026, 9:05:45 PM (12 days ago) Jul 13
to iwa...@chromium.org
Chrome Platform Status
 Updated feature entry:
Window shape API
Updates made by elmira...@google.com:
  • rollout_platforms:
    Old: []
    New: ChromeOS

  • rollout_stage_plan:
    Old: None
    New: 0

  • rollout_milestone:
    Old: None
    New: 152

Your next steps:

Chromestatus

unread,
Jul 15, 2026, 7:47:15 AM (10 days ago) Jul 15
to iwa...@chromium.org
Chrome Platform Status
 Updated feature entry:
Window shape API
Updates made by siobhan...@google.com:
  • summary:
    Old: Window Shape API enables allowlisted [Isolated Web Apps](https://chromeos.dev/en/web/isolated-web-apps) on ChromeOS to customize their window shape. By enabling non-rectangular and non-contiguous window layouts, developers can implement unique user experiences (such as widgets, floating panels, and overlays) that match the look-and-feel of native applications. The API `window.chromeos.isolatedWebApp.setShape` requires the window to be in the unframed display mode and requires the window-management permission to be granted. Administrators can manage this feature with existing policies for window management: - [DefaultWindowManagementSetting](https://chromeenterprise.google/policies/#DefaultWindowManagementSetting) configures the default state for the window management for all apps. The policies below can override this default. - [WindowManagementAllowedForUrls](https://chromeenterprise.google/policies/#WindowManagementAllowedForUrls) allows IWAs with specified origins to enter unframed mode and set custom window shapes without any user interaction. - [WindowManagementBlockedForUrls](https://chromeenterprise.google/policies/#WindowManagementBlockedForUrls) blocks the permission for specified origins, forcing Chrome to remove any custom window shapes and fallback to other available display modes.
    New: Window Shape API enables allowlisted [Isolated Web Apps](https://chromeos.dev/en/web/isolated-web-apps) on ChromeOS to customize their window shape. By enabling non-rectangular and non-contiguous window layouts, developers can implement unique user experiences (such as widgets, floating panels, and overlays) that match the look-and-feel of native applications. The API `window.chromeos.isolatedWebApp.setShape` requires the window to be in _unframed display mode_ and requires the window-management permission to be granted. Administrators can manage this feature with existing policies for window management: - [DefaultWindowManagementSetting](https://chromeenterprise.google/policies/#DefaultWindowManagementSetting) configures the default state for the window management for all apps. The policies below can override this default. - [WindowManagementAllowedForUrls](https://chromeenterprise.google/policies/#WindowManagementAllowedForUrls) allows IWAs with specified origins to enter unframed mode and set custom window shapes without any user interaction. - [WindowManagementBlockedForUrls](https://chromeenterprise.google/policies/#WindowManagementBlockedForUrls) blocks the permission for specified origins, forcing Chrome to remove any custom window shapes and fallback to other available display modes.

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