diff --git a/source/_dashboards/gauge.markdown b/source/_dashboards/gauge.markdown
index 96109181545..2fb2304f1e5 100644
--- a/source/_dashboards/gauge.markdown
+++ b/source/_dashboards/gauge.markdown
@@ -39,6 +39,10 @@ entity:
   required: true
   description: Entity ID to show.
   type: string
+attribute:
+  required: false
+  description: Attribute from the selected entity to display
+  type: string
 name:
   required: false
   description: Name of gauge entity.
@@ -198,3 +202,14 @@ segments:
   - from: 65
     color: var(--error-color)
 ```
+
+Display attribute of an entity instead of its state:
+
+```yaml
+type: gauge
+entity: sensor.back_door_info
+attribute: battery_level
+unit: '%'
+max: 100
+```
+In this example, the card displays the `battery_level` attribute of the `sensor.back_door_info` entity.