tabGroups

This API enables extensions to modify and rearrange tab groups.

Tab groups may persist across browser restarts as part of session restore. Tab groups in private browsing windows do not persist across restarts. When a tab group is restored, its groupId may differ from its original value.

The tabGroups API doesn't offer the ability to create, alter, or remove tab groups. Use:

tabs.group and tabs.ungroup to create or remove groups.
tabs.move to move tabs within, into, or out of a group.
tabs.remove to close tabs in a group, and close the group if the tab was the last one in the group.
tabs.query to query the position of a tab group within a window.

These APIs in the tabs namespace don't require any permissions.

Permissions

To use this API, an extension must request the "tabGroups" permission in its manifest.json file. The "tabGroups" permission is not shown to users in permission prompts.

Types

tabGroups.Color: The color of a tab group.
tabGroups.TabGroup: The state of a tab group.

Properties

tabGroups.TAB_GROUP_ID_NONE: The tab group ID value returned when a tab isn't in a tab group.

Functions

tabGroups.get(): Returns details about a tab group.
tabGroups.move(): Moves a tab group within or to another window.
tabGroups.query(): Returns all tab groups or finds tab groups with certain properties.
tabGroups.update(): Modifies the state of a tab group.

Events

tabGroups.onCreated: Fires when a tab group is created.
tabGroups.onMoved: Fires when a tab group is moved within a window or to another window.
tabGroups.onRemoved: Fires when a tab group is removed.
tabGroups.onUpdated: Fires when a tab group is updated.

Browser compatibility

	desktop					mobile
	Chrome	Edge	Firefox	Opera	Safari	Firefox for Android	Safari on iOS
