diff --git a/data/org.freedesktop.portal.GlobalShortcuts.xml b/data/org.freedesktop.portal.GlobalShortcuts.xml
index 51eef116e..20800f008 100644
--- a/data/org.freedesktop.portal.GlobalShortcuts.xml
+++ b/data/org.freedesktop.portal.GlobalShortcuts.xml
@@ -67,11 +67,15 @@
 
         The following results get returned via the :ref:`org.freedesktop.portal.Request::Response` signal:
 
-        * ``session_handle`` (``o``)
+        * ``session_handle`` (``s``)
 
           The session handle. An object path for the
           org.freedesktop.portal.Session object representing the created
           session.
+
+          .. note::
+            The ``session_handle`` is an object path that was erroneously implemented
+            as ``s``. For backwards compatibility it will remain this type.
     -->
     <method name="CreateSession">
       <arg type="a{sv}" name="options" direction="in"/>
diff --git a/data/org.freedesktop.portal.Inhibit.xml b/data/org.freedesktop.portal.Inhibit.xml
index eeb870ba9..c212d035b 100644
--- a/data/org.freedesktop.portal.Inhibit.xml
+++ b/data/org.freedesktop.portal.Inhibit.xml
@@ -99,12 +99,16 @@
 
         The following results get returned via the :ref:`org.freedesktop.portal.Request::Response` signal:
 
-        * ``session_handle`` (``o``)
+        * ``session_handle`` (``s``)
 
           The session handle. An object path for the
           :ref:`org.freedesktop.portal.Session` object representing the created
           session.
 
+          .. note::
+            The ``session_handle`` is an object path that was erroneously implemented
+            as ``s``. For backwards compatibility it will remain this type.
+
         This method was added in version 2 of this interface.
     -->
     <method name="CreateMonitor">
diff --git a/data/org.freedesktop.portal.RemoteDesktop.xml b/data/org.freedesktop.portal.RemoteDesktop.xml
index dcd4cc245..7ff377029 100644
--- a/data/org.freedesktop.portal.RemoteDesktop.xml
+++ b/data/org.freedesktop.portal.RemoteDesktop.xml
@@ -67,11 +67,15 @@
 
         The following results get returned via the :ref:`org.freedesktop.portal.Request::Response` signal:
 
-        * ``session_handle`` (``o``)
+        * ``session_handle`` (``s``)
 
           The session handle. An object path for the
           :ref:`org.freedesktop.portal.Session` object representing the created
           session.
+
+          .. note::
+            The ``session_handle`` is an object path that was erroneously implemented
+            as ``s``. For backwards compatibility it will remain this type.
     -->
     <method name="CreateSession">
       <arg type="a{sv}" name="options" direction="in"/>
diff --git a/data/org.freedesktop.portal.ScreenCast.xml b/data/org.freedesktop.portal.ScreenCast.xml
index d2c7baf10..7387621ba 100644
--- a/data/org.freedesktop.portal.ScreenCast.xml
+++ b/data/org.freedesktop.portal.ScreenCast.xml
@@ -54,11 +54,15 @@
 
         The following results get returned via the :ref:`org.freedesktop.portal.Request::Response` signal:
 
-        * ``session_handle`` (``o``)
+        * ``session_handle`` (``s``)
 
           The session handle. An object path for the
           :ref:`org.freedesktop.portal.Session` object representing the created
           session.
+
+          .. note::
+            The ``session_handle`` is an object path that was erroneously implemented
+            as ``s``. For backwards compatibility it will remain this type.
     -->
     <method name="CreateSession">
       <arg type="a{sv}" name="options" direction="in"/>