> For the complete documentation index, see [llms.txt](https://docs.toucanai.cloud/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.toucanai.cloud/build/charts/chart-types.md).

# Chart types

{% hint style="info" %}
**Target Audience**: Non-technical users and builders configuring visualizations in the Library.
{% endhint %}

## Overview

Toucan AI supports several chart types in the **Library** manual editor. Each type has its own dimension, measure, and display options. Use the pages below when you refine a chart after AI creation or build one from scratch in **Manual Edit** mode.

## Prerequisites

* A [connected and active database](/build/data-connections/how-to/add-a-database.md).
* A **Data** source (database and query) selected in the chart editor.

## Chart type reference index

| Page                                                                | Use case                                  |
| ------------------------------------------------------------------- | ----------------------------------------- |
| [Bar chart](/build/charts/chart-types/bar-chart.md)                 | Compare categories or rankings            |
| [Stacked bar chart](/build/charts/chart-types/stacked-bar-chart.md) | Part-to-whole breakdown within categories |
| [Line chart](/build/charts/chart-types/line-chart.md)               | Trends over time or by category           |
| [Circular chart](/build/charts/chart-types/circular-chart.md)       | Share of a whole (pie / donut)            |
| [Heatmap chart](/build/charts/chart-types/heatmap-chart.md)         | Two dimensions with cell intensity        |
| [Value](/build/charts/chart-types/value.md)                         | Single KPI with optional variation        |
| [Table](/build/charts/chart-types/table.md)                         | Tabular data with column-level formatting |

## Shared chart-level settings

All chart types share these fields at the top of the manual editor:

| Option        | Description                                           |
| ------------- | ----------------------------------------------------- |
| **Title**     | Name shown in the Library and embeds.                 |
| **Narrative** | Optional explanation for end users.                   |
| **Data**      | Database and query that supply columns for the chart. |

## Shared measure options

Where a chart uses a **metric** column (Bars, Line, Value, etc.), you can usually set:

* **Aggregation** (Sum, Average, Count rows, etc.). Options depend on column type.
* **Format number** — decimals, percent, currency, and **Unit** for numeric columns.

See each chart page above for the exact fields available.

**Suggested next steps**

* [Create a chart](/build/charts/how-to/create-a-chart.md)
* [Create a chart with AI](/build/charts/how-to/create-a-chart-with-ai.md)
* [Customize a chart manually](/build/charts/how-to/customize-a-chart-manually.md)