diff --git a/changelog.d/11989.feature b/changelog.d/11989.feature
new file mode 100644
index 0000000000000000000000000000000000000000..5975281a168e2737685dfb027c436e5c78085082
--- /dev/null
+++ b/changelog.d/11989.feature
@@ -0,0 +1 @@
+Support the stable API endpoint for [MSC3283](https://github.com/matrix-org/matrix-doc/pull/3283): new settings in `/capabilities` endpoint.
\ No newline at end of file
diff --git a/docs/upgrade.md b/docs/upgrade.md
index a5da0076c656c53bbc6dd19be2d78b48f1ecf8d8..477d7d0e81c847942bc94f9eda0d99d0bdf52f3e 100644
--- a/docs/upgrade.md
+++ b/docs/upgrade.md
@@ -129,7 +129,7 @@ The old `capabilities`
 - `org.matrix.msc3283.set_avatar_url` and
 - `org.matrix.msc3283.3pid_changes`
 
-are deprecated and scheduled to be removed in Synapse v1.(next+1).0.
+are deprecated and scheduled to be removed in Synapse v1.54.0.
 
 The new `capabilities`
 - `m.set_displayname`,