diff --git a/lib/public/UserStatus/IManager.php b/lib/public/UserStatus/IManager.php
index 9cc8eaad8ee4e..83aaeca62c35a 100644
--- a/lib/public/UserStatus/IManager.php
+++ b/lib/public/UserStatus/IManager.php
@@ -39,7 +39,7 @@ interface IManager {
 	 * Gets the statuses for all users in $users
 	 *
 	 * @param string[] $userIds
-	 * @return IUserStatus[]
+	 * @return array<string, IUserStatus> array key being the userid, users without a status will not be in the returned array
 	 * @since 20.0.0
 	 */
 	public function getUserStatuses(array $userIds): array;
diff --git a/lib/public/UserStatus/IProvider.php b/lib/public/UserStatus/IProvider.php
index 0bc31a1589df6..77031471c9af3 100644
--- a/lib/public/UserStatus/IProvider.php
+++ b/lib/public/UserStatus/IProvider.php
@@ -35,7 +35,7 @@ interface IProvider {
 	 * Gets the statuses for all users in $users
 	 *
 	 * @param string[] $userIds
-	 * @return IUserStatus[]
+	 * @return array<string, IUserStatus> array key being the userid, users without a status will not be in the returned array
 	 * @since 20.0.0
 	 */
 	public function getUserStatuses(array $userIds):array;