diff --git a/src/iwd.config.rst b/src/iwd.config.rst
index dd04909c..96774092 100644
--- a/src/iwd.config.rst
+++ b/src/iwd.config.rst
@@ -82,7 +82,7 @@ The group ``[General]`` contains general settings.
        this setting.
 
    * - AddressRandomization
-     - Values: **disabled**, once
+     - Values: **disabled**, once, network
 
        If ``AddressRandomization`` is set to ``disabled``, the default kernel
        behavior is used.  This means the kernel will assign a mac address from
@@ -94,6 +94,12 @@ The group ``[General]`` contains general settings.
        randomized a single time when **iwd** starts or when the hardware is
        detected for the first time (due to hotplug, etc.)
 
+       If ``AddressRandomization`` is set to ``network``, the MAC address is
+       randomized on each connection to a network. The MAC is generated based on
+       the SSID and permanent address of the adapter. This allows the same MAC
+       to be generated each time connecting to a given SSID while still hiding
+       the permanent address.
+
    * - AddressRandomizationRange
      - Values: **full**, nic