diff --git a/docs/reference/transform/apis/update-transform.asciidoc b/docs/reference/transform/apis/update-transform.asciidoc
index e29343ebbd8..3e98a6d0c47 100644
--- a/docs/reference/transform/apis/update-transform.asciidoc
+++ b/docs/reference/transform/apis/update-transform.asciidoc
@@ -40,9 +40,11 @@ runs with those privileges.
 
 IMPORTANT:  You must use {kib} or this API to update a {transform}.
             Do not update a {transform} directly via
-            `.data-frame-internal*` indices using the Elasticsearch index API.
+            `.transform-internal*` indices using the Elasticsearch index API.
             If {es} {security-features} are enabled, do not give users any
-            privileges on `.data-frame-internal*` indices.
+            privileges on `.transform-internal*` indices. If you used transforms
+            prior 7.5, also do not give users any privileges on
+            `.data-frame-internal*` indices.
 
 [[update-transform-path-parms]]
 ==== {api-path-parms-title}