diff --git a/source/_lovelace/shopping-list.markdown b/source/_lovelace/shopping-list.markdown
new file mode 100644
index 00000000000..40a4a7587c3
--- /dev/null
+++ b/source/_lovelace/shopping-list.markdown
@@ -0,0 +1,44 @@
+---
+layout: page
+title: "Shopping List Card"
+sidebar_label: Shopping List
+description: "The Shopping List Card allows you to edit and check-off items from your shopping list"
+date: 2018-11-02 10:28 +00:00
+sidebar: true
+comments: false
+sharing: true
+footer: true
+---
+
+The Shopping List Card allows you to edit and check-off items from your shopping list.
+
+Setup of the [Shopping List Intent](https://www.home-assistant.io/components/shopping_list/) is required
+
+<p class='img'>
+<img src='/images/lovelace/lovelace_shopping_list_card.gif' alt='Screenshot of the shopping list card'>
+Screenshot of the Shopping List card.
+</p>
+
+```yaml
+- type: shopping-list
+```
+
+{% configuration %}
+type:
+  required: true
+  description: shopping-list
+  type: string
+title:
+  required: false
+  description: Title of Shopping List
+  type: string
+{% endconfiguration %}
+
+## {% linkable_title Examples %}
+
+Title Example:
+
+```yaml
+- type: shopping-list
+  title: Shopping List
+```
diff --git a/source/images/lovelace/lovelace_shopping_list_card.gif b/source/images/lovelace/lovelace_shopping_list_card.gif
new file mode 100644
index 00000000000..b1f1716d32d
Binary files /dev/null and b/source/images/lovelace/lovelace_shopping_list_card.gif differ