diff --git a/changelogs/client_server/newsfragments/1916.clarification b/changelogs/client_server/newsfragments/1916.clarification
new file mode 100644
index 00000000..936c3111
--- /dev/null
+++ b/changelogs/client_server/newsfragments/1916.clarification
@@ -0,0 +1 @@
+Improve wording of the unauthenticated media deprecation box. Contributed by @HarHarLinks.
diff --git a/content/client-server-api/modules/content_repo.md b/content/client-server-api/modules/content_repo.md
index a0138156..c9ac06d7 100644
--- a/content/client-server-api/modules/content_repo.md
+++ b/content/client-server-api/modules/content_repo.md
@@ -49,8 +49,9 @@ mxc://<server-name>/<media-id>
 Clients can access the content repository using the following endpoints.
 
 {{% boxes/added-in-paragraph %}}
-{{< changed-in v="1.11" >}} Clients SHOULD NOT use the deprecated media endpoints
-described below. Instead, they SHOULD use the new endpoints which require authentication.
+{{< changed-in v="1.11" >}} A number of endpoints under the /_matrix/media hierarchy
+have been deprecated and replaced with new endpoints which require authentication.
+The deprecated endpoints are marked in the section below.
 {{% /boxes/added-in-paragraph %}}
 
 {{% boxes/warning %}}