diff --git a/types/office-js-preview/index.d.ts b/types/office-js-preview/index.d.ts
index 6f922b01c83ac8..7da13628f6d3ef 100644
--- a/types/office-js-preview/index.d.ts
+++ b/types/office-js-preview/index.d.ts
@@ -4881,6 +4881,11 @@ declare namespace Office {
         platform: Office.PlatformType;
         /**
          * Gets the version of Office on which the add-in is running.
+         *
+         * @remarks
+         * In Office on Windows, the value returned by the `version` property uses the format 16.0.\<build\>.\<revision\>.
+         * To compare a version shown as Version xxxx (Build xxxxx.xxxxx) with the `version` value, use the full build number (\<build\>.\<revision\>).
+         * For example, in Version 2603 (Build 19822.20000), use 19822.20000 for comparison.
          */
         version: string;
     }
diff --git a/types/office-js/index.d.ts b/types/office-js/index.d.ts
index 56f5836b14f076..611cd1edbdb55f 100644
--- a/types/office-js/index.d.ts
+++ b/types/office-js/index.d.ts
@@ -4881,6 +4881,11 @@ declare namespace Office {
         platform: Office.PlatformType;
         /**
         * Gets the version of Office on which the add-in is running.
+        *
+        * @remarks
+        * In Office on Windows, the value returned by the `version` property uses the format 16.0.\<build\>.\<revision\>.
+        * To compare a version shown as Version xxxx (Build xxxxx.xxxxx) with the `version` value, use the full build number (\<build\>.\<revision\>).
+        * For example, in Version 2603 (Build 19822.20000), use 19822.20000 for comparison.
         */
         version: string;
     }