diff --git a/docs/resources/device_gateway.md b/docs/resources/device_gateway.md
index 6a8d580d..06b7cd49 100644
--- a/docs/resources/device_gateway.md
+++ b/docs/resources/device_gateway.md
@@ -156,7 +156,7 @@ Optional:
 
 - `dns_servers` (List of String) if `type`==`local` - optional, if not defined, system one will be used
 - `dns_suffix` (List of String) if `type`==`local` - optional, if not defined, system one will be used
-- `fixed_bindings` (Attributes Map) Property key is the MAC Address (see [below for nested schema](#nestedatt--dhcpd_config--config--fixed_bindings))
+- `fixed_bindings` (Attributes Map) Property key is the MAC Address. Format is `[0-9a-f]{12}` (e.g "5684dae9ac8b") (see [below for nested schema](#nestedatt--dhcpd_config--config--fixed_bindings))
 - `gateway` (String) if `type`==`local` - optional, `ip` will be used if not provided
 - `ip_end` (String) if `type`==`local`
 - `ip_end6` (String) if `type6`==`local`
diff --git a/docs/resources/device_gateway_cluster.md b/docs/resources/device_gateway_cluster.md
index 39706364..98c5d307 100644
--- a/docs/resources/device_gateway_cluster.md
+++ b/docs/resources/device_gateway_cluster.md
@@ -36,7 +36,7 @@ resource "mist_device_gateway_cluster" "cluster_one" {
 
 ### Required
 
-- `nodes` (Attributes List) (see [below for nested schema](#nestedatt--nodes))
+- `nodes` (Attributes List) when replacing a node, either mac has to remain the same as existing cluster (see [below for nested schema](#nestedatt--nodes))
 - `site_id` (String)
 
 ### Read-Only
@@ -48,6 +48,6 @@ resource "mist_device_gateway_cluster" "cluster_one" {
 
 Required:
 
-- `mac` (String) when replacing a node, either mac has to remain the same as existing cluster
+- `mac` (String) Gateway MAC Address. Format is `[0-9a-f]{12}` (e.g "5684dae9ac8b")
 
 
diff --git a/docs/resources/device_switch.md b/docs/resources/device_switch.md
index 67fddb3a..c6961175 100644
--- a/docs/resources/device_switch.md
+++ b/docs/resources/device_switch.md
@@ -250,7 +250,7 @@ Optional:
 
 - `dns_servers` (List of String) if `type`==`local` - optional, if not defined, system one will be used
 - `dns_suffix` (List of String) if `type`==`local` - optional, if not defined, system one will be used
-- `fixed_bindings` (Attributes Map) Property key is the MAC Address (see [below for nested schema](#nestedatt--dhcpd_config--config--fixed_bindings))
+- `fixed_bindings` (Attributes Map) Property key is the MAC Address. Format is `[0-9a-f]{12}` (e.g "5684dae9ac8b") (see [below for nested schema](#nestedatt--dhcpd_config--config--fixed_bindings))
 - `gateway` (String) if `type`==`local` - optional, `ip` will be used if not provided
 - `ip_end` (String) if `type`==`local`
 - `ip_end6` (String) if `type6`==`local`
diff --git a/docs/resources/org_deviceprofile_gateway.md b/docs/resources/org_deviceprofile_gateway.md
index dc5abd66..0090db4c 100644
--- a/docs/resources/org_deviceprofile_gateway.md
+++ b/docs/resources/org_deviceprofile_gateway.md
@@ -209,7 +209,7 @@ Optional:
 
 - `dns_servers` (List of String) if `type`==`local` - optional, if not defined, system one will be used
 - `dns_suffix` (List of String) if `type`==`local` - optional, if not defined, system one will be used
-- `fixed_bindings` (Attributes Map) Property key is the MAC Address (see [below for nested schema](#nestedatt--dhcpd_config--config--fixed_bindings))
+- `fixed_bindings` (Attributes Map) Property key is the MAC Address. Format is `[0-9a-f]{12}` (e.g "5684dae9ac8b") (see [below for nested schema](#nestedatt--dhcpd_config--config--fixed_bindings))
 - `gateway` (String) if `type`==`local` - optional, `ip` will be used if not provided
 - `ip_end` (String) if `type`==`local`
 - `ip_end6` (String) if `type6`==`local`
diff --git a/docs/resources/org_gatewaytemplate.md b/docs/resources/org_gatewaytemplate.md
index 5b01f367..e74c9727 100644
--- a/docs/resources/org_gatewaytemplate.md
+++ b/docs/resources/org_gatewaytemplate.md
@@ -204,7 +204,7 @@ Optional:
 
 - `dns_servers` (List of String) if `type`==`local` - optional, if not defined, system one will be used
 - `dns_suffix` (List of String) if `type`==`local` - optional, if not defined, system one will be used
-- `fixed_bindings` (Attributes Map) Property key is the MAC Address (see [below for nested schema](#nestedatt--dhcpd_config--config--fixed_bindings))
+- `fixed_bindings` (Attributes Map) Property key is the MAC Address. Format is `[0-9a-f]{12}` (e.g "5684dae9ac8b") (see [below for nested schema](#nestedatt--dhcpd_config--config--fixed_bindings))
 - `gateway` (String) if `type`==`local` - optional, `ip` will be used if not provided
 - `ip_end` (String) if `type`==`local`
 - `ip_end6` (String) if `type6`==`local`