diff --git a/src/trait_manager/model/Trait.ts b/src/trait_manager/model/Trait.ts
index b65d58ea9..d73e5856f 100644
--- a/src/trait_manager/model/Trait.ts
+++ b/src/trait_manager/model/Trait.ts
@@ -44,32 +44,79 @@ export interface TraitProperties {
    */
   changeProp?: boolean;
 
-  attributes?: Record<string, any>;
+  /**
+   * Instead of relying on component props/attributes, define your own
+   * logic on how to get the trait value.
+   */
+  getValue?: (props: { editor: Editor; trait: Trait; component: Component }) => any;
+
+  /**
+   * In conjunction with the `getValue`, define your own logic for updating the trait value.
+   */
+  setValue?: (props: {
+    value: any;
+    editor: Editor;
+    trait: Trait;
+    component: Component;
+    partial: boolean;
+    options: TraitSetValueOptions;
+    emitUpdate: () => void;
+  }) => void;
+
+  /**
+   * Custom true value for checkbox type.
+   * @default 'true'
+   */
   valueTrue?: string;
+
+  /**
+   * Custom false value for checkbox type.
+   * * @default 'false'
+   */
   valueFalse?: string;
+
+  /**
+   * Minimum number value for number type.
+   */
   min?: number;
+
+  /**
+   * Maximum number value for number type.
+   */
   max?: number;
   unit?: string;
+
+  /**
+   * Number of steps for number type.
+   */
   step?: number;
   value?: any;
   target?: Component;
   default?: any;
+
+  /**
+   * Placeholder to show inside the input.
+   */
   placeholder?: string;
-  command?: string | ((editor: Editor, trait: Trait) => any);
+
+  /**
+   * Array of options for the select type.
+   */
   options?: Record<string, any>[];
-  labelButton?: string;
+
+  /**
+   * Label text to use for the button type.
+   */
   text?: string;
+  labelButton?: string;
+
+  /**
+   * Command to use for the button type.
+   */
+  command?: string | ((editor: Editor, trait: Trait) => any);
+
   full?: boolean;
-  getValue?: (props: { editor: Editor; trait: Trait; component: Component }) => any;
-  setValue?: (props: {
-    value: any;
-    editor: Editor;
-    trait: Trait;
-    component: Component;
-    partial: boolean;
-    options: TraitSetValueOptions;
-    emitUpdate: () => void;
-  }) => void;
+  attributes?: Record<string, any>;
 }
 
 interface TraitSetValueOptions {