diff --git a/doc/api/dgram.md b/doc/api/dgram.md
index ab0e5e5134c373..d47cfe22ebb735 100644
--- a/doc/api/dgram.md
+++ b/doc/api/dgram.md
@@ -75,10 +75,11 @@ socket.on('message', (msg, rinfo) => {
 * `multicastAddress` {String}
 * `multicastInterface` {String}, Optional
 
-Tells the kernel to join a multicast group at the given `multicastAddress`
-using the `IP_ADD_MEMBERSHIP` socket option. If the `multicastInterface`
-argument is not specified, the operating system will try to add membership to
-all valid networking interfaces.
+Tells the kernel to join a multicast group at the given `multicastAddress` and
+`multicastInterface` using the `IP_ADD_MEMBERSHIP` socket option. If the
+`multicastInterface` argument is not specified, the operating system will choose
+one interface and will add membership to it. To add membership to every
+available interface, call `addMembership` multiple times, once per interface.
 
 ### socket.address()