diff --git a/source/dashboards/badges.markdown b/source/dashboards/badges.markdown
index b7ff3d54d29d..e4688ab7cc7f 100644
--- a/source/dashboards/badges.markdown
+++ b/source/dashboards/badges.markdown
@@ -10,6 +10,26 @@ Badges are widgets that sit at the top of a panel, above all the cards.
   Badges at the top of a panel.
 </p>
 
+## Adding a badge to your dashboard
+
+1. Go to {% my lovelace_dashboards title="**Settings** > **Dashboards**" %}.
+2. If you have multiple [views](/dashboards/views/), open the view to which you want to add a badge.
+3. In the top right of the screen, select the edit {% icon "mdi:edit" %} button.
+4. To add a badge, select the plus {% icon "mdi:plus" %}button.
+
+   ![Screenshot showing how to add a badge](/images/dashboards/badge_add.png)
+
+5. Select the entity for which you want to display a badge.
+6. Configure your badge.
+   - The available options depend on the entity.
+   - Add the states you want to see.
+   - If you want, add a **Name**.
+
+   ![Screenshot showing how to configure a badge](/images/dashboards/badge_configure.png)
+7. Under **Interactions**, you can define the tap behavior.
+8. If you want this badge to be visible only to specific users or under a certain condition, open the **Visibility** tab to [define those conditions](/dashboards/cards/#showing-or-hiding-a-card-conditionally).
+9. Select **Save**.
+
 ## Entity badge
 
 The Entity badge allows you to display the state of an entity on a badge. This badge supports [actions](/dashboards/actions/).
diff --git a/source/images/dashboards/badge_add.png b/source/images/dashboards/badge_add.png
new file mode 100644
index 000000000000..6cc99f14f205
Binary files /dev/null and b/source/images/dashboards/badge_add.png differ
diff --git a/source/images/dashboards/badge_configure.png b/source/images/dashboards/badge_configure.png
new file mode 100644
index 000000000000..c0d9942e103e
Binary files /dev/null and b/source/images/dashboards/badge_configure.png differ