Artifacts vs Dashboards in Chat
Before diving into creation, it’s important to understand the distinction between the two types of visual output in chat:- Artifacts are static visualizations displayed inline in the conversation. They show the data as it was at the moment the agent generated them.
- Dashboards are interactive visualizations that appear as a reference card in the conversation. Clicking the card opens the dashboard in the right panel, where you can interact with filters, change date ranges, and see live data.
Creating a Dashboard
From an artifact in chat
The simplest way to create a dashboard is to turn an existing artifact into one. When the agent generates a visualization as part of an answer, click the Make it a dashboard button on the artifact. The agent converts the static visualization into an interactive dashboard — replacing hardcoded data with dynamic SQL queries and adding a date range picker and filters. You can also ask the agent directly — for example, “turn this into a dashboard”.With the /dashboard command
For a dashboard built from scratch, use the /dashboard add command with a description of what you want:
- “/dashboard add retention dashboard with main retention metrics and trends, with filters for country and platform”
- “/dashboard add weekly KPI overview showing installs, revenue, churn rate, and DAU with a date range picker and platform breakdown”
- “/dashboard add funnel dashboard showing signup to first purchase conversion with step-by-step drop-off rates”
Saving a Dashboard
When a dashboard is created in chat, it only exists within that conversation. To make it persistent and accessible from the Dashboards page, you need to save it. Click the Save Dashboard button at the top of the dashboard panel. You’ll be prompted to give the dashboard a name and an optional description. Once saved, the dashboard appears in your My Dashboards view as a Private dashboard.Until you save, the dashboard lives only in the chat. If you close the conversation, you can still reopen it and save later — but the dashboard won’t appear on the Dashboards page until you do.
Dashboard Versions in Chat
As you iterate on a dashboard in the same conversation — asking the agent to add charts, change filters, or restructure the layout — each update creates a new version in the chat. You’ll see multiple dashboard reference cards in the conversation, one for each version.- Navigate between versions by clicking different reference cards — each opens that version in the right panel
- Only the latest version is interactive — older versions are visible but their filters are locked
- Save saves the version you’re viewing — whichever version you have open when you click Save Dashboard is the one that gets persisted and becomes accessible on the Dashboards page
Editing a Dashboard
If a saved dashboard needs changes, use Edit in Chat from the dashboard’s action bar. This opens a chat where the agent has the full context of the dashboard. Describe what you want to change:- “Add a table showing the top 10 countries by revenue”
- “Change the bar chart to a line chart”
- “Add a platform filter dropdown”
- “Remove the KPI card for churn rate”
Asking About a Dashboard’s Data
From the Dashboards page
You’re viewing a saved dashboard, adjusting the date range and filters, and you notice something unexpected — a sudden drop in a metric or an unusual spike. Click Ask in the dashboard’s action bar to open a chat that inherits the dashboard’s current filters. You can immediately ask “why did EMEA revenue drop last week?” without re-setting the date range or filters you were already looking at.From a dashboard in chat
When you’re viewing a dashboard in the right panel during a conversation, the same flow works inline. Change the dashboard’s filters to focus on what interests you, then type your question. The agent answers in the context of the dashboard with those specific filters applied. After you send a message, a filters line appears below your question showing which dashboard and filter set the agent is referencing. Hover over it to see the exact filters the agent used — so you always know what data scope the answer is based on.Filters
Date Range (Required)
Every dashboard has a date range picker with a default preset that the agent selects based on the dashboard’s content:- Trend and time series dashboards default to a range like Last 7 days, Last 14 days, or Last 28 days
- Single-day snapshot dashboards default to Yesterday
Additional Filters (Optional)
The agent adds filters based on the data and your request. If you don’t specify which filters to include, the agent uses its judgment — if the data groups by a categorical column (like country or platform), it becomes a filter candidate. Filter types include:- Dropdown filters — Select from a list of values (e.g., country, platform)
- Multi-select filters — Choose multiple values at once
- Cascading filters — A child filter’s options depend on the parent’s selection (e.g., selecting a country updates the available cities)
Breakdown Filters
Breakdown filters let you choose what dimension to group all the metrics in the dashboard by. Instead of filtering out data, a breakdown filter splits it — adding a row for each value of the selected dimension. For example, a KPI table showing installs, revenue, and churn could have a breakdown filter with options like Country, Platform, or Install Date. Selecting “Country” adds a row for each country, showing all metrics per country. Switching to “Platform” regroups the same metrics by platform. Breakdown filters are especially useful for tables where you want to explore the same set of metrics across different slices without creating a separate dashboard for each one.Changing Filter Defaults
You can change the default date range preset and filter values by asking the agent in Edit in Chat — for example, “change the default date range to last 28 days” or “default the platform filter to iOS”.You cannot change the set of available date range presets — those are fixed. But you can change which preset is selected by default, and you can add, remove, or restructure additional filters through Edit in Chat.
Advanced Tips
Performance
ClarityQ optimizes dashboard queries for efficiency and caches results to minimize warehouse load. If a dashboard still feels slow:- Use a shorter default date range — A dashboard defaulting to Last 180 days will query much more data than one defaulting to Last 7 days. Ask the agent to change the default if you don’t need the full range on every load.
- Keep dashboards focused — The agent optimizes queries so that multiple components can share data from fewer queries, but fewer components still means fewer queries overall. Consider splitting large dashboards into multiple smaller ones.
Pagination
For tables with many rows, the agent adds pagination automatically. Be aware that larger page sizes mean more data transferred per query. If a table feels slow, consider reducing the page size or adding filters to narrow the result set.Filters
- Cascading filters support up to 2 levels — A parent filter can drive one child filter, but you can’t chain three or more levels
- Hardcoded filter options load faster than dynamic ones — For stable lists like countries or platforms, hardcoded options avoid an extra query on every load
- Changing a parent filter resets its child — If you change the country, the city filter resets to “All”