diff --git a/UPGRADING b/UPGRADING
index 222b30b3e98..8625303aac0 100644
--- a/UPGRADING
+++ b/UPGRADING
@@ -23,6 +23,10 @@ PHP 8.1 UPGRADE NOTES
   . The fileinfo functions now accept and return, respectively, finfo objects
     instead of resources.
 
+- IMAP:
+  . The IMAP functions now accept and return, respectively, IMAPConnection objects
+    instead of resources.
+
 - MySQLi:
   . mysqli_fetch_fields() and mysqli_fetch_field_direct() will now always return
     zero for max_length. You can compute this information by iterating over the