diff --git a/doc/changelog.asciidoc b/doc/changelog.asciidoc
index aaa6a45f7..4931c1199 100644
--- a/doc/changelog.asciidoc
+++ b/doc/changelog.asciidoc
@@ -49,6 +49,8 @@ Added
 - New `content.windowed_fullscreen` setting to show e.g. a fullscreened video in
   the window without fullscreening that window.
 - New `:edit-command` command to edit the commandline in an editor.
+- New `tabs.persist_mode_on_change` setting to keep the current mode when
+  switching tabs.
 
 Changed
 ~~~~~~~
diff --git a/doc/help/settings.asciidoc b/doc/help/settings.asciidoc
index 8ffc2407c..d1fcf2822 100644
--- a/doc/help/settings.asciidoc
+++ b/doc/help/settings.asciidoc
@@ -239,6 +239,7 @@
 |<<tabs.new_position.related,tabs.new_position.related>>|Position of new tabs opened from another tab.
 |<<tabs.new_position.unrelated,tabs.new_position.unrelated>>|Position of new tabs which aren't opened from another tab.
 |<<tabs.padding,tabs.padding>>|Padding (in pixels) around text for tabs.
+|<<tabs.persist_mode_on_change,tabs.persist_mode_on_change>>|When switching tabs, retain the current mode.
 |<<tabs.pinned.shrink,tabs.pinned.shrink>>|Shrink pinned tabs down to their contents.
 |<<tabs.position,tabs.position>>|Position of the tab bar.
 |<<tabs.select_on_remove,tabs.select_on_remove>>|Which tab to select when the focused tab is removed.
@@ -2799,6 +2800,14 @@ Default:
 - +pass:[right]+: +pass:[5]+
 - +pass:[top]+: +pass:[0]+
 
+[[tabs.persist_mode_on_change]]
+=== tabs.persist_mode_on_change
+When switching tabs, retain the current mode.
+
+Type: <<types,Bool>>
+
+Default: +pass:[false]+
+
 [[tabs.pinned.shrink]]
 === tabs.pinned.shrink
 Shrink pinned tabs down to their contents.