diff --git a/packages/cmk-plugin-apis/cmk/rulesets/v1/form_specs/_basic.py b/packages/cmk-plugin-apis/cmk/rulesets/v1/form_specs/_basic.py
index 67977a296dc..c91af370ec4 100644
--- a/packages/cmk-plugin-apis/cmk/rulesets/v1/form_specs/_basic.py
+++ b/packages/cmk-plugin-apis/cmk/rulesets/v1/form_specs/_basic.py
@@ -281,6 +281,9 @@ class Percentage(FormSpec[float]):
     ***************
     **Type**: ``float``
 
+    The value represents the percentage directly, not as a fraction, eg. a value
+    of 80% is represented as 80.0
+
     Arguments:
     **********
     """