diff --git a/dashboards.adoc b/dashboards.adoc
index 29f2b6903..c5158c5c9 100644
--- a/dashboards.adoc
+++ b/dashboards.adoc
@@ -163,3 +163,29 @@ dashboards:
               - title: Action 4
 
 ----
+
+[#displays]
+=== Displays
+
+Displays are most commonly used with entities, but they can contain any HTML, including variables as well.
+
+image::images/dashboard-display.png[]
+
+[source,yaml]
+.`config.yaml`
+----
+dashboards:
+  # This is the second dashboard.
+  - title: My Containers
+    contents:
+      - title: Container {{ container.Names }}
+        entity: container
+        type: fieldset
+        contents:
+          - type: display
+            title: |
+              {{ container.Names }} <br /><br /><strong>{{ container.State }}</strong>
+          - title: 'Start {{ container.Names }}'
+          - title: 'Stop {{ container.Names }}'
+----
+
diff --git a/images/dashboard-display.png b/images/dashboard-display.png
new file mode 100644
index 000000000..af80170eb
Binary files /dev/null and b/images/dashboard-display.png differ