diff --git a/source/_integrations/lock.mqtt.markdown b/source/_integrations/lock.mqtt.markdown
index deb83f550fd..2e12c243aa2 100644
--- a/source/_integrations/lock.mqtt.markdown
+++ b/source/_integrations/lock.mqtt.markdown
@@ -20,6 +20,7 @@ Optimistic mode can be forced, even if state topic is available. Try to enable i
 
 It's mandatory for locks to support `lock` and `unlock`. A lock may optionally support `open`, (e.g. to open the bolt in addition to the latch), in this case, `payload_open` is required in the configuration. If the lock is in optimistic mode, it will change states to `unlocked` when handling the `open` command.
 
+An MQTT lock can also report the intermediate states `unlocking` and `locking`.
 <a id='new_format'></a>
 
 To enable MQTT locks in your installation, add the following to your `configuration.yaml` file:
@@ -198,6 +199,11 @@ state_locked:
   required: false
   type: string
   default: LOCKED
+state_locking:
+  description: The payload sent to by the lock when it's locking.
+  required: false
+  type: string
+  default: LOCKING
 state_topic:
   description: The MQTT topic subscribed to receive state updates.
   required: false
@@ -207,6 +213,11 @@ state_unlocked:
   required: false
   type: string
   default: UNLOCKED
+state_unlocking:
+  description: The payload sent to by the lock when it's unlocking.
+  required: false
+  type: string
+  default: UNLOCKING
 unique_id:
    description: An ID that uniquely identifies this lock. If two locks have the same unique ID, Home Assistant will raise an exception.
    required: false
diff --git a/source/_integrations/mqtt.markdown b/source/_integrations/mqtt.markdown
index b1b04b9de1a..8ffecd445b3 100644
--- a/source/_integrations/mqtt.markdown
+++ b/source/_integrations/mqtt.markdown
@@ -432,7 +432,9 @@ Configuration variable names in the discovery payload may be abbreviated to cons
     'stat_opening':        'state_opening',
     'stat_stopped':        'state_stopped',
     'stat_locked':         'state_locked',
+    'stat_locking':         'state_locking',
     'stat_unlocked':       'state_unlocked',
+    'stat_unlocking':       'state_unlocking',
     'stat_t':              'state_topic',
     'stat_tpl':            'state_template',
     'stat_val_tpl':        'state_value_template',