# Dashboard blocks

> Annotate dashboards with markdown text blocks and organize them with section separators.

*[View this page in the Flax docs](https://flax-analytics.com/docs/visualizations/dashboard-blocks)*

Not every tile on a dashboard is a chart. **Text blocks** and **section
separators** let you add context and structure so a board reads as a report, not
just a wall of charts.

## Text blocks

A text block is a tile you write in markdown, edited inline with a live editor. Use
it for titles, commentary, definitions, or a short narrative next to the charts it
explains. Supported markdown includes:

```md
## A heading

Some **bold** commentary with a `code` reference.

- A bullet list
- [ ] A task item
```

Content is stored as portable markdown, and raw HTML is disabled — pasted scripts
or tags are inert — so text blocks are safe to share on org-visible dashboards.

## Section separators

A separator is a labeled divider that groups the tiles below it into a section
(for example "Revenue" then "Retention"). Separators carry a short label and help a
long dashboard scan cleanly, especially alongside [tabs](/docs/visualizations/dashboards).

## Adding a block

In dashboard edit mode, add a text or separator tile the same way you add a chart
tile, then position and size it on the grid. Text and separator tiles participate
in [tabs](/docs/visualizations/dashboards) like any other tile.

## Related

- [Dashboards](/docs/visualizations/dashboards) — layout and tabs.
- [Interactivity](/docs/visualizations/interactivity) — filters and cross-filtering.