Skip to content

The easy-to-use open source Business Intelligence and Embedded Analytics tool that lets everyone work with data :bar_chart:

docs: add page for dashboard heading and text cards (#76353)

Michael Eby1701a63d4eca
diff --git a/docs/dashboards/dashboard-markdown.md b/docs/dashboards/dashboard-markdown.md
new file mode 100644
index 00000000000..36bcacbcdd0
--- /dev/null
+++ b/docs/dashboards/dashboard-markdown.md
@@ -0,0 +1,91 @@
+---
+title: Dashboard heading and text cards
+summary: Add context to your dashboards with text and heading cards, including formatted text, images, dividers, and filter values.
+---
+
+# Dashboard heading and text cards
+
+Add heading and text cards to your dashboards to label sections, link to other content, display images, and more.
+
+## Add a heading or text card
+
+To add a heading or text card to a dashboard:
+
+1. Click the **pencil icon** to edit the dashboard.
+2. Click the **text card button** in the top right.
+3. Choose **Heading** or **Text**.
+
+![Text card menu](images/text-card-menu.png)
+
+To move a card, click and drag it. To resize a card, click and drag the handle in its bottom right corner.
+
+Click a card to edit the text. Click away from the card to preview the text.
+
+## Heading cards
+
+A heading card holds a single line of text. Use a heading card to title a dashboard or label a section of charts.
+
+![Section heading card](images/section-heading-card.png)
+
+A few things to know about heading cards:
+
+- The text is always left-aligned.
+- The text stays the same size, regardless of how you resize the card.
+- You can't use Markdown in heading cards. Markdown syntax renders as plain text.
+
+You can add a filter value to a heading card using a variable. See [Add filter values to a card](#add-filter-values-to-a-card).
+
+## Text cards
+
+A text card displays text you write in Markdown. Add formatting like bold text, lists, links, and images.
+
+![Text card Markdown example](images/text-card-markdown-example.png)
+
+### Change a text card's alignment
+
+You can set how text sits inside a text card. Open the card's **Visualization options** to choose its alignment:
+
+- **Horizontal alignment:** Left, Center, or Right.
+- **Vertical alignment:** Top, Middle, or Bottom.
+
+![Center-aligned text card](images/text-card-alignment-centered.png)
+
+### Remove a text card's background
+
+By default, a text card has a white background. To remove the background, open the card's **Visualization options** and disable the **Show background** toggle.
+
+Here's the same card with its background on (top) and off (bottom):
+
+![​The same text card shown twice: with its background on (top) and removed (bottom)](images/text-card-background.png)
+
+## Add filter values to a card
+
+You can show the value of a dashboard filter inside a heading or text card. This lets you write text that updates when someone changes the filter.
+
+For example, a card might contain:
+
+```text
+{% raw %}
+Our revenue over {{Date}}:
+{% endraw %}
+```
+
+Then, when someone selects "Previous 30 days" in the connected filter, the card displays:
+
+![Dashboard card variable](images/dashboard-card-variable.png)
+
+To add a filter value to a card:
+
+1. [Add a filter](../dashboards/filters.md) to your dashboard.
+2. Add a variable to your card by wrapping a name in double braces, like `{% raw %}{{Date}}{% endraw %}`.
+3. Connect the filter to the card's variable.
+
+## Add an image
+
+If your admin has [allowed domains for images](../configuring-metabase/settings.md#allowed-domains-for-images), you can add an image to a dashboard. Add a text card and use Markdown image syntax:
+
+```text
+![A description of the image](https://example.com/image.png)
+```
+
+You can't upload an image to Metabase, only link to images hosted elsewhere.
\ No newline at end of file
diff --git a/docs/dashboards/images/dashboard-card-variable.png b/docs/dashboards/images/dashboard-card-variable.png
new file mode 100644
index 00000000000..d15ad18001a
Binary files /dev/null and b/docs/dashboards/images/dashboard-card-variable.png differ
diff --git a/docs/dashboards/images/section-heading-card.png b/docs/dashboards/images/section-heading-card.png
new file mode 100644
index 00000000000..4ed052bc427
Binary files /dev/null and b/docs/dashboards/images/section-heading-card.png differ
diff --git a/docs/dashboards/images/text-card-alignment-centered.png b/docs/dashboards/images/text-card-alignment-centered.png
new file mode 100644
index 00000000000..2656ea915cb
Binary files /dev/null and b/docs/dashboards/images/text-card-alignment-centered.png differ
diff --git a/docs/dashboards/images/text-card-background.png b/docs/dashboards/images/text-card-background.png
new file mode 100644
index 00000000000..4db61e747e8
Binary files /dev/null and b/docs/dashboards/images/text-card-background.png differ
diff --git a/docs/dashboards/images/text-card-markdown-example.png b/docs/dashboards/images/text-card-markdown-example.png
new file mode 100644
index 00000000000..0d64e6d9d6e
Binary files /dev/null and b/docs/dashboards/images/text-card-markdown-example.png differ
diff --git a/docs/dashboards/images/text-card-menu.png b/docs/dashboards/images/text-card-menu.png
new file mode 100644
index 00000000000..02001b4f48e
Binary files /dev/null and b/docs/dashboards/images/text-card-menu.png differ