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

# Charts and visualizations

> Choose chart types and configure axes and filters for your data.

Each chart in a dashboard is an independent visualization with its own data source, query configuration, and display settings.

## Available chart types

<CardGroup cols={3}>
  <Card title="Bar chart" icon="chart-bar">
    Compare values across categories. Use grouped bars for side-by-side comparison and stacked bars to show composition.
  </Card>

  <Card title="Line chart" icon="chart-line">
    Show trends over time. Best for continuous data with a time-based x-axis.
  </Card>

  <Card title="Pie chart" icon="chart-pie">
    Display proportional breakdown of a whole. Limit to 5–7 segments for readability.
  </Card>

  <Card title="Table" icon="table">
    Display raw or aggregated data in rows and columns. Supports sorting and conditional formatting.
  </Card>

  <Card title="Number card" icon="hash">
    Show a single key metric with an optional comparison value and trend indicator.
  </Card>

  <Card title="Scatter plot" icon="scatter-chart">
    Explore correlation between two numeric variables. Supports a third dimension via bubble size.
  </Card>
</CardGroup>

## Configuring axes

After selecting a chart type, configure the data fields in the chart editor:

| Field                  | Description                                                                         |
| ---------------------- | ----------------------------------------------------------------------------------- |
| **Data source**        | The connected source to query.                                                      |
| **X-axis / Dimension** | The field to group or categorize by (often a date, category, or name).              |
| **Y-axis / Metric**    | The numeric field to measure. Supports aggregations: sum, count, average, min, max. |
| **Color / Series**     | An optional field to split the data into multiple series or colors.                 |

For time-based charts, the x-axis field can be bucketed by day, week, month, or year.

## Adding filters

Filters narrow the data shown in a chart without changing the underlying data source.

1. Open the chart editor and go to the **Filters** tab.
2. Click **Add filter**.
3. Select a field, choose an operator (equals, contains, greater than, etc.), and enter a value.
4. Save the chart.

Dashboard-level filters override chart-level filters and apply to all charts on the page simultaneously. Add them from the dashboard toolbar under **Filters**.

<Note>
  Filter changes on a shared dashboard affect all viewers. For personal filtering, use the chart editor or duplicate the dashboard.
</Note>