Chart
A chart draws the numbers in a table on the same page as columns, bars, a line, a pie or a donut. The table stays the one place the numbers live: change a number and the chart redraws, so the two can never disagree. Use a chart when the shape of the numbers matters more than the numbers themselves: which month was best, how fast something is growing, what share each part takes.
Insert it
Type this | To get |
|---|---|
/bar, /pie or /donut | A chart, drawn from the first table on the page |
/chart | A list with Diagram (Mermaid) first and Chart second; choose Chart |
Type the command at the start of a line, or after a space, and press Enter. Or choose + on the toolbar, then Chart. If you had text selected, the chart takes its place.
A new chart starts as a column chart of the first table on the page. Choose the table you mean in its Table menu, as described under Changing and removing it.
How a chart reads a table
The first row names the series. Each column after the first becomes one color, listed in the legend under the chart. A column with no numbers at all, such as a Notes column, is left out.
The first column labels the rows. Each row becomes a group of columns, a bar, a point on the line, or a slice.
The other cells are the numbers. Values written the way people write them count:
1,234,45%,$9.50. A row with no numbers at all is skipped.Tables are numbered from the top of the page, every table counted. On this page the table under Insert it is Table 1, so the charts under The five types draw Tables 2 to 5.
The five types, and when to use each
Column: compare amounts across a few groups
Upright columns, one group for each row, one color for each series. Use it to compare a handful of periods or groups side by side, and to set two or three series against each other. For example, sign-ups on the free and team plans, month by month:
Month | Free | Team |
|---|---|---|
July | 120 | 18 |
August | 180 | 26 |
September | 260 | 41 |
October | 310 | 55 |
November | 290 | 62 |
December | 240 | 70 |
Sign-ups by month
- Free
- Team
The free plan peaked in October; the team plan kept growing. Nobody has to read twelve numbers to see that.
Bar: long labels, or a ranking
The same idea turned on its side: one bar for each row, its label to the left. Labels have room to be long, so use it when the rows are sentences rather than single words, or when you want to rank things. Sort the table from the largest number down and the chart reads as a ranking. For example, the questions the support team answered most:
Topic | Questions |
|---|---|
Signing in on a new phone | 46 |
Sharing a folder with a team | 31 |
Editing offline | 22 |
Changing the billing address | 12 |
Installing on Linux | 7 |
Support questions in September
- Questions
Line: change over time
One line for each series, joining the rows in order from left to right. Use it for something measured again and again over time, where the trend matters more than any one point. For example, weekly readers on a computer and on a phone:
Week | Computer | Phone |
|---|---|---|
Aug 3 | 410 | 120 |
Aug 10 | 430 | 150 |
Aug 17 | 420 | 180 |
Aug 24 | 460 | 230 |
Aug 31 | 450 | 260 |
Sep 7 | 480 | 310 |
Sep 14 | 470 | 350 |
Sep 21 | 490 | 400 |
Weekly readers
- Computer
- Phone
The rows are named along the bottom edge. When they are too long to fit side by side they turn at an angle, and when there are too many for even that, only every second or third is written: point at a line to see which row it is.
Pie: parts of a whole
One slice for each row, sized by its share of the total. Use it only when the rows add up to a whole that means something, such as a budget or a week, and there are five slices or fewer. For example, where a team’s 40-hour week goes:
Activity | Hours |
|---|---|
Building | 18 |
Meetings | 8 |
Reviews | 6 |
Support | 5 |
Other | 3 |
Where a 40-hour week goes
- Building18 (45%)
- Meetings8 (20%)
- Reviews6 (15%)
- Support5 (13%)
- Other3 (8%)
A pie uses one column of numbers. The first, unless you choose another under More Options. To see every column at once, make it a column chart instead.
Donut: parts of a whole, with the total
The same slices as a pie, drawn as a ring, with the total of the column in the middle. Use it where a pie fits and the total is worth showing too. The same week as a donut:
Where a 40-hour week goes
- Building18 (45%)
- Meetings8 (20%)
- Reviews6 (15%)
- Support5 (13%)
- Other3 (8%)
Like a pie, a donut uses one column of numbers. A large total is shortened in the middle, such as 1.2K for 1,234. The middle can show the largest slice’s share, or your own words, instead: see More Options for pies and donuts below.
Point at a column, a bar or a point on a line to see its value. Negative numbers go below zero in columns, bars and lines, where the axis shows zero as a line of its own; in pies and donuts they count as nothing.
Every chart has a legend, below it unless you choose otherwise. A pie’s or a donut’s legend gives each slice’s number and its share beside its name, such as Building 18 (45%).
Changing and removing it
While you are editing, these controls sit above the chart:
Table chooses which table on the page to draw: Table 1 is the first.
Type switches between Column (Vertical), Bar (Horizontal), Line, Pie and Donut. The table is not touched.
Style decides how this one looks. Theme Default follows each reader’s own style, Minimal or Glass, from the appearance menu. Minimal or Glass keeps it that way for everyone, whatever their style, and in PDF, HTML and website exports too. An export has no reader’s style, so a Theme Default one comes out as Minimal.
Chart Title (Optional) is a line shown above the chart.
More Options opens the rest, described below and each one drawn under Every option, one table. It shows only the options that apply to the chart’s type; the others keep their settings, so switching type and back loses nothing.
More Options for every chart
Legend puts the key Below the chart, Beside it (below again on a narrow screen such as a phone), or Hidden.
Size is Small, Medium (the usual size) or Large. A chart always shrinks to fit a narrow screen.
Number Format decides how numbers are written on the chart: in its axis, its value labels, its legend and the middle of a donut. Auto follows the table: when most of its numbers end in
%the chart writes percentages, and when most carry a currency symbol such as$,£or€it writes money with that symbol. Plain, Percent and Currency choose for it; currency uses the symbol in the table, or $ when there is none.Colors lists every series (every slice, on a pie or a donut) with its color. Choose one to give that series a color of your own; Reset puts back the usual one. A color belongs to the series’ name, so it stays with the series when you move its row, and it is used in both Minimal and Glass.
Swap Rows and Columns charts the table the other way round: each row becomes a series (one color), and the columns are named along the bottom edge. For example, the sign-ups table above, swapped, sets July against December for each plan.
More Options for column, bar and line charts
Axes and Gridlines is on unless you turn it off: the numbers up the side (or along the bottom of a bar chart) and light lines across the chart at each of them. Off, the chart is only its bars or lines and the row names.
X Axis Title and Y Axis Title name the bottom edge and the side, such as “Month” and “Sign-ups”. Each title stays with what its axis shows, so switching a column chart to a bar chart moves them round with the axes.
Value Labels writes each column’s, bar’s or point’s number on the chart. In a stacked chart the number sits inside its piece when it fits.
Stacked (column and bar) piles each row’s series into one column instead of standing them side by side, so the column’s height is the row’s total. Negative numbers pile downward from zero.
Points, Smooth Curve and Filled Area (line) mark each row with a dot, round the line off between the points (never past them), and shade the area under each line.
Y Axis (line) starts From Zero, as usual, or is Fit to Data, from just under the smallest number to just over the largest, which shows small changes in large numbers. Columns and bars always start at zero: a bar’s length is its number, and a bar cut short would say something the numbers do not.
More Options for pies and donuts
Column chooses which column of numbers the pie is cut from, when the table has more than one: the first unless you choose another. With rows and columns swapped it is Row instead.
Values in Legend is on unless you turn it off: each slice’s number and share beside its name.
Largest Slice First sorts the slices from the largest down, clockwise from the top, whatever the order of the table. Each slice keeps its color.
Center (donut) chooses what the middle says: the Total, as usual; the Largest Slice, as its share with its name under it; or Custom Text, a few words of your own typed in Center Text.
If there is no table on the page yet, the chart says so; if its table has no numbers, it says that instead. To remove a chart, click its edge to select it and press Delete. The table stays.
Adding a table above a chart renumbers the tables. A chart pointing at Table 2 then draws the new one. After adding or removing a table, check the Table menu of every chart below it.
Every option, one table
The same four quarters of sales, drawn again and again with an option or two changed each time, so you can see what each one does before you try it. Every chart below reads this table:
Quarter | Online | In store |
|---|---|---|
Q1 | 42,000 | 61,000 |
Q2 | 48,000 | 58,000 |
Q3 | 71,000 | 55,000 |
Q4 | 57,000 | 64,000 |
As it comes, a new chart of this table is a column chart with its axes and gridlines, and the legend below:
Sales by quarter
- Online
- In store
Column and bar options
X Axis Title “Quarter” and Y Axis Title “Sales”, with the legend Beside the chart:
Sales by quarter
- Online
- In store
Value Labels on, with Number Format set to Currency. The table has no currency symbol, so Auto would write plain numbers; Currency writes dollars:
Sales by quarter
- Online
- In store
Stacked, so each column is the quarter’s total, online and in store together:
Sales by quarter
- Online
- In store
The same chart as a bar chart, stacked, with its axis titles. The titles moved round with the axes:
Sales by quarter
- Online
- In store
Axes and Gridlines off, and the legend Hidden: only the columns and the quarters are left, for when the chart is a sketch rather than a reference:
Sales by quarter
Swap Rows and Columns: each quarter becomes a series, and Online and In store are named along the bottom edge, so the chart compares the two ways of selling rather than the four quarters:
Sales by quarter
- Q1
- Q2
- Q3
- Q4
Colors: Online in teal and In store in orange, in place of the usual colors:
Sales by quarter
- Online
- In store
Size set to Small:
Sales by quarter
- Online
- In store
Line options
A line chart of the table as it comes: the Y axis starts at zero.
Sales by quarter
- Online
- In store
Points and Smooth Curve on:
Sales by quarter
- Online
- In store
Filled Area on:
Sales by quarter
- Online
- In store
Y Axis set to Fit to Data, with Points on. The axis now runs from just under 42,000 to just over 71,000, so the rise and fall between quarters is easier to see. Say so when you use it: the gap between the lines looks larger than it is.
Sales by quarter
- Online
- In store
Pie and donut options
A pie of the table as it comes: the first column of numbers, Online, one slice per quarter in the table’s order.
Online sales by quarter
- Q142,000 (19%)
- Q248,000 (22%)
- Q371,000 (33%)
- Q457,000 (26%)
Largest Slice First: Q3, the largest, now starts at the top, and the others follow clockwise from the largest down. Each slice keeps its color:
Online sales by quarter
- Q371,000 (33%)
- Q457,000 (26%)
- Q248,000 (22%)
- Q142,000 (19%)
Column set to In store, with Values in Legend off, so the legend gives only the names:
In-store sales by quarter
- Q1
- Q2
- Q3
- Q4
A donut with Center set to Largest Slice: the middle gives Q3’s share, with its name under it, instead of the total:
Online sales by quarter
- Q142,000 (19%)
- Q248,000 (22%)
- Q371,000 (33%)
- Q457,000 (26%)
A donut with Center set to Custom Text, and Center Text “Online”:
Sales by quarter
- Q142,000 (19%)
- Q248,000 (22%)
- Q371,000 (33%)
- Q457,000 (26%)
Good practice
Say what the chart shows in its title, including when: “Sign-ups by month, 2026”, not “Chart”.
Put the chart right after its table, so readers who want an exact number find it at once.
Few series. Two or three colors compare well; eight become a puzzle. Stacked columns handle a few more, when the total is what matters.
Pick the type by the question. Comparing: column or bar. Over time: line. Share of a whole: pie.
Related elements
Table holds the numbers a chart draws.
Diagram (Mermaid) draws flowcharts and timelines from text, rather than numbers.
Math shows the formula behind the numbers.
Applies to | Tesria 0.5 and later |
|---|---|
Updated | September 29, 2026 |
Changes | Revised. |