diff --git a/metricbeat/module/http/json/_meta/docs.asciidoc b/metricbeat/module/http/json/_meta/docs.asciidoc
index 5c64c01acc3..dc4b8700fba 100644
--- a/metricbeat/module/http/json/_meta/docs.asciidoc
+++ b/metricbeat/module/http/json/_meta/docs.asciidoc
@@ -45,6 +45,11 @@ Here the response from `date.jsontest.com` is returned in the configured `http_j
 
 It is required to set a namespace in the general module config section.
 
+[float]
+==== json.is_array
+With this configuration enabled the `json` metriset expects the JSON structure returned by the HTTP endpoint to be an array. Further,
+it creates separate events for each element in the array.
+
 [float]
 ==== request.enabled
 With this configuration enabled additional information about the request are included. This includes the following information: