diff --git a/source/_dashboards/energy.markdown b/source/_dashboards/energy.markdown
index 64766ee06a0..ad4533650b9 100644
--- a/source/_dashboards/energy.markdown
+++ b/source/_dashboards/energy.markdown
@@ -181,7 +181,17 @@ type: energy-self-sufficiency-gauge
 
 The devices energy graph show the energy usage per device, it is sorted by usage.
 
-### Example
+By default, this card will show all your devices. Optionally, the number of devices can be limited by adding the `max_devices` option and specifying the maximum number of devices to show. If there are more devices available than shown, the devices with the highest energy usage are shown.
+
+### Examples
+
 ```yaml
 type: energy-devices-graph
 ```
+
+The following example limits the number of shown devices to 5:
+
+```yaml
+type: energy-devices-graph
+max_devices: 5
+```