diff --git a/src/qmlcontrols/kquickcontrols/ColorButton.qml b/src/qmlcontrols/kquickcontrols/ColorButton.qml
--- a/src/qmlcontrols/kquickcontrols/ColorButton.qml
+++ b/src/qmlcontrols/kquickcontrols/ColorButton.qml
@@ -27,6 +27,16 @@
  *
  * This widget can be used to display or allow user selection of a color.
  *
+ * Example usage:
+ * @code
+ * import org.kde.kquickcontrols 2.0
+ *
+ * ColorButton {
+ *   [...]
+ *   onColorChanged: console.log(color)
+ * }
+ * @endcode
+ *
  * @inherits QtQuick.Controls.Button
  */
 QtControls.Button {