diff --git a/doc/src/content/xdocs/idl.xml b/doc/src/content/xdocs/idl.xml
index 0d5e5da9e46..e8c1b81a0f4 100644
--- a/doc/src/content/xdocs/idl.xml
+++ b/doc/src/content/xdocs/idl.xml
@@ -252,6 +252,14 @@ record Job {
   time_ms submitTime;
   timestamp_ms finishTime;
   decimal(9,2) finishRatio;
+}
+        </source>
+        <p>Logical types can also be specified via an annotation, which is useful for logical types for which a keyword does not exist:</p>
+        <source>
+record Job {
+  string jobid;
+  @logicalType("timestamp-micros")
+  long finishTime;
 }
         </source>
       </section>