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

# Chart guide

> Map columns, split series, color independently, and build facets and legends.

A chart is one block type among many. The interesting work is mapping columns, then styling layers the same way you would style type or a rectangle.

## Insert and map

1. Select a frame (or insert one from the insert panel — **I**).
2. **Insert → Charts** and pick a type, or insert a column chart and change the type in Properties.
3. With the chart selected, link a **dataset**.
4. Map columns in **Dimensions**. Required roles are marked. Unused optional roles stay empty.

**Color** is always its own encoding. It does not split series. To get multiple bars, lines, or areas, use **Series**, **Lines**, or **Areas**.

## Chart types

Available from the insert panel or the chart type switcher:

| Type        | Use when                                                                                  |
| ----------- | ----------------------------------------------------------------------------------------- |
| Column      | Categories along X, values as vertical bars. Optional Series for grouped or stacked bars. |
| Bar         | Same data, horizontal. Value is X; category is Y.                                         |
| Line        | Continuous X (date or number) with one or more lines.                                     |
| Area        | Line with a fill to the baseline. Series role is Areas.                                   |
| Dumbbell    | Two values per category (start / end) — before/after, two years, two groups.              |
| Slope       | Two-point change by category, read left-to-right.                                         |
| Big number  | A single highlighted value, optional label.                                               |
| Ranked list | Listicle / top-N layout.                                                                  |
| Table       | Not a chart type — a separate block for the raw or formatted grid.                        |

Scatter, bubble, pie, and donut are available from the chart type switcher on a chart block. Maps are coming soon.

Try a **sample dataset** from the Datasets tab if you want a type that already has the right columns.

## Series, color, and facets

* **Series / Lines / Areas** — split the dataset into multiple marks. One column, one series per unique value.
* **Color** — paint marks from a categorical palette or a numeric scale. Independent of the series split: you can split lines by region and color by another column.
* **Facet** — small multiples. Map a facet column and the block becomes a grid (one mini chart per value). Facets are wired for column, bar, line, area, scatter, and slope. Other types may show the dimension before the grid is connected.

When a facet grid is on, select the whole block for shared grid settings, or select one facet panel to override that cell.

## Legends, labels, and axes

Insert a **legend** block and point it at the chart. Color and size legends are separate items.

Value labels, line labels, and axis titles are editable in Properties and, for many text layers, on the canvas. Use a **text style** if you want labels to stay in sync with the rest of the frame.

Named frame themes (Editorial, Minimal, Bold) and the default palettes are a good first stop before hand-tuning every bar.

## A reliable test path

1. Upload or pick a sample dataset.
2. Insert a column chart; map X and Y; try Color if the table has a category.
3. Change one axis title and one bar color from the layers tree.
4. Add a legend and a heading.
5. Switch Tablet and Mobile and see what you want to override.

If a dimension is labelled coming soon, it is visible on purpose — it is not wired yet.


## Related topics

- [Florence help](/index.md)
- [Brand kits](/brand-kits.md)
- [Export and publish](/export-and-publish.md)
- [Getting started](/getting-started.md)