diff --git a/core/lib/Drupal/Core/Render/Element/ImageButton.php b/core/lib/Drupal/Core/Render/Element/ImageButton.php
index a7d8be3..8df4157 100644
--- a/core/lib/Drupal/Core/Render/Element/ImageButton.php
+++ b/core/lib/Drupal/Core/Render/Element/ImageButton.php
@@ -8,6 +8,17 @@
 /**
  * Provides a form element for a submit button with an image.
  *
+ * Properties:
+ * - #src: The image path to be shown on the button.
+ *
+ * Usage Example:
+ * @code
+ * $form['actions']['preview'] = array(
+ *   '#type' => 'image_button',
+ *   '#src' => 'public://preview.png',
+ * );
+ * @endcode
+ *
  * @FormElement("image_button")
  */
 class ImageButton extends Submit {