diff --git a/network_data.yaml b/network_data.yaml
index 02dcdd0266..3448df455b 100644
--- a/network_data.yaml
+++ b/network_data.yaml
@@ -23,7 +23,8 @@
 #                               new segment for the network.
 # NOTE: False will use noop.yaml for unused legacy networks to support upgrades.
 # vlan: vlan for the network (optional)
-# vip: Enable creation of a virtual IP on this network
+# vip: Enable creation of a virtual IP on this network. Only for networks attached
+#      to the roles running high-availability clustering (Controller by default).
 # ip_subnet: IP/CIDR, e.g. '192.168.24.0/24' or '2001:db8:fd00:1000::/64'
 #            (optional, may use parameter defaults instead)
 # allocation_pools: IP range list e.g. [{'start':'10.0.0.4', 'end':'10.0.0.250'}]
diff --git a/network_data_dashboard.yaml b/network_data_dashboard.yaml
index eebcaee593..d8be055946 100644
--- a/network_data_dashboard.yaml
+++ b/network_data_dashboard.yaml
@@ -8,7 +8,8 @@
 # enabled: Is the network enabled (optional, defaults to true)
 # NOTE: False will use noop.yaml for unused legacy networks to support upgrades.
 # vlan: vlan for the network (optional)
-# vip: Enable creation of a virtual IP on this network
+# vip: Enable creation of a virtual IP on this network. Only for networks attached
+#      to the roles running high-availability clustering (Controller by default).
 # ip_subnet: IP/CIDR, e.g. '192.168.24.0/24' or '2001:db8:fd00:1000::/64'
 #            (optional, may use parameter defaults instead)
 # allocation_pools: IP range list e.g. [{'start':'10.0.0.4', 'end':'10.0.0.250'}]
diff --git a/network_data_ganesha.yaml b/network_data_ganesha.yaml
index b7b0132caa..13694b1e9e 100644
--- a/network_data_ganesha.yaml
+++ b/network_data_ganesha.yaml
@@ -23,7 +23,8 @@
 #                               new segment for the network.
 # NOTE: False will use noop.yaml for unused legacy networks to support upgrades.
 # vlan: vlan for the network (optional)
-# vip: Enable creation of a virtual IP on this network
+# vip: Enable creation of a virtual IP on this network. Only for networks attached
+#      to the roles running high-availability clustering (Controller by default).
 # ip_subnet: IP/CIDR, e.g. '192.168.24.0/24' or '2001:db8:fd00:1000::/64'
 #            (optional, may use parameter defaults instead)
 # allocation_pools: IP range list e.g. [{'start':'10.0.0.4', 'end':'10.0.0.250'}]
diff --git a/network_data_routed.yaml b/network_data_routed.yaml
index 0f3402062a..8f6254aa27 100644
--- a/network_data_routed.yaml
+++ b/network_data_routed.yaml
@@ -18,7 +18,8 @@
 # enabled: Is the network enabled (optional, defaults to true)
 # NOTE: False will use noop.yaml for unused legacy networks to support upgrades.
 # vlan: vlan for the network (optional)
-# vip: Enable creation of a virtual IP on this network
+# vip: Enable creation of a virtual IP on this network. Only for networks attached
+#      to the roles running high-availability clustering (Controller by default).
 # ip_subnet: IP/CIDR, e.g. '192.168.24.0/24' or '2001:db8:fd00:1000::/64'
 #            (optional, may use parameter defaults instead)
 # allocation_pools: IP range list e.g. [{'start':'10.0.0.4', 'end':'10.0.0.250'}]
diff --git a/network_data_subnets_routed.yaml b/network_data_subnets_routed.yaml
index 91d45cc822..125dad0cf1 100644
--- a/network_data_subnets_routed.yaml
+++ b/network_data_subnets_routed.yaml
@@ -11,7 +11,8 @@
 # enabled: Is the network enabled (optional, defaults to true)
 # NOTE: False will use noop.yaml for unused legacy networks to support upgrades.
 # vlan: vlan for the network (optional)
-# vip: Enable creation of a virtual IP on this network
+# vip: Enable creation of a virtual IP on this network. Only for networks attached
+#      to the roles running high-availability clustering (Controller by default).
 # ip_subnet: IP/CIDR, e.g. '192.168.24.0/24' or '2001:db8:fd00:1000::/64'
 #            (optional, may use parameter defaults instead)
 # allocation_pools: IP range list e.g. [{'start':'10.0.0.4', 'end':'10.0.0.250'}]