From 0051295e94384736d1cba9aa8499cdeffafdd4b0 Mon Sep 17 00:00:00 2001
From: Tom Foster <tom@tcpip.uk>
Date: Thu, 31 Jul 2025 14:20:39 +0100
Subject: [PATCH] Update data/api/client-server/capabilities.yaml

Co-authored-by: Johannes Marbach <n0-0ne+github@mailbox.org>
---
 data/api/client-server/capabilities.yaml | 4 ++++
 1 file changed, 4 insertions(+)

diff --git a/data/api/client-server/capabilities.yaml b/data/api/client-server/capabilities.yaml
index 71d8618c..1af8360a 100644
--- a/data/api/client-server/capabilities.yaml
+++ b/data/api/client-server/capabilities.yaml
@@ -78,6 +78,10 @@ paths:
                         description: |
                           **Deprecated:** Capability to indicate if the user can change their display name.
                           Refer to `m.profile_fields` for extended profile management.
+                          
+                          For backwards compatibility, servers that directly or indirectly include the
+                          `displayname` profile field in the `m.profile_fields` capability MUST also
+                          set this capability accordingly.
                       m.set_avatar_url:
                         deprecated: true
                         $ref: '#/components/schemas/booleanCapability'