diff --git a/src/lib/elementary/elm_widget.eo b/src/lib/elementary/elm_widget.eo
index 380cd34950..17214939ed 100644
--- a/src/lib/elementary/elm_widget.eo
+++ b/src/lib/elementary/elm_widget.eo
@@ -54,6 +54,17 @@ abstract Elm.Widget (Efl.Canvas.Group, Elm.Interface.Atspi_Accessible,
                [[A canvas object (often a $Efl.Canvas.Layout object).]]
          }
       }
+      @property disabled {
+         [[Whether the widget is enabled (accepts and reacts to user inputs).
+
+           Each widget may handle the disabled state differently, but overall
+           disabled widgets shall not respond to any input events. This is
+           $false by default, meaning the widget is enabled.
+         ]]
+         values {
+            disabled: bool(false); [[$true if the widget is disabled.]]
+         }
+      }
 
       @property focus {
       	 [[Focus property]]
@@ -96,12 +107,6 @@ abstract Elm.Widget (Efl.Canvas.Group, Elm.Interface.Atspi_Accessible,
             th: ptr(Elm.Theme) @nullable; [[Elementary theme]]
          }
       }
-      @property disabled {
-      	 [[Enabled / disabled property]]
-         values {
-            disabled: bool; [[$true if the widget is disabled, $false otherwise]]
-         }
-      }
       @property highlight_ignore {
       	 [[Highlight ignore]]
          values {