diff --git a/docs/modules/ROOT/pages/insert-field-action.adoc b/docs/modules/ROOT/pages/insert-field-action.adoc
index 21216aa4b..64d80aef8 100644
--- a/docs/modules/ROOT/pages/insert-field-action.adoc
+++ b/docs/modules/ROOT/pages/insert-field-action.adoc
@@ -5,7 +5,13 @@
 
 *Support Level for this Kamelet is: "Preview"*
 
-Adds a custom field with a constant value to the message in transit
+Adds a custom field with a constant value to the message in transit.
+
+This action works with Json Object. So it will expect a Json Array or a Json Object.
+
+If for example you have an array like '{ "foo":"John", "bar":30 }' and your action has been configured with field as 'element' and value as 'hello', you'll get '{ "foo":"John", "bar":30, "element":"hello" }'
+
+No headers mapping supported, only constant values.
 
 == Configuration Options
 
diff --git a/insert-field-action.kamelet.yaml b/insert-field-action.kamelet.yaml
index 26988c96c..732c267d1 100644
--- a/insert-field-action.kamelet.yaml
+++ b/insert-field-action.kamelet.yaml
@@ -13,7 +13,14 @@ metadata:
 spec:
   definition:
     title: "Insert Field Action"
-    description: "Adds a custom field with a constant value to the message in transit"
+    description: |-
+      Adds a custom field with a constant value to the message in transit.
+
+      This action works with Json Object. So it will expect a Json Array or a Json Object.
+
+      If for example you have an array like '{ "foo":"John", "bar":30 }' and your action has been configured with field as 'element' and value as 'hello', you'll get '{ "foo":"John", "bar":30, "element":"hello" }'
+
+      No headers mapping supported, only constant values.
     required:
       - field
       - value
diff --git a/library/camel-kamelets/src/main/resources/kamelets/insert-field-action.kamelet.yaml b/library/camel-kamelets/src/main/resources/kamelets/insert-field-action.kamelet.yaml
index 26988c96c..732c267d1 100644
--- a/library/camel-kamelets/src/main/resources/kamelets/insert-field-action.kamelet.yaml
+++ b/library/camel-kamelets/src/main/resources/kamelets/insert-field-action.kamelet.yaml
@@ -13,7 +13,14 @@ metadata:
 spec:
   definition:
     title: "Insert Field Action"
-    description: "Adds a custom field with a constant value to the message in transit"
+    description: |-
+      Adds a custom field with a constant value to the message in transit.
+
+      This action works with Json Object. So it will expect a Json Array or a Json Object.
+
+      If for example you have an array like '{ "foo":"John", "bar":30 }' and your action has been configured with field as 'element' and value as 'hello', you'll get '{ "foo":"John", "bar":30, "element":"hello" }'
+
+      No headers mapping supported, only constant values.
     required:
       - field
       - value