diff --git a/engine/swarm/networking.md b/engine/swarm/networking.md
index f69184bb5c90..f57a421ee58b 100644
--- a/engine/swarm/networking.md
+++ b/engine/swarm/networking.md
@@ -192,6 +192,17 @@ $ docker network create \
   my-network
 ```
 
+##### Overlay network size limitations
+
+You should create overlay networks with `/24` blocks (the default), which limits
+you to 256 IP addresses, when you create networks using the default VIP-based
+endpoint-mode. This recommendation addresses
+[limitations with swarm mode](https://github.com/moby/moby/issues/30820). If you
+need more than 256 IP addresses, do not increase the IP block size. You can either
+use `dnsrr` endpoint mode with an external load balancer, or use multiple smaller
+overlay networks. See [Configure service discovery](#configure-service-discovery)
+for more information about different endpoint modes.
+
 #### Configure encryption of application data
 
 Management and control plane data related to a swarm is always encrypted.