# Data Reports & Dashboards

Data report artifacts turn raw data into interactive charts, tables, and multi-panel dashboards — directly in conversation. Ask Darcy to visualize data and the result is a live, filterable report you can explore, refresh, and export.

## Chart Types

| Chart Type         | Best For                                          |
| ------------------ | ------------------------------------------------- |
| **Bar**            | Comparing categories                              |
| **Grouped Bar**    | Comparing categories across multiple series       |
| **Stacked Bar**    | Showing composition within categories             |
| **Line**           | Trends over time                                  |
| **Area**           | Volume trends over time                           |
| **Pie / Doughnut** | Proportional breakdowns                           |
| **Table**          | Structured data with sortable columns             |
| **Dashboard**      | Multi-panel layouts combining several chart types |

## Creating Data Reports

Ask Darcy naturally:

* "Create a bar chart comparing Q1 revenue by region"
* "Build a dashboard showing our key sales metrics"
* "Make a table of the top 20 customers by revenue"
* "Chart this data as a line graph over time"

Darcy determines the best chart type based on your data and request. You can always ask for a specific type: "Show this as a stacked bar chart instead."

## Interactive Features

### Filtering

Data reports include a filter panel where you can:

* **Search** data labels
* **Toggle** individual datasets on and off
* **Set value ranges** to zoom into specific data
* **Filter by label** to focus on specific categories

### Refresh

When a report is backed by a data source (API call or transformation script), a **Refresh** button appears. Click it to re-fetch the data and update the visualization with the latest numbers. Dashboard reports also support **date range pickers** for time-based queries.

### KPI Headers

Charts can include KPI summary headers that highlight key metrics (totals, averages, percentages) above the visualization for quick reference.

## Dashboards

Dashboards combine multiple chart panels into a single grid layout. Each panel is independently configured with its own chart type, data, and settings. Darcy creates dashboards when your request involves multiple related metrics that benefit from a unified view.

## Editing

Click **Edit** to modify the report data and configuration. If the report includes a transformation script, the script editor lets you adjust how source data is processed before visualization.

You can also ask Darcy to make changes in chat: "Change the bar chart to a pie chart" or "Add a column for percentage change."

## Export Options

| Option                | Availability                    |
| --------------------- | ------------------------------- |
| **Download as Image** | All chart types                 |
| **Download as CSV**   | Table reports only              |
| **Copy as TSV**       | Table reports (via Copy button) |

{% hint style="info" %}
Data Reports do not currently support public sharing via link. Use the image or CSV export to share report data externally.
{% endhint %}


---

# 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.darcyiq.com/core-features/artifacts/data-reports.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.