diff --git a/docs/changelog.rst b/docs/changelog.rst
index b3d8fcd01..dc64a835b 100644
--- a/docs/changelog.rst
+++ b/docs/changelog.rst
@@ -15,6 +15,13 @@ To update |kitty|, :doc:`follow the instructions <binary>`.
 - Tall and Fat layouts: Add mappable actions to increase or decrease the number
   of full size windows (:iss:`2688`)
 
+- Allow sending the back and forward mouse buttons to terminal applications
+  (:pull:`2742`)
+
+- **Backwards incompatibility**: The numbers used to encode mouse buttons
+  for the ``send_mouse_event`` function that can be used in kittens have
+  been changed (see :ref:`send_mouse_event`).
+
 - Add an option :opt:`confirm_os_window_close` to ask for confirmation
   when closing an OS window with multiple kitty windows.
 
diff --git a/docs/kittens/custom.rst b/docs/kittens/custom.rst
index a8f847226..415a316c8 100644
--- a/docs/kittens/custom.rst
+++ b/docs/kittens/custom.rst
@@ -132,6 +132,8 @@ layout, by simply adding the line::
 To the ``handle_result()`` function, above.
 
 
+.. _send_mouse_event:
+
 Sending mouse events
 --------------------