diff --git a/server_installation/topics/operator/command-options.adoc b/server_installation/topics/operator/command-options.adoc
index 7ff9a40cb8..28a879c294 100644
--- a/server_installation/topics/operator/command-options.adoc
+++ b/server_installation/topics/operator/command-options.adoc
@@ -18,5 +18,10 @@ A window opens where you can make changes.
 
 [NOTE]
 ====
-You can update the YAML file and changes appear in the {project_name} admin console, however changes to the admin console do not update the custom resource.
+You can update the Keycloak CR YAML file and changes will be applied to the deployment.
+
+Updates to the other resources are limited:
+
+Keycloak Realm CR only supports basic creation and deletion without sync options.
+Keycloak User and Client CRs support unidirectional updates (changes to the CR are reflected in Keycloak but changes done in Keycloak are not updated in the CR).
 ====
diff --git a/server_installation/topics/operator/keycloak-realm-cr.adoc b/server_installation/topics/operator/keycloak-realm-cr.adoc
index f1d9173db3..7682fc273b 100644
--- a/server_installation/topics/operator/keycloak-realm-cr.adoc
+++ b/server_installation/topics/operator/keycloak-realm-cr.adoc
@@ -6,7 +6,7 @@ You can use the Operator to create realms in {project_name} as defined by a cust
 
 [NOTE]
 ====
-You can update the YAML file and changes appear in the {project_name} admin console, however changes to the admin console do not update the custom resource.
+You can only create or delete realms by creating or deleting the YAML file, and changes appear in the {project_name} admin console. However changes to the admin console are not reflected back and updates of the CR after the realm is created are not supported.
 ====
 
 .Example YAML file for a `Realm` custom resource