diff --git a/components/mqtt.rst b/components/mqtt.rst
index 0f2399c99..03df201c5 100644
--- a/components/mqtt.rst
+++ b/components/mqtt.rst
@@ -43,6 +43,9 @@ Configuration variables:
- **discovery_prefix** (*Optional*, string): The prefix to use for Home
Assistant’s MQTT discovery. Should not contain trailing slash.
Defaults to ``homeassistant``.
+- **use_abbreviations** (*Optional*, boolean): Whether to use
+ `Abbreviations `__
+ in discovery messages. Defaults to ``true``.
- **topic_prefix** (*Optional*, string): The prefix used for all MQTT
messages. Should not contain trailing slash. Defaults to
````.