> ## Documentation Index
> Fetch the complete documentation index at: https://docs.clarityq.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# What are Dashboards?

> Interactive, AI-generated visualizations powered by live data from your warehouse.

Dashboards in ClarityQ are interactive visualizations that pull live data from your data warehouse. Unlike the visualizations the agent creates during a chat — which are static snapshots of a single answer — dashboards run real SQL queries and update dynamically as you change filters and date ranges.

Every dashboard includes a **date range picker** and can have additional filters like dropdowns and text search. They contain charts, tables, KPI cards, and other visual components — all generated by the AI agent based on your natural language request.

## How Dashboards Work

When you create a dashboard, the agent:

1. Builds the visualization code with charts, tables, and KPI cards
2. Adds a date range picker with standard presets (last 7 days, this month, custom range, etc.)
3. Replaces any hardcoded data with dynamic SQL queries that run against your warehouse
4. Tags the dashboard with the semantic components it uses (metrics, entities, segments, features)
5. Adds optional filters if relevant to the data

Every time someone opens the dashboard or changes a filter, the queries re-run and the visualizations update with fresh data. Query results are cached to keep things fast — repeated visits with the same filters load instantly without hitting the warehouse again.

## Dashboard Views

You'll find a **Dashboards** area in the sidebar menu. Inside, dashboards are organized into three views:

| View                  | What it shows                                 |
| --------------------- | --------------------------------------------- |
| **Starred**           | Dashboards you've marked as favorites         |
| **My Dashboards**     | Dashboards you created                        |
| **Public Dashboards** | All dashboards published to your organization |

## Visibility

Dashboards start as **Private** — only you can see them. When you're ready to share with your organization, you **Publish** the dashboard to make it public. You can unpublish it later to make it private again.

| Status       | Who can see it                                      |
| ------------ | --------------------------------------------------- |
| **Private**  | Only you (the owner)                                |
| **Public**   | Everyone in your organization with dashboard access |
| **Archived** | Hidden from all views, but can be restored          |