From 28632174eb874ecd7dc787a4e775324ef70ec05f Mon Sep 17 00:00:00 2001 From: Richard Bloor Date: Fri, 27 Mar 2026 07:13:10 +1300 Subject: [PATCH 1/6] Release 150 tab split view functionality --- .../webextensions/api/tabs/move/index.md | 15 +++++++++++- .../webextensions/api/tabs/remove/index.md | 2 ++ .../working_with_the_tabs_api/index.md | 24 +++++++++++++++++-- .../mozilla/firefox/releases/150/index.md | 4 ++++ 4 files changed, 42 insertions(+), 3 deletions(-) diff --git a/files/en-us/mozilla/add-ons/webextensions/api/tabs/move/index.md b/files/en-us/mozilla/add-ons/webextensions/api/tabs/move/index.md index 904a9eaada106e2..c07a338daf00f3b 100644 --- a/files/en-us/mozilla/add-ons/webextensions/api/tabs/move/index.md +++ b/files/en-us/mozilla/add-ons/webextensions/api/tabs/move/index.md @@ -10,7 +10,20 @@ Moves one or more tabs to a new position in the same window or to a different wi You can only move tabs to and from windows whose {{WebExtAPIRef('windows.WindowType', 'WindowType')}} is `"normal"`. -When the call moves a tab or tabs in a split view, Firefox moves the tabs in the split view together to preserve the split view. In Chrome, moving a tab away from the other tab in a split view removes the split view. +In Chrome, moving a tab away from the other tab in a split view removes the split view. + +When tabs associated with a split view are moved: + +- When both tabs in a split are specified and they remain adjacent but their order is changed, the tabs are swapped in the split view. +- When both tabs in a split view are specified but are separated by one or more tabs, the tabs are moved and the split view removed. +- When only one of the tabs in a split view is moved: + - In Chrome, moving a tab away from the other tab in the split view removes the split view. Otherwise, the tabs are re-ordered as necessary. + - In Firefox, the other tab is moved to preserve the split view. The tabs are re-ordered if necessary. + + > [!NOTE] + > In Firefox 149, when a call moves a tab or tabs in a split view, the tabs in the split view are moved together to preserve the split view and the order of the tabs is unchanged. + +See also [Working with tab groups and split views](/en-US/docs/Mozilla/Add-ons/WebExtensions/Working_with_the_Tabs_API#working_with_tab_groups_and_split_views). ## Syntax diff --git a/files/en-us/mozilla/add-ons/webextensions/api/tabs/remove/index.md b/files/en-us/mozilla/add-ons/webextensions/api/tabs/remove/index.md index 901a0b1ef08ddba..e18b2ab13844bcb 100644 --- a/files/en-us/mozilla/add-ons/webextensions/api/tabs/remove/index.md +++ b/files/en-us/mozilla/add-ons/webextensions/api/tabs/remove/index.md @@ -13,6 +13,8 @@ If any of the tabs are: - part of a split view, the split view is removed. - the last tab in a group, the group is removed. +See also [Working with tab groups and split views](/en-US/docs/Mozilla/Add-ons/WebExtensions/Working_with_the_Tabs_API#working_with_tab_groups_and_split_views). + ## Syntax ```js-nolint diff --git a/files/en-us/mozilla/add-ons/webextensions/working_with_the_tabs_api/index.md b/files/en-us/mozilla/add-ons/webextensions/working_with_the_tabs_api/index.md index 092d82cda0e7078..54eaecbf077165f 100644 --- a/files/en-us/mozilla/add-ons/webextensions/working_with_the_tabs_api/index.md +++ b/files/en-us/mozilla/add-ons/webextensions/working_with_the_tabs_api/index.md @@ -7,15 +7,16 @@ sidebar: addonsidebar Tabs let a user open several web pages in their browser window and then switch between those web pages. With the Tabs API, you can work with and manipulate these tabs to create utilities that provide users with new ways to work with tabs or to deliver the features of your extension. -In this how-to article we'll look at: +This how-to article look at: - Permissions needed to use the Tabs API. - Discovering more about tabs and their properties using {{WebExtAPIRef("tabs.query")}}. - Creating, duplicating, moving, updating, reloading, and removing tabs. - Manipulating a tab's zoom level. - Manipulating a tab's CSS. +- Manipulating tab groups and split views. -We then conclude by looking at some other, miscellaneous features offered by the API. +The article concludes by looking at some other, miscellaneous features offered by the API. > [!NOTE] > There are some Tab API features covered elsewhere. These are the methods you can use to manipulate tab content with scripts ({{WebExtAPIRef("tabs.connect")}}, {{WebExtAPIRef("tabs.sendMessage")}}, and {{WebExtAPIRef("tabs.executeScript")}}). If you want more information on these methods, see the Concepts article [Content scripts](/en-US/docs/Mozilla/Add-ons/WebExtensions/Content_scripts) and the how-to guide [Modify a web page](/en-US/docs/Mozilla/Add-ons/WebExtensions/Modify_a_web_page). @@ -553,6 +554,25 @@ Let's walk through how it's set up. }); ``` +## Working with tab groups and split views + +Tab functionality provides users with the ability to: + +- [group tabs](https://support.mozilla.org/en-US/kb/tab-groups). +- present two tabs side-by-side in a [split view](https://support.mozilla.org/en-US/kb/split-view-firefox) + +Various tab methods enable you to work with the content of groups and split views, including: + +- {{WebExtAPIRef("tabs.group")}} and {{WebExtAPIRef("tabs.ungroup")}} to create or remove groups. +- {{WebExtAPIRef("tabs.move")}} to move tabs within, into, or out of a group, or within or out of a split view. +- {{WebExtAPIRef("tabs.remove")}} to close tabs in a group, and close the group if the tab was the last one in the group, or in a split view and close the split view. + +> [!NOTE] +> Features to work with a tab group are provided in {{WebExtAPIRef("tabGroups")}}. + +> [!NOTE] +> APIs to enable the creation and removal of split views (without moving or removing the tabs) are being developed under ([Firefox bug 2016928](https://bugzil.la/2016928)). + ## Some other interesting abilities There are a couple of other Tabs API features that don't fit into one of the earlier sections: diff --git a/files/en-us/mozilla/firefox/releases/150/index.md b/files/en-us/mozilla/firefox/releases/150/index.md index e329305c03865f9..942abbd84b7b9ea 100644 --- a/files/en-us/mozilla/firefox/releases/150/index.md +++ b/files/en-us/mozilla/firefox/releases/150/index.md @@ -72,6 +72,10 @@ Firefox 150 is the current [Beta version of Firefox](https://www.firefox.com/en- ## Changes for add-on developers +- The behavior of {{WebExtAPIRef("tabs.move")}} is updated for split views so that: + - The order of tabs in a split view can be swapped. + - When the list of tabs includes both split view tabs and places one or more tabs between them, the tabs are moved apart and the split view closed. + From 65655611dd4b8a8b338cfc85ad9f756b0f1028a9 Mon Sep 17 00:00:00 2001 From: Richard Bloor Date: Fri, 27 Mar 2026 07:25:15 +1300 Subject: [PATCH 2/6] linter nits --- .../mozilla/add-ons/webextensions/api/tabs/move/index.md | 5 ++--- .../add-ons/webextensions/working_with_the_tabs_api/index.md | 4 ++-- 2 files changed, 4 insertions(+), 5 deletions(-) diff --git a/files/en-us/mozilla/add-ons/webextensions/api/tabs/move/index.md b/files/en-us/mozilla/add-ons/webextensions/api/tabs/move/index.md index c07a338daf00f3b..6bf4092e2aaec13 100644 --- a/files/en-us/mozilla/add-ons/webextensions/api/tabs/move/index.md +++ b/files/en-us/mozilla/add-ons/webextensions/api/tabs/move/index.md @@ -19,9 +19,8 @@ When tabs associated with a split view are moved: - When only one of the tabs in a split view is moved: - In Chrome, moving a tab away from the other tab in the split view removes the split view. Otherwise, the tabs are re-ordered as necessary. - In Firefox, the other tab is moved to preserve the split view. The tabs are re-ordered if necessary. - - > [!NOTE] - > In Firefox 149, when a call moves a tab or tabs in a split view, the tabs in the split view are moved together to preserve the split view and the order of the tabs is unchanged. + > [!NOTE] + > In Firefox 149, when a call moves a tab or tabs in a split view, the tabs in the split view are moved together to preserve the split view and the order of the tabs is unchanged. See also [Working with tab groups and split views](/en-US/docs/Mozilla/Add-ons/WebExtensions/Working_with_the_Tabs_API#working_with_tab_groups_and_split_views). diff --git a/files/en-us/mozilla/add-ons/webextensions/working_with_the_tabs_api/index.md b/files/en-us/mozilla/add-ons/webextensions/working_with_the_tabs_api/index.md index 54eaecbf077165f..5a4afce10cc7f5d 100644 --- a/files/en-us/mozilla/add-ons/webextensions/working_with_the_tabs_api/index.md +++ b/files/en-us/mozilla/add-ons/webextensions/working_with_the_tabs_api/index.md @@ -559,9 +559,9 @@ Let's walk through how it's set up. Tab functionality provides users with the ability to: - [group tabs](https://support.mozilla.org/en-US/kb/tab-groups). -- present two tabs side-by-side in a [split view](https://support.mozilla.org/en-US/kb/split-view-firefox) +- present two tabs side-by-side in a [split view](https://support.mozilla.org/en-US/kb/split-view-firefox). -Various tab methods enable you to work with the content of groups and split views, including: +Various tab methods enable you to work with the content of groups and split views, including: - {{WebExtAPIRef("tabs.group")}} and {{WebExtAPIRef("tabs.ungroup")}} to create or remove groups. - {{WebExtAPIRef("tabs.move")}} to move tabs within, into, or out of a group, or within or out of a split view. From 9328cb881e6c906ab8bc9f3d03077351b6dbca72 Mon Sep 17 00:00:00 2001 From: rebloor Date: Fri, 27 Mar 2026 10:18:36 +1300 Subject: [PATCH 3/6] Apply suggestions from review Co-authored-by: github-actions[bot] <41898282+github-actions[bot]@users.noreply.github.com> Co-authored-by: Rob Wu --- .../mozilla/add-ons/webextensions/api/tabs/move/index.md | 6 +++--- .../webextensions/working_with_the_tabs_api/index.md | 2 +- 2 files changed, 4 insertions(+), 4 deletions(-) diff --git a/files/en-us/mozilla/add-ons/webextensions/api/tabs/move/index.md b/files/en-us/mozilla/add-ons/webextensions/api/tabs/move/index.md index 6bf4092e2aaec13..5431540ef46993b 100644 --- a/files/en-us/mozilla/add-ons/webextensions/api/tabs/move/index.md +++ b/files/en-us/mozilla/add-ons/webextensions/api/tabs/move/index.md @@ -10,7 +10,7 @@ Moves one or more tabs to a new position in the same window or to a different wi You can only move tabs to and from windows whose {{WebExtAPIRef('windows.WindowType', 'WindowType')}} is `"normal"`. -In Chrome, moving a tab away from the other tab in a split view removes the split view. +In Chrome, moving a tab away from the other tab in a split view removes the split view. This behavior may change in a future release. When tabs associated with a split view are moved: @@ -19,8 +19,8 @@ When tabs associated with a split view are moved: - When only one of the tabs in a split view is moved: - In Chrome, moving a tab away from the other tab in the split view removes the split view. Otherwise, the tabs are re-ordered as necessary. - In Firefox, the other tab is moved to preserve the split view. The tabs are re-ordered if necessary. - > [!NOTE] - > In Firefox 149, when a call moves a tab or tabs in a split view, the tabs in the split view are moved together to preserve the split view and the order of the tabs is unchanged. + > [!NOTE] + > In Firefox 149, when a call moves a tab or tabs in a split view, the tabs in the split view are moved together to preserve the split view and the order of the tabs is unchanged. See also [Working with tab groups and split views](/en-US/docs/Mozilla/Add-ons/WebExtensions/Working_with_the_Tabs_API#working_with_tab_groups_and_split_views). diff --git a/files/en-us/mozilla/add-ons/webextensions/working_with_the_tabs_api/index.md b/files/en-us/mozilla/add-ons/webextensions/working_with_the_tabs_api/index.md index 5a4afce10cc7f5d..db13db1b2653596 100644 --- a/files/en-us/mozilla/add-ons/webextensions/working_with_the_tabs_api/index.md +++ b/files/en-us/mozilla/add-ons/webextensions/working_with_the_tabs_api/index.md @@ -565,7 +565,7 @@ Various tab methods enable you to work with the content of groups and split view - {{WebExtAPIRef("tabs.group")}} and {{WebExtAPIRef("tabs.ungroup")}} to create or remove groups. - {{WebExtAPIRef("tabs.move")}} to move tabs within, into, or out of a group, or within or out of a split view. -- {{WebExtAPIRef("tabs.remove")}} to close tabs in a group, and close the group if the tab was the last one in the group, or in a split view and close the split view. +- {{WebExtAPIRef("tabs.remove")}} to close tabs in a group, and close the group if the tab was the last one in the group, or in a split view and close the split view. > [!NOTE] > Features to work with a tab group are provided in {{WebExtAPIRef("tabGroups")}}. From 8743634b7cb21e16d91f2fed000ccde0a9ef343c Mon Sep 17 00:00:00 2001 From: Richard Bloor Date: Fri, 27 Mar 2026 10:42:45 +1300 Subject: [PATCH 4/6] Feedback updates --- .../webextensions/api/tabs/move/index.md | 2 +- .../webextensions/api/tabs/remove/index.md | 2 +- .../working_with_the_tabs_api/index.md | 25 ++++++++++++------- .../mozilla/firefox/releases/150/index.md | 4 +-- 4 files changed, 20 insertions(+), 13 deletions(-) diff --git a/files/en-us/mozilla/add-ons/webextensions/api/tabs/move/index.md b/files/en-us/mozilla/add-ons/webextensions/api/tabs/move/index.md index 5431540ef46993b..136731b65e8b8af 100644 --- a/files/en-us/mozilla/add-ons/webextensions/api/tabs/move/index.md +++ b/files/en-us/mozilla/add-ons/webextensions/api/tabs/move/index.md @@ -22,7 +22,7 @@ When tabs associated with a split view are moved: > [!NOTE] > In Firefox 149, when a call moves a tab or tabs in a split view, the tabs in the split view are moved together to preserve the split view and the order of the tabs is unchanged. -See also [Working with tab groups and split views](/en-US/docs/Mozilla/Add-ons/WebExtensions/Working_with_the_Tabs_API#working_with_tab_groups_and_split_views). +See also [Working with tab split views](/en-US/docs/Mozilla/Add-ons/WebExtensions/Working_with_the_Tabs_API#working_with_tab_split_views). ## Syntax diff --git a/files/en-us/mozilla/add-ons/webextensions/api/tabs/remove/index.md b/files/en-us/mozilla/add-ons/webextensions/api/tabs/remove/index.md index e18b2ab13844bcb..c44948a52db8271 100644 --- a/files/en-us/mozilla/add-ons/webextensions/api/tabs/remove/index.md +++ b/files/en-us/mozilla/add-ons/webextensions/api/tabs/remove/index.md @@ -13,7 +13,7 @@ If any of the tabs are: - part of a split view, the split view is removed. - the last tab in a group, the group is removed. -See also [Working with tab groups and split views](/en-US/docs/Mozilla/Add-ons/WebExtensions/Working_with_the_Tabs_API#working_with_tab_groups_and_split_views). +See also [Working with tab groups](/en-US/docs/Mozilla/Add-ons/WebExtensions/Working_with_the_Tabs_API#working_with_tab_groups) and [Working with tab split views](/en-US/docs/Mozilla/Add-ons/WebExtensions/Working_with_the_Tabs_API#working_with_tab_split_views). ## Syntax diff --git a/files/en-us/mozilla/add-ons/webextensions/working_with_the_tabs_api/index.md b/files/en-us/mozilla/add-ons/webextensions/working_with_the_tabs_api/index.md index db13db1b2653596..236a7ec36547e90 100644 --- a/files/en-us/mozilla/add-ons/webextensions/working_with_the_tabs_api/index.md +++ b/files/en-us/mozilla/add-ons/webextensions/working_with_the_tabs_api/index.md @@ -554,24 +554,31 @@ Let's walk through how it's set up. }); ``` -## Working with tab groups and split views +## Working with tab groups -Tab functionality provides users with the ability to: +Tab functionality enables users to create [group tabs](https://support.mozilla.org/en-US/kb/tab-groups). -- [group tabs](https://support.mozilla.org/en-US/kb/tab-groups). -- present two tabs side-by-side in a [split view](https://support.mozilla.org/en-US/kb/split-view-firefox). - -Various tab methods enable you to work with the content of groups and split views, including: +Various tab methods enable you to work with the content of groups, including: - {{WebExtAPIRef("tabs.group")}} and {{WebExtAPIRef("tabs.ungroup")}} to create or remove groups. -- {{WebExtAPIRef("tabs.move")}} to move tabs within, into, or out of a group, or within or out of a split view. -- {{WebExtAPIRef("tabs.remove")}} to close tabs in a group, and close the group if the tab was the last one in the group, or in a split view and close the split view. +- {{WebExtAPIRef("tabs.move")}} to move tabs within, into, or out of a group. +- {{WebExtAPIRef("tabs.remove")}} to close tabs in a group, and close the group if the tab was the last one in the group > [!NOTE] > Features to work with a tab group are provided in {{WebExtAPIRef("tabGroups")}}. +## Working with tab split views + +Tab functionality lets display two tabs side-by-side in a [split view](https://support.mozilla.org/en-US/kb/split-view-firefox). + +Various tab methods enable you to work with the content of groups and split views, including: + +- {{WebExtAPIRef("tabs.move")}} to move tabs within or out of a split view. +- {{WebExtAPIRef("tabs.remove")}} to close a tab in a split view, which closes the split view. + > [!NOTE] -> APIs to enable the creation and removal of split views (without moving or removing the tabs) are being developed under ([Firefox bug 2016928](https://bugzil.la/2016928)). +> APIs to enable the creation and removal of split views (without moving or removing the tabs) are being developed under W3C +web extensions issue [#967](https://github.com/w3c/webextensions/issues/967). ## Some other interesting abilities diff --git a/files/en-us/mozilla/firefox/releases/150/index.md b/files/en-us/mozilla/firefox/releases/150/index.md index 942abbd84b7b9ea..c77428a5a2fba1f 100644 --- a/files/en-us/mozilla/firefox/releases/150/index.md +++ b/files/en-us/mozilla/firefox/releases/150/index.md @@ -73,8 +73,8 @@ Firefox 150 is the current [Beta version of Firefox](https://www.firefox.com/en- ## Changes for add-on developers - The behavior of {{WebExtAPIRef("tabs.move")}} is updated for split views so that: - - The order of tabs in a split view can be swapped. - - When the list of tabs includes both split view tabs and places one or more tabs between them, the tabs are moved apart and the split view closed. + - The order of tabs in a split view can be swapped. ([Firefox bug 2016762](https://bugzil.la/2016762)) + - When the list of tabs includes both split view tabs and places one or more tabs between them, the tabs are moved apart and the split view closed. ([Firefox bug 2022549](https://bugzil.la/2022549)) From 17dad6fe5886dc39b7a736e69627726587b422cd Mon Sep 17 00:00:00 2001 From: Richard Bloor Date: Fri, 27 Mar 2026 10:46:36 +1300 Subject: [PATCH 5/6] joined lines --- .../add-ons/webextensions/working_with_the_tabs_api/index.md | 3 +-- 1 file changed, 1 insertion(+), 2 deletions(-) diff --git a/files/en-us/mozilla/add-ons/webextensions/working_with_the_tabs_api/index.md b/files/en-us/mozilla/add-ons/webextensions/working_with_the_tabs_api/index.md index 236a7ec36547e90..5f0162fbbbd7dbd 100644 --- a/files/en-us/mozilla/add-ons/webextensions/working_with_the_tabs_api/index.md +++ b/files/en-us/mozilla/add-ons/webextensions/working_with_the_tabs_api/index.md @@ -577,8 +577,7 @@ Various tab methods enable you to work with the content of groups and split view - {{WebExtAPIRef("tabs.remove")}} to close a tab in a split view, which closes the split view. > [!NOTE] -> APIs to enable the creation and removal of split views (without moving or removing the tabs) are being developed under W3C -web extensions issue [#967](https://github.com/w3c/webextensions/issues/967). +> APIs to enable the creation and removal of split views (without moving or removing the tabs) are being developed under W3C web extensions issue [#967](https://github.com/w3c/webextensions/issues/967). ## Some other interesting abilities From f4628ff0d2997bec0cee6bd57f06e7085ca2977a Mon Sep 17 00:00:00 2001 From: rebloor Date: Mon, 30 Mar 2026 12:14:12 +1300 Subject: [PATCH 6/6] Apply suggestions from @Rob--W Co-authored-by: Rob Wu --- .../en-us/mozilla/add-ons/webextensions/api/tabs/move/index.md | 2 +- .../add-ons/webextensions/working_with_the_tabs_api/index.md | 2 +- 2 files changed, 2 insertions(+), 2 deletions(-) diff --git a/files/en-us/mozilla/add-ons/webextensions/api/tabs/move/index.md b/files/en-us/mozilla/add-ons/webextensions/api/tabs/move/index.md index 136731b65e8b8af..465fb09f187044d 100644 --- a/files/en-us/mozilla/add-ons/webextensions/api/tabs/move/index.md +++ b/files/en-us/mozilla/add-ons/webextensions/api/tabs/move/index.md @@ -20,7 +20,7 @@ When tabs associated with a split view are moved: - In Chrome, moving a tab away from the other tab in the split view removes the split view. Otherwise, the tabs are re-ordered as necessary. - In Firefox, the other tab is moved to preserve the split view. The tabs are re-ordered if necessary. > [!NOTE] - > In Firefox 149, when a call moves a tab or tabs in a split view, the tabs in the split view are moved together to preserve the split view and the order of the tabs is unchanged. + > In Firefox 149 only, when a call moves a tab or tabs in a split view, the tabs in the split view are moved together to preserve the split view and the order of the tabs is unchanged. See also [Working with tab split views](/en-US/docs/Mozilla/Add-ons/WebExtensions/Working_with_the_Tabs_API#working_with_tab_split_views). diff --git a/files/en-us/mozilla/add-ons/webextensions/working_with_the_tabs_api/index.md b/files/en-us/mozilla/add-ons/webextensions/working_with_the_tabs_api/index.md index 5f0162fbbbd7dbd..455a3b54c799145 100644 --- a/files/en-us/mozilla/add-ons/webextensions/working_with_the_tabs_api/index.md +++ b/files/en-us/mozilla/add-ons/webextensions/working_with_the_tabs_api/index.md @@ -577,7 +577,7 @@ Various tab methods enable you to work with the content of groups and split view - {{WebExtAPIRef("tabs.remove")}} to close a tab in a split view, which closes the split view. > [!NOTE] -> APIs to enable the creation and removal of split views (without moving or removing the tabs) are being developed under W3C web extensions issue [#967](https://github.com/w3c/webextensions/issues/967). +> APIs to enable the creation and removal of split views (without moving or removing the tabs) are being developed under [issue #967](https://github.com/w3c/webextensions/issues/967) of W3C's WebExtensions Community Group (WECG). ## Some other interesting abilities