diff --git a/docs/releases/1.23-NOTES.md b/docs/releases/1.23-NOTES.md
index 7719742e1a..08013de9a9 100644
--- a/docs/releases/1.23-NOTES.md
+++ b/docs/releases/1.23-NOTES.md
@@ -49,6 +49,9 @@ If this flag is used in AWS, it will enable IRSA.
 
 * If `externalDns.provider` is `external-dns`, then `externalDns.watchIngress` will now default to `true`.
 
+* This release introduces a `v1alpha3` API version. This API version is a work in progress and is likely to be replaced in kOps 1.24.
+It is recommended to keep using the `v1alpha2` API version.
+
 # Full change list since 1.22.0 release