diff --git a/doc/source/configuration/magnum-capi.rst b/doc/source/configuration/magnum-capi.rst
index 016aaeabb..bc836ccc8 100644
--- a/doc/source/configuration/magnum-capi.rst
+++ b/doc/source/configuration/magnum-capi.rst
@@ -112,4 +112,6 @@ Magnum Cluster Templates
 
 The clusters deployed by the Cluster API driver make use of the Ubuntu Kubernetes images built in the `azimuth-images <https://github.com/stackhpc/azimuth-images>`_ repository and then use `capi-helm-charts <https://github.com/stackhpc/capi-helm-charts>`_ to provide the Helm charts which define the clusters based on these images. Between them, these two repositories have CI jobs that regularly build and test images and Helm charts for the latest Kubernetes versions. It is therefore important to update the cluster templates on each cloud regularly to make use of these new releases.
 
+Note that these templates are a tested set against the specific CAPI management cluster release. As such, you should make sure to update your CAPI management cluster to the latest release before updating to the latest templates.
+
 Magnum templates should be defined within an existing client-specific `openstack-config <https://github.com/stackhpc/openstack-config>`_ repository. See the openstack-config `README <https://github.com/stackhpc/openstack-config?tab=readme-ov-file#magnum-cluster-templates>`_ for more details.