diff --git a/libraries/matrix/api/src/main/kotlin/io/element/android/libraries/matrix/api/core/SessionId.kt b/libraries/matrix/api/src/main/kotlin/io/element/android/libraries/matrix/api/core/SessionId.kt
index 6009aa5c03..7bb6e27a5e 100644
--- a/libraries/matrix/api/src/main/kotlin/io/element/android/libraries/matrix/api/core/SessionId.kt
+++ b/libraries/matrix/api/src/main/kotlin/io/element/android/libraries/matrix/api/core/SessionId.kt
@@ -16,4 +16,7 @@
 
 package io.element.android.libraries.matrix.api.core
 
+/**
+ * The [UserId] of the currently logged in user.
+ */
 typealias SessionId = UserId
diff --git a/libraries/matrix/api/src/main/kotlin/io/element/android/libraries/matrix/api/core/UserId.kt b/libraries/matrix/api/src/main/kotlin/io/element/android/libraries/matrix/api/core/UserId.kt
index e153834501..e72af8596a 100644
--- a/libraries/matrix/api/src/main/kotlin/io/element/android/libraries/matrix/api/core/UserId.kt
+++ b/libraries/matrix/api/src/main/kotlin/io/element/android/libraries/matrix/api/core/UserId.kt
@@ -19,6 +19,11 @@ package io.element.android.libraries.matrix.api.core
 import io.element.android.libraries.matrix.api.BuildConfig
 import java.io.Serializable
 
+/**
+ * A [String] holding a valid Matrix user ID.
+ *
+ * https://spec.matrix.org/v1.8/appendices/#user-identifiers
+ */
 @JvmInline
 value class UserId(val value: String) : Serializable {