diff --git a/docs/configuration.asciidoc b/docs/configuration.asciidoc
index 711b30389..c0f8319ae 100644
--- a/docs/configuration.asciidoc
+++ b/docs/configuration.asciidoc
@@ -142,10 +142,12 @@ of the deployed revision, e.g. the output of `git rev-parse HEAD`.
 
 The name of the environment this service is deployed in, e.g. "production" or "staging".
 
-WARNING: the APM UI does not currently group services by environment, so metrics for
-all environments will be combined. Consider changing the service name if you want to
-see the metrics separated by environment. Alternatively, you can use the search bar
-introduced with the 6.4 release.
+Environments allow you to easily filter data on a global level in the APM UI.
+It's important to be consistent when naming environments across agents.
+See {kibana-ref}/filters.html#environment-selector[environment selector] in the Kibana UI for more information.
+
+NOTE: This feature is fully supported in the APM UI in Kibana versions >= 7.2.
+You must use the query bar to filter for a specific environment in versions prior to 7.2.
 
 [float]
 [[config-active]]