diff --git a/packages/types/src/documents/app/row.ts b/packages/types/src/documents/app/row.ts
index ca9b11ffe5..e85400804b 100644
--- a/packages/types/src/documents/app/row.ts
+++ b/packages/types/src/documents/app/row.ts
@@ -100,14 +100,16 @@ export enum FieldType {
    */
   BIGINT = "bigint",
   /**
-   * a JSON type, called User within Budibase. This type is used to represent a link to an internal Budibase
+   * an JSON type, called Users within Budibase. It will hold an array of strings. This type is used to represent a link to an internal Budibase
    * resource, like a user or group, today only users are supported. This type will be represented as an
    * array of internal resource IDs (e.g. user IDs) within the row - this ID list will be enriched with
    * the full resources when rows are returned from the API. The full resources can be input to the API, or
    * an array of resource IDs, the API will squash these down and validate them before saving the row.
    */
   BB_REFERENCE = "bb_reference",
-  // TODO
+  /**
+   * a string type, called User within Budibase. Same logic as `bb_reference`, storing a single id as string instead of an array
+   */
   BB_REFERENCE_SINGLE = "bb_reference_single",
 }