diff --git a/api-ref/source/v2/parameters.yaml b/api-ref/source/v2/parameters.yaml
index de985e183..e2e60bf61 100644
--- a/api-ref/source/v2/parameters.yaml
+++ b/api-ref/source/v2/parameters.yaml
@@ -609,6 +609,13 @@ mac_address-query:
   in: query
   required: false
   type: string
+mac_learning_enabled-query:
+  description: |
+    Filter the list result by the mac_learning_enabled state of the resource,
+    which is enabled (``true``) or disabled (``false``).
+  in: query
+  required: false
+  type: boolean
 max_burst_kbps-query:
   description: |
     Filter the list result by the maximum burst size (in kilobits).
@@ -3569,6 +3576,20 @@ mac_address-request-put:
   in: body
   required: false
   type: string
+mac_learning_enabled:
+  description: |
+    A boolean value that indicates if MAC Learning is enabled on the
+    associated port.
+  in: body
+  required: false
+  type: boolean
+mac_learning_enabled-request:
+  description: |
+    A boolean value that indicates if MAC Learning is enabled on the
+    associated port.
+  in: body
+  required: false
+  type: boolean
 max_burst_kbps:
   description: |
     The maximum burst size (in kilobits). Default is ``0``.
diff --git a/api-ref/source/v2/ports.inc b/api-ref/source/v2/ports.inc
index 154bece98..c7bd87220 100644
--- a/api-ref/source/v2/ports.inc
+++ b/api-ref/source/v2/ports.inc
@@ -117,6 +117,12 @@ The ``standard-attr-tag`` adds Tag support for resources with
 standard attributes by adding the ``tags`` attribute
 allowing consumers to associate tags with resources.
 
+Mac learning extension
+======================
+
+The ``mac_learning_enabled`` extension extends neutron ports providing the
+ability to enable MAC learning on the associated port via the
+```mac_learning_enabled``` attribute.
 
 Show port details
 =================
@@ -180,6 +186,7 @@ Response Parameters
    - tags: tags
    - tenant_id: project_id
    - updated_at: updated_at_resource
+   - mac_learning_enabled: mac_learning_enabled
 
 Response Example
 ----------------
@@ -250,6 +257,7 @@ Request
    - port_security_enabled: port_security_enabled-request
    - qos_policy_id: qos_policy_id-port-request
    - security_groups: port-security_groups-request
+   - mac_learning_enabled: mac_learning_enabled-request
 
 Request Example
 ---------------
@@ -300,6 +308,7 @@ Response Parameters
    - tags: tags
    - tenant_id: project_id
    - updated_at: updated_at_resource
+   - mac_learning_enabled: mac_learning_enabled
 
 Response Example
 ----------------
@@ -393,6 +402,7 @@ Request
    - not-tags: not-tags-query
    - not-tags-any: not-tags-any-query
    - fields: fields
+   - mac_learning_enabled: mac_learning_enabled-query
 
 Response Parameters
 -------------------
@@ -431,6 +441,7 @@ Response Parameters
    - tags: tags
    - tenant_id: project_id
    - updated_at: updated_at_resource
+   - mac_learning_enabled: mac_learning_enabled
 
 Response Example
 ----------------
@@ -485,6 +496,7 @@ Request
    - security_groups: port-security_groups-request
    - tags: tags
    - tenant_id: project_id-request
+   - mac_learning_enabled: mac_learning_enabled-request
 
 Request Example
 ---------------
@@ -535,6 +547,7 @@ Response Parameters
    - tags: tags
    - tenant_id: project_id
    - updated_at: updated_at_resource
+   - mac_learning_enabled: mac_learning_enabled
 
 Response Example
 ----------------
@@ -587,6 +600,7 @@ Request
    - qos_policy_id: qos_policy_id-port-request
    - security_groups: port-security_groups-request
    - tenant_id: project_id-request
+   - mac_learning_enabled: mac_learning_enabled-request
 
 Request Example
 ---------------
@@ -631,6 +645,7 @@ Response Parameters
    - tags: tags
    - tenant_id: project_id
    - updated_at: updated_at_resource
+   - mac_learning_enabled: mac_learning_enabled
 
 Response Example
 ----------------
diff --git a/api-ref/source/v2/samples/ports/port-bind-show-response.json b/api-ref/source/v2/samples/ports/port-bind-show-response.json
index b2837704a..01e95dd82 100644
--- a/api-ref/source/v2/samples/ports/port-bind-show-response.json
+++ b/api-ref/source/v2/samples/ports/port-bind-show-response.json
@@ -38,6 +38,7 @@
         "id": "46d4bfb9-b26e-41f3-bd2e-e6dcc1ccedb2",
         "ip_allocation": "immediate",
         "mac_address": "fa:16:3e:23:fd:d7",
+        "mac_learning_enabled": false,
         "name": "",
         "network_id": "a87cc70a-3e15-4acf-8205-9b711a3531b7",
         "port_security_enabled": false,