Skip to content

Board Content

Boards can contain narrative content using the content field. This is useful for adding context, explanations, or summary text alongside your data.

Basic Content

Add content at the top level of a board:

title: "Executive Summary"
content: |
  # Q4 Performance
  Revenue is up **15%** quarter-over-quarter.
rows:
  - revenue_chart

Nested Content

Use content in nested boards to create rich, document-like layouts:

rows:
  - content: |
      ## Monthly Analysis
      Here is the breakdown of our performance by region.

  - cols:
      - content: |
          ### Key Takeaways
          - North region is leading
          - South region needs attention

      - content: |
          ### Action Items
          1. Increase ad spend in South
          2. Optimize North inventory

Mixed Content Layouts

Combine content blocks with charts for rich, document-like dashboards:

title: "Sales Report"

charts:
  revenue_chart:
    query: _doc_examples.yaml#sales
    type: bar
    title: "Revenue by Category"
    x: category
    y: revenue
    color: category

rows:
  - content: |
      # Monthly Sales Report
      This report shows **Q4 performance** across product categories.

  - cols:
      - revenue_chart

      - content: |
          ### Key Takeaways
          - **Electronics**: Top performer
          - **Accessories**: Growing steadily
          - **Tools**: Stable revenue
Sales Report Monthly Sales ReportThis report shows Q4 performance across product categories. ElectronicsAccessoriesToolsCategory020,00040,00060,00080,000100,000120,000140,000160,000RevenueAccessoriesElectronicsToolscategoryRevenue by Category Key Takeaways•Electronics : Top performer•Accessories : Growing steadily•Tools : Stable revenue
▶
▶ Try in Playground ×
Sales Report Monthly Sales ReportThis report shows Q4 performance across product categories. ElectronicsAccessoriesToolsCategory020,00040,00060,00080,000100,000120,000140,000160,000RevenueAccessoriesElectronicsToolscategoryRevenue by Category Key Takeaways•Electronics : Top performer•Accessories : Growing steadily•Tools : Stable revenue

Markdown Features

Because content is Markdown, you can use all standard Markdown features:

Tables

content: |
  | Metric | Value | Notes |
  | --- | --- | --- |
  | Revenue | $4.2M | `SUM(revenue)` over the last quarter |
  | Margin | 32% | Consistent with forecast |

Images

Drop in logos, diagrams, or badges:

content: |
  # dbt-powered Insights
  ![dbt logo](https://upload.wikimedia.org/wikipedia/commons/7/7a/DBT_logo.svg)
  Our revenue model is compiled with dbt.

For local images, place assets in your docs site (e.g., docs/docs/assets/images/) and reference them:

content: |
  ![Company Logo](../assets/images/logo.png)

Callouts & Quotes

content: |
  > :sparkles: Markdown lets you mix prose, tables, inline `code`,
  > and callouts in a single content block.

content: |
  Want a deeper dive? [Open the dbt docs](https://docs.getdbt.com/)
  or [view another board](../guides/getting-started.md).

Inline Code

content: |
  Reference variables like `{{ selected_month }}` or
  metric names like `total_revenue`.

Content Tips

  • Use tables to align KPIs and explainers side by side
  • Add > blockquotes as callouts for assumptions or warnings
  • Drop [links](...) to help viewers jump to related docs
  • Embed inline `code` to reference variables or query snippets
  • Combine headings, lists, and images for mini write-ups