Modifies the succession relationship for a group of tabs.


browser.tabs.moveInSuccession([1, 3, 5, 7, 2, 9], 4, {insert:true})


array of integer. An array of tab IDs. The order of the elements in the array defines the relationship of the tabs.
integer. The ID of the tab that will be the successor of the last tab in the tabIds array.
options Optional
append Optional
boolean. Determines whether to move the tabs in tabIds before or after tabId in the succession. If false, the tabs are inserted before tabId, if true, the tabs are inserted after tabId. Defaults to false.
insert Optional
boolean. Determines whether to link up the current predecessors or successor (depending on options.append) of tabId to the other side of the chain after it is prepended or appended. If true, one of the following happens: if options.append is false, the first tab in the array is set as the successor of any current predecessors of tabId; if options.append is true, the current successor of tabId is set as the successor of the last tab in the array. Defaults to false.

Browser compatibility

Update compatibility data on GitHub
ChromeEdgeFirefoxOperaFirefox for Android
Basic supportChrome No support NoEdge No support NoFirefox Full support 65Opera No support NoFirefox Android No support No


Full support  
Full support
No support  
No support

Document Tags and Contributors

Contributors to this page: irenesmith
Last updated by: irenesmith,