diff --git a/web/packages/media/collection.ts b/web/packages/media/collection.ts
index e658ec1767..a813afaed3 100644
--- a/web/packages/media/collection.ts
+++ b/web/packages/media/collection.ts
@@ -27,6 +27,13 @@ export interface CollectionUser {
 }
 
 export interface EncryptedCollection {
+    /**
+     * The collection's globally unique ID.
+     *
+     * The collection's ID is a integer assigned by remote as the identifier for
+     * an {@link Collection} when it is created. It is globally unique across
+     * all collections on an Ente instance (i.e., it is not scoped to a user).
+     */
     id: number;
     owner: CollectionUser;
     // collection name was unencrypted in the past, so we need to keep it as optional
diff --git a/web/packages/media/file.ts b/web/packages/media/file.ts
index 767c86f5ef..f087dbb17e 100644
--- a/web/packages/media/file.ts
+++ b/web/packages/media/file.ts
@@ -66,11 +66,11 @@ export type EncryptedMagicMetadata = MagicMetadataCore<string>;
 
 export interface EncryptedEnteFile {
     /**
-     * The file's ID.
+     * The file's globally unique ID.
      *
-     * The file's ID is a integer assigned by remote that is unique across all
-     * files stored by an Ente instance. That is, the file ID is a global unique
-     * identifier for this {@link EnteFile}.
+     * The file's ID is a integer assigned by remote as the identifier for an
+     * {@link EnteFile} when it is created. It is globally unique across all
+     * files stored by an Ente instance, and is not scoped to the current user.
      */
     id: number;
     /**