# Dashboard

A SMAQ dashboard is built from **widgets** placed on a **grid**, organized into **pages** (tabs across the top), with **filters** that cascade from dashboard → page → widget. You can save **snapshots** for read-only archives, **share** publicly, and **chat** with the AI about any item on the dashboard.

> **\[Screenshot needed]** A representative dashboard view in View mode — three pages, a metric strip at the top, two charts side by side, a campaigns table below. The chat panel is open on the right.

### Widget types

* **Charts** — line, bar, area, pie, donut, funnel, scatter, combo. Pick the type from the Chart tab of the widget's settings.
* **Tables** — spreadsheet-like rows and columns, with custom columns, sorting, currency conversion, and Excel/CSV export.
* **Pivot tables** — multi-level row/column aggregation with grouping support.
* **Metric cards** — single big number with a period-over-period comparison.
* **Static widgets** — text boxes (with optional [AI Insights](/documentation/features/dashboard/add-ai-insights.md)), images, headings.
* **Merged tables** — two tables joined on a common column. See [Merge table](/documentation/features/dashboard/merge-table.md).
* **Competitor ad panels** — for projects with the Competitor Ads Monitor or Google Competitor Ads Monitor automation enabled.

### Core capabilities

| Capability                                  | Reference                                                                                                       |
| ------------------------------------------- | --------------------------------------------------------------------------------------------------------------- |
| Add a chart from a datablock                | [Adding custom charts](/documentation/features/dashboard/adding-custom-charts.md)                               |
| Add a data table                            | [Add data tables](/documentation/features/dashboard/add-data-tables.md)                                         |
| Add AI-generated narrative                  | [Add AI Insights](/documentation/features/dashboard/add-ai-insights.md)                                         |
| Configure dashboard / page / chart filters  | [Mastering dashboard filters](/documentation/features/dashboard/mastering-dashboard-filters.md)                 |
| Pivot tables                                | [Pivot Table](/documentation/features/dashboard/pivot-table.md)                                                 |
| Merge two tables on a key                   | [Merge Table](/documentation/features/dashboard/merge-table.md)                                                 |
| Add a custom column with a formula          | [Add Custom Column to Table](/documentation/features/dashboard/add-custom-column-to-table.md)                   |
| Copy a table to clipboard                   | [Copy Table to Clipboard](/documentation/features/dashboard/copy-table-to-clipboard.md)                         |
| Download a table or pivot as Excel          | [Download Table/Pivot Table as Excel](/documentation/features/dashboard/download-table-pivot-table-as-excel.md) |
| Convert currency at the table level         | [Currency Conversion for Tables](/documentation/features/dashboard/currency-conversion-for-tables.md)           |
| Save a read-only archive                    | [Snapshots & version history](/documentation/features/dashboard/snapshots-and-versions.md)                      |
| Share publicly + chat on a shared dashboard | [Public dashboards & sharing](/documentation/features/dashboard/public-share-and-chat.md)                       |
| Generate a polished report                  | [Generate report from dashboard](/documentation/features/reports/generate-from-dashboard.md)                    |

### Edit mode vs View mode

* **Edit mode** — drag widgets, change settings, add new items, apply filters per chart. Toggle on with the **Edit** switch in the dashboard header.
* **View mode** — read-only. The audience for your dashboard (clients, stakeholders) usually stays here.

Filters can be configured in Edit mode and applied to anyone viewing the dashboard. AI Insights and chat work in both modes.

### Pages

Click the **+** next to the page tabs at the top to add a new page. Each page has its own widget grid and its own page-level filters. See [Mastering dashboard filters](/documentation/features/dashboard/mastering-dashboard-filters.md) for how dashboard / page / chart filters compose.

### Dates and date ranges

Every chart has its own date range, but most dashboards set a single date range at the **dashboard level** that cascades to everything. The default date range when you open a dashboard is the one set on the dashboard-level filter.

### What's next

* [Build your first dashboard](/documentation/get-started/tutorials/build-your-first-dashboard.md) — step-by-step tutorial.
* [Adding custom charts](/documentation/features/dashboard/adding-custom-charts.md) — the most common workflow.
* [Snapshots & version history](/documentation/features/dashboard/snapshots-and-versions.md) — preserve a point-in-time view.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.smaq.io/documentation/features/dashboard.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.