# Build your first dashboard

### What you'll end up with

A dashboard with two pages:

* **Page 1: Overview** — a metric strip, two charts, and a campaigns table.
* **Page 2: Channels** — a pivot table comparing channels week-over-week.

A dashboard-level date range filter applied to both pages.

### Prerequisites

* A project with at least one connection (we'll assume **Google Ads** in this tutorial, but the steps are identical for any platform).
* Editor or Owner role on the project.

***

### Step 1 — Create a new dashboard

1. Open your project and click **Dashboards** in the side menu.
2. Click **Create new dashboard** in the top-right.
3. Name it (e.g. "Q2 Performance") and click **Create**.

You'll land in the empty dashboard. Click "Edit" to enter **Edit mode**.

<figure><img src="/files/XRKNJBsATqGcje0RCuKY" alt=""><figcaption></figcaption></figure>

### Step 2 — Add a metric card

1. Click **Add → Prebuilt Datablocks**.
2. In the right-side settings panel, click the **Data** tab.
3. Pick **Google Ads** as the connection, then pick **Clicks** as the metric.
4. Repeat for Avg. CPC.

<figure><img src="/files/sGyXdoU7Rh71LO5w7Ocr" alt=""><figcaption></figcaption></figure>

> **\[Screen video needed]** Adding the first metric card from click-Add through Fetch data and dragging into place. \~45 seconds.

### Step 3 — Add a line chart

1. Click **Add → Custom Datablock**.
2. Select the suitable connection and drag the block to the dashboard to add an empty Custom Block.
3. In the Data tab, select the date range or use the default, select the metrics / dimensions / frequency that you need.
4. Scroll down to the bottom and Click **Fetch data**. You will see a table populated with data
5. Switch to the **Chart** tab and pick **Line** as the chart type.
6. Configure the chart title in the **General** tab

<figure><img src="/files/3w3ouykcIMCo9jnVH3d1" alt=""><figcaption></figcaption></figure>

### Step 4 — Add a second page

1. Click the **+** next to the page tabs at the top.
2. Name the new page "Channels."

<figure><img src="/files/r3uRPdQAz1nTlTImI0cU" alt=""><figcaption></figcaption></figure>

<figure><img src="/files/eDPehsqNAkIbOGo5374J" alt=""><figcaption></figcaption></figure>

<figure><img src="/files/ZTmwmKJ2CDvSBFkbVrDi" alt=""><figcaption></figcaption></figure>

### Step 6 — Add a dashboard-level date filter

1. Click the **funnel icon** in the top-right of the dashboard.
2. Pick **Dashboard level** → **Add filter**.
3. Configure and Click **Apply**.

The filter cascades down through both pages and every chart. See [Mastering dashboard filters](/documentation/features/dashboard/mastering-dashboard-filters.md) for the full waterfall logic.

<figure><img src="/files/IWrTizXCsaeqi2Opmo85" alt=""><figcaption></figcaption></figure>

### Step 7 — Switch off Edit mode and share

1. Click the **Edit mode** toggle to flip into View mode.
2. Click **Share** to get a public link, or **Snapshot** to save a read-only archive.

See [Public dashboards & sharing](/documentation/features/dashboard/public-share-and-chat.md) and [Snapshots & version history](/documentation/features/dashboard/snapshots-and-versions.md).

### What's next

* [Add AI insights](/documentation/features/dashboard/add-ai-insights.md) — get AI-generated commentary alongside your charts.
* [Generate a report](/documentation/get-started/tutorials/generate-your-first-report.md) — turn this dashboard into a polished .pptx.
* [Chat with SMAQ AI](/documentation/get-started/tutorials/chat-with-smaq-ai.md) — ask questions about the data and add results back to this dashboard.


---

# 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/get-started/tutorials/build-your-first-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.