diff --git a/docs/basic.rst b/docs/basic.rst
index 0a7ce81d7..161318fb8 100644
--- a/docs/basic.rst
+++ b/docs/basic.rst
@@ -104,6 +104,8 @@ or another OS window::
     map ctrl+f3 detach_window tab-prev
     # moves the window into the tab at the left of the active tab
     map ctrl+f3 detach_window tab-left
+    # moves the window into a new tab created to the left of the active tab
+    map ctrl+f3 detach_window new-tab-left
     # asks which tab to move the window into
     map ctrl+f4 detach_window ask
 
diff --git a/docs/changelog.rst b/docs/changelog.rst
index f76333ef6..0629eb17c 100644
--- a/docs/changelog.rst
+++ b/docs/changelog.rst
@@ -55,6 +55,8 @@ Detailed list of changes
 - macOS: The command line args from :file:`macos-launch-services-cmdline` are now
   prefixed to any args from ``open --args`` rather than overwriting them (:iss:`7135`)
 
+- Allow specifying where the new tab is created for :ac:`detach_window` (:pull:`7134`)
+
 
 0.32.2 [2024-02-12]
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~