diff --git a/instrumentation/kafka/kafka-clients/kafka-clients-0.11/metadata.yaml b/instrumentation/kafka/kafka-clients/kafka-clients-0.11/metadata.yaml
index 7b42919bb1b8..5da6ed1a9c89 100644
--- a/instrumentation/kafka/kafka-clients/kafka-clients-0.11/metadata.yaml
+++ b/instrumentation/kafka/kafka-clients/kafka-clients-0.11/metadata.yaml
@@ -1,3 +1,6 @@
+description: >
+  This instrumentation provides messaging spans and metrics for Apache Kafka 0.11 clients.
+  It automatically traces message production and consumption, propagates context, and emits metrics for production and consumption.
 configurations:
   - name: otel.instrumentation.kafka.producer-propagation.enabled
     description: Enable context propagation for kafka message producers.
@@ -7,3 +10,11 @@ configurations:
     description: Enables the capture of the experimental consumer attribute "kafka.record.queue_time_ms"
     type: boolean
     default: false
+  - name: otel.instrumentation.messaging.experimental.capture-headers
+    description: A comma-separated list of header names to capture as span attributes.
+    type: list
+    default: ''
+  - name: otel.instrumentation.messaging.experimental.receive-telemetry.enabled
+    description: Enables experimental receive telemetry for Kafka instrumentation.
+    type: boolean
+    default: false
diff --git a/instrumentation/kafka/kafka-clients/kafka-clients-2.6/metadata.yaml b/instrumentation/kafka/kafka-clients/kafka-clients-2.6/metadata.yaml
new file mode 100644
index 000000000000..5898d2e01872
--- /dev/null
+++ b/instrumentation/kafka/kafka-clients/kafka-clients-2.6/metadata.yaml
@@ -0,0 +1,2 @@
+description: >
+  This instrumentation provides a library integeration that enables messaging spans and metrics for Apache Kafka 2.6+ clients.