Stay organized with collections Save and categorize content based on your preferences.
DescriptionUse the chrome.tabGroups
API to interact with the browser's tab grouping system. You can use this API to modify and rearrange tab groups in the browser. To group and ungroup tabs, or to query what tabs are in groups, use the chrome.tabs
API.
tabGroups
"grey"
"blue"
"red"
"yellow"
"green"
"pink"
"purple"
"cyan"
"orange"
Whether the group is collapsed. A collapsed group is one whose tabs are hidden.
The group's color.
The ID of the group. Group IDs are unique within a browser session.
Whether the group is shared.
The title of the group.
The ID of the window that contains the group.
An ID that represents the absence of a group.
Methods get()chrome.tabGroups.get(
groupId: number,
): Promise<TabGroup>
Retrieves details about the specified group.
move()chrome.tabGroups.move(
groupId: number,
moveProperties: object,
): Promise<TabGroup | undefined>
Moves the group and all its tabs within its window, or to a new window.
ParametersThe ID of the group to move.
The position to move the group to. Use -1
to place the group at the end of the window.
The window to move the group to. Defaults to the window the group is currently in. Note that groups can only be moved to and from windows with windows.WindowType
type "normal"
.
chrome.tabGroups.query(
queryInfo: object,
): Promise<TabGroup[]>
Gets all groups that have the specified properties, or all groups if no properties are specified.
Parameterscollapsed
boolean optional
Whether the groups are collapsed.
The color of the groups.
Whether the group is shared.
Match group titles against a pattern.
The ID of the parent window, or windows.WINDOW_ID_CURRENT
for the current window.
chrome.tabGroups.update(
groupId: number,
updateProperties: object,
): Promise<TabGroup | undefined>
Modifies the properties of a group. Properties that are not specified in updateProperties
are not modified.
The ID of the group to modify.
collapsed
boolean optional
Whether the group should be collapsed.
The color of the group.
The title of the group.
chrome.tabGroups.onCreated.addListener(
callback: function,
)
Fired when a group is created.
ParametersThe callback
parameter looks like:
(group: TabGroup) => void
chrome.tabGroups.onMoved.addListener(
callback: function,
)
Fired when a group is moved within a window. Move events are still fired for the individual tabs within the group, as well as for the group itself. This event is not fired when a group is moved between windows; instead, it will be removed from one window and created in another.
ParametersThe callback
parameter looks like:
(group: TabGroup) => void
chrome.tabGroups.onRemoved.addListener(
callback: function,
)
Fired when a group is closed, either directly by the user or automatically because it contained zero tabs.
ParametersThe callback
parameter looks like:
(group: TabGroup) => void
chrome.tabGroups.onUpdated.addListener(
callback: function,
)
Fired when a group is updated.
ParametersThe callback
parameter looks like:
(group: TabGroup) => void
Except as otherwise noted, the content of this page is licensed under the Creative Commons Attribution 4.0 License, and code samples are licensed under the Apache 2.0 License. For details, see the Google Developers Site Policies. Java is a registered trademark of Oracle and/or its affiliates.
Last updated 2025-08-11 UTC.
[[["Easy to understand","easyToUnderstand","thumb-up"],["Solved my problem","solvedMyProblem","thumb-up"],["Other","otherUp","thumb-up"]],[["Missing the information I need","missingTheInformationINeed","thumb-down"],["Too complicated / too many steps","tooComplicatedTooManySteps","thumb-down"],["Out of date","outOfDate","thumb-down"],["Samples / code issue","samplesCodeIssue","thumb-down"],["Other","otherDown","thumb-down"]],["Last updated 2025-08-11 UTC."],[],[]]
RetroSearch is an open source project built by @garambo | Open a GitHub Issue
Search and Browse the WWW like it's 1997 | Search results from DuckDuckGo
HTML:
3.2
| Encoding:
UTF-8
| Version:
0.7.4