diff --git a/docs/reference/release-notes/6.3.asciidoc b/docs/reference/release-notes/6.3.asciidoc
index e5f50afb1a1a6..80d23885ca686 100644
--- a/docs/reference/release-notes/6.3.asciidoc
+++ b/docs/reference/release-notes/6.3.asciidoc
@@ -4,6 +4,8 @@
 [float]
 === Known issues
 
+Upgrades from any 5.x version will fail for indexes which are prepared using the <<indices-synced-flush, _synced flush API>>, or were automatically sync-flushed due to inactivity. If upgrading from those versions, please wait for 6.3.1 to be released.
+
 Clusters with a Gold or Platinum license that are upgrading to 6.3 will need to explicitly set
 `xpack.security.enabled: true` in `elasticsearch.yml` to upgrade successfully.
 If this value is not set, the cluster will be unable to form after upgrade.