`tabGroups`	Chrome – Full support Chrome 89 (Release date: 2021-03-02) footnote Full support	Edge – Full support Edge 89 (Release date: 2021-03-04) footnote Full support	Firefox – Full support Firefox 139 (Release date: 2025-05-27) footnote Full support	Opera – Full support Opera 75 (Release date: 2021-03-24) footnote Full support	Safari – No support Safari footnote No support	Firefox for Android – No support Firefox for Android footnote No support	Safari on iOS – No support Safari on iOS footnote No support
`Color`	Chrome – Full support Chrome 89 (Release date: 2021-03-02) footnote Full support	Edge – Full support Edge 89 (Release date: 2021-03-04) footnote Full support	Firefox – Full support Firefox 139 (Release date: 2025-05-27) footnote Full support	Opera – Full support Opera 75 (Release date: 2021-03-24) footnote Full support	Safari – No support Safari footnote No support	Firefox for Android – No support Firefox for Android footnote No support	Safari on iOS – No support Safari on iOS footnote No support
`TAB_GROUP_ID_NONE`	Chrome – Full support Chrome 89 (Release date: 2021-03-02) footnote Full support	Edge – Full support Edge 89 (Release date: 2021-03-04) footnote Full support	Firefox – Full support Firefox 139 (Release date: 2025-05-27) footnote Full support	Opera – Full support Opera 75 (Release date: 2021-03-24) footnote Full support	Safari – No support Safari footnote No support	Firefox for Android – No support Firefox for Android footnote No support	Safari on iOS – No support Safari on iOS footnote No support
`TabGroup`	Chrome – Full support Chrome 89 (Release date: 2021-03-02) footnote Full support	Edge – Full support Edge 89 (Release date: 2021-03-04) footnote Full support	Firefox – Full support Firefox 139 (Release date: 2025-05-27) footnote Full support	Opera – Full support Opera 75 (Release date: 2021-03-24) footnote Full support	Safari – No support Safari footnote No support	Firefox for Android – No support Firefox for Android footnote No support	Safari on iOS – No support Safari on iOS footnote No support
`TabGroup.collapsed`	Chrome – Full support Chrome 89 (Release date: 2021-03-02) footnote Full support	Edge – Full support Edge 89 (Release date: 2021-03-04) footnote Full support	Firefox – Full support Firefox 139 (Release date: 2025-05-27) footnote Full support	Opera – Full support Opera 75 (Release date: 2021-03-24) footnote Full support	Safari – No support Safari footnote No support	Firefox for Android – No support Firefox for Android footnote No support	Safari on iOS – No support Safari on iOS footnote No support
`TabGroup.color`	Chrome – Full support Chrome 89 (Release date: 2021-03-02) footnote Full support	Edge – Full support Edge 89 (Release date: 2021-03-04) footnote Full support	Firefox – Full support Firefox 139 (Release date: 2025-05-27) footnote Full support	Opera – Full support Opera 75 (Release date: 2021-03-24) footnote Full support	Safari – No support Safari footnote No support	Firefox for Android – No support Firefox for Android footnote No support	Safari on iOS – No support Safari on iOS footnote No support
`TabGroup.id`	Chrome – Full support Chrome 89 (Release date: 2021-03-02) footnote Full support	Edge – Full support Edge 89 (Release date: 2021-03-04) footnote Full support	Firefox – Full support Firefox 139 (Release date: 2025-05-27) footnote Full support	Opera – Full support Opera 75 (Release date: 2021-03-24) footnote Full support	Safari – No support Safari footnote No support	Firefox for Android – No support Firefox for Android footnote No support	Safari on iOS – No support Safari on iOS footnote No support
`TabGroup.shared`	Chrome – Full support Chrome 89 (Release date: 2021-03-02) footnote Full support	Edge – Full support Edge 89 (Release date: 2021-03-04) footnote Full support	Firefox – No support Firefox footnote No support	Opera – Full support Opera 75 (Release date: 2021-03-24) footnote Full support	Safari – No support Safari footnote No support	Firefox for Android – No support Firefox for Android footnote No support	Safari on iOS – No support Safari on iOS footnote No support
`TabGroup.title`	Chrome – Full support Chrome 89 (Release date: 2021-03-02) footnote Full support	Edge – Full support Edge 89 (Release date: 2021-03-04) footnote Full support	Firefox – Full support Firefox 139 (Release date: 2025-05-27) footnote Full support	Opera – Full support Opera 75 (Release date: 2021-03-24) footnote Full support	Safari – No support Safari footnote No support	Firefox for Android – No support Firefox for Android footnote No support	Safari on iOS – No support Safari on iOS footnote No support
`TabGroup.windowId`	Chrome – Full support Chrome 89 (Release date: 2021-03-02) footnote Full support	Edge – Full support Edge 89 (Release date: 2021-03-04) footnote Full support	Firefox – Full support Firefox 139 (Release date: 2025-05-27) footnote Full support	Opera – Full support Opera 75 (Release date: 2021-03-24) footnote Full support	Safari – No support Safari footnote No support	Firefox for Android – No support Firefox for Android footnote No support	Safari on iOS – No support Safari on iOS footnote No support
`get`	Chrome – Full support Chrome 89 (Release date: 2021-03-02) footnote Full support	Edge – Full support Edge 89 (Release date: 2021-03-04) footnote Full support	Firefox – Full support Firefox 139 (Release date: 2025-05-27) footnote Full support	Opera – Full support Opera 75 (Release date: 2021-03-24) footnote Full support	Safari – No support Safari footnote No support	Firefox for Android – No support Firefox for Android footnote No support	Safari on iOS – No support Safari on iOS footnote No support
`move`	Chrome – Full support Chrome 89 (Release date: 2021-03-02) footnote Full support	Edge – Full support Edge 89 (Release date: 2021-03-04) footnote Full support	Firefox – Full support Firefox 139 (Release date: 2025-05-27) footnote Full support	Opera – Full support Opera 75 (Release date: 2021-03-24) footnote Full support	Safari – No support Safari footnote No support	Firefox for Android – No support Firefox for Android footnote No support	Safari on iOS – No support Safari on iOS footnote No support
`move.moveProperties`	Chrome – Full support Chrome 89 (Release date: 2021-03-02) footnote Full support	Edge – Full support Edge 89 (Release date: 2021-03-04) footnote Full support	Firefox – Full support Firefox 139 (Release date: 2025-05-27) footnote Full support	Opera – Full support Opera 75 (Release date: 2021-03-24) footnote Full support	Safari – No support Safari footnote No support	Firefox for Android – No support Firefox for Android footnote No support	Safari on iOS – No support Safari on iOS footnote No support
`moveProperties.index`	Chrome – Full support Chrome 89 (Release date: 2021-03-02) footnote Full support	Edge – Full support Edge 89 (Release date: 2021-03-04) footnote Full support	Firefox – Full support Firefox 139 (Release date: 2025-05-27) footnote Full support	Opera – Full support Opera 75 (Release date: 2021-03-24) footnote Full support	Safari – No support Safari footnote No support	Firefox for Android – No support Firefox for Android footnote No support	Safari on iOS – No support Safari on iOS footnote No support
`moveProperties.windowId`	Chrome – Full support Chrome 89 (Release date: 2021-03-02) footnote Full support	Edge – Full support Edge 89 (Release date: 2021-03-04) footnote Full support	Firefox – Full support Firefox 139 (Release date: 2025-05-27) footnote Full support	Opera – Full support Opera 75 (Release date: 2021-03-24) footnote Full support	Safari – No support Safari footnote No support	Firefox for Android – No support Firefox for Android footnote No support	Safari on iOS – No support Safari on iOS footnote No support
`onCreated`	Chrome – Full support Chrome 89 (Release date: 2021-03-02) footnote Full support	Edge – Full support Edge 89 (Release date: 2021-03-04) footnote Full support	Firefox – Full support Firefox 139 (Release date: 2025-05-27) footnote Full support	Opera – Full support Opera 75 (Release date: 2021-03-24) footnote Full support	Safari – No support Safari footnote No support	Firefox for Android – No support Firefox for Android footnote No support	Safari on iOS – No support Safari on iOS footnote No support
`onMoved`	Chrome – Full support Chrome 89 (Release date: 2021-03-02) footnote footnote Not fired when tab groups are moved to another window; tabGroups.onRemoved and onCreated are fired instead.	Edge – Full support Edge 89 (Release date: 2021-03-04) footnote footnote Not fired when tab groups are moved to another window; tabGroups.onRemoved and onCreated are fired instead.	Firefox – Full support Firefox 139 (Release date: 2025-05-27) footnote Full support	Opera – Full support Opera 75 (Release date: 2021-03-24) footnote footnote Not fired when tab groups are moved to another window; tabGroups.onRemoved and onCreated are fired instead.	Safari – No support Safari footnote No support	Firefox for Android – No support Firefox for Android footnote No support	Safari on iOS – No support Safari on iOS footnote No support
`onRemoved`	Chrome – Full support Chrome 89 (Release date: 2021-03-02) footnote Full support	Edge – Full support Edge 89 (Release date: 2021-03-04) footnote Full support	Firefox – Full support Firefox 139 (Release date: 2025-05-27) footnote Full support	Opera – Full support Opera 75 (Release date: 2021-03-24) footnote Full support	Safari – No support Safari footnote No support	Firefox for Android – No support Firefox for Android footnote No support	Safari on iOS – No support Safari on iOS footnote No support
`onRemoved.removeInfo`	Chrome – No support Chrome footnote No support	Edge – No support Edge footnote No support	Firefox – Full support Firefox 139 (Release date: 2025-05-27) footnote Full support	Opera – No support Opera footnote No support	Safari – No support Safari footnote No support	Firefox for Android – No support Firefox for Android footnote No support	Safari on iOS – No support Safari on iOS footnote No support
`onUpdated`	Chrome – Full support Chrome 89 (Release date: 2021-03-02) footnote Full support	Edge – Full support Edge 89 (Release date: 2021-03-04) footnote Full support	Firefox – Full support Firefox 139 (Release date: 2025-05-27) footnote Full support	Opera – Full support Opera 75 (Release date: 2021-03-24) footnote Full support	Safari – No support Safari footnote No support	Firefox for Android – No support Firefox for Android footnote No support	Safari on iOS – No support Safari on iOS footnote No support
`query`	Chrome – Full support Chrome 89 (Release date: 2021-03-02) footnote Full support	Edge – Full support Edge 89 (Release date: 2021-03-04) footnote Full support	Firefox – Full support Firefox 139 (Release date: 2025-05-27) footnote Full support	Opera – Full support Opera 75 (Release date: 2021-03-24) footnote Full support	Safari – No support Safari footnote No support	Firefox for Android – No support Firefox for Android footnote No support	Safari on iOS – No support Safari on iOS footnote No support
`query.queryInfo`	Chrome – Full support Chrome 89 (Release date: 2021-03-02) footnote Full support	Edge – Full support Edge 89 (Release date: 2021-03-04) footnote Full support	Firefox – Full support Firefox 139 (Release date: 2025-05-27) footnote Full support	Opera – Full support Opera 75 (Release date: 2021-03-24) footnote Full support	Safari – No support Safari footnote No support	Firefox for Android – No support Firefox for Android footnote No support	Safari on iOS – No support Safari on iOS footnote No support
`queryInfo.collapsed`	Chrome – Full support Chrome 89 (Release date: 2021-03-02) footnote Full support	Edge – Full support Edge 89 (Release date: 2021-03-04) footnote Full support	Firefox – Full support Firefox 139 (Release date: 2025-05-27) footnote Full support	Opera – Full support Opera 75 (Release date: 2021-03-24) footnote Full support	Safari – No support Safari footnote No support	Firefox for Android – No support Firefox for Android footnote No support	Safari on iOS – No support Safari on iOS footnote No support
`queryInfo.color`	Chrome – Full support Chrome 89 (Release date: 2021-03-02) footnote Full support	Edge – Full support Edge 89 (Release date: 2021-03-04) footnote Full support	Firefox – Full support Firefox 139 (Release date: 2025-05-27) footnote Full support	Opera – Full support Opera 75 (Release date: 2021-03-24) footnote Full support	Safari – No support Safari footnote No support	Firefox for Android – No support Firefox for Android footnote No support	Safari on iOS – No support Safari on iOS footnote No support
`queryInfo.title`	Chrome – Full support Chrome 89 (Release date: 2021-03-02) footnote Full support	Edge – Full support Edge 89 (Release date: 2021-03-04) footnote Full support	Firefox – Full support Firefox 139 (Release date: 2025-05-27) footnote Full support	Opera – Full support Opera 75 (Release date: 2021-03-24) footnote Full support	Safari – No support Safari footnote No support	Firefox for Android – No support Firefox for Android footnote No support	Safari on iOS – No support Safari on iOS footnote No support
`queryInfo.windowId`	Chrome – Full support Chrome 89 (Release date: 2021-03-02) footnote Full support	Edge – Full support Edge 89 (Release date: 2021-03-04) footnote Full support	Firefox – Full support Firefox 139 (Release date: 2025-05-27) footnote Full support	Opera – Full support Opera 75 (Release date: 2021-03-24) footnote Full support	Safari – No support Safari footnote No support	Firefox for Android – No support Firefox for Android footnote No support	Safari on iOS – No support Safari on iOS footnote No support
`update`	Chrome – Full support Chrome 89 (Release date: 2021-03-02) footnote Full support	Edge – Full support Edge 89 (Release date: 2021-03-04) footnote Full support	Firefox – Full support Firefox 139 (Release date: 2025-05-27) footnote Full support	Opera – Full support Opera 75 (Release date: 2021-03-24) footnote Full support	Safari – No support Safari footnote No support	Firefox for Android – No support Firefox for Android footnote No support	Safari on iOS – No support Safari on iOS footnote No support
`update.updateProperties`	Chrome – Full support Chrome 89 (Release date: 2021-03-02) footnote Full support	Edge – Full support Edge 89 (Release date: 2021-03-04) footnote Full support	Firefox – Full support Firefox 139 (Release date: 2025-05-27) footnote Full support	Opera – Full support Opera 75 (Release date: 2021-03-24) footnote Full support	Safari – No support Safari footnote No support	Firefox for Android – No support Firefox for Android footnote No support	Safari on iOS – No support Safari on iOS footnote No support
`updateProperties.collapsed`	Chrome – Full support Chrome 89 (Release date: 2021-03-02) footnote Full support	Edge – Full support Edge 89 (Release date: 2021-03-04) footnote Full support	Firefox – Full support Firefox 139 (Release date: 2025-05-27) footnote Full support	Opera – Full support Opera 75 (Release date: 2021-03-24) footnote Full support	Safari – No support Safari footnote No support	Firefox for Android – No support Firefox for Android footnote No support	Safari on iOS – No support Safari on iOS footnote No support
`updateProperties.color`	Chrome – Full support Chrome 89 (Release date: 2021-03-02) footnote Full support	Edge – Full support Edge 89 (Release date: 2021-03-04) footnote Full support	Firefox – Full support Firefox 139 (Release date: 2025-05-27) footnote Full support	Opera – Full support Opera 75 (Release date: 2021-03-24) footnote Full support	Safari – No support Safari footnote No support	Firefox for Android – No support Firefox for Android footnote No support	Safari on iOS – No support Safari on iOS footnote No support
`updateProperties.title`	Chrome – Full support Chrome 89 (Release date: 2021-03-02) footnote Full support	Edge – Full support Edge 89 (Release date: 2021-03-04) footnote Full support	Firefox – Full support Firefox 139 (Release date: 2025-05-27) footnote Full support	Opera – Full support Opera 75 (Release date: 2021-03-24) footnote Full support	Safari – No support Safari footnote No support	Firefox for Android – No support Firefox for Android footnote No support	Safari on iOS – No support Safari on iOS footnote No support

Tip: you can click/tap on a cell for more information.

Full support: Full support
No support: No support
: See implementation notes.