Skip to content
Yamuno
Browse

Quick Start Guide

This guide builds a bar chart from a table on a Confluence page. It takes a couple of minutes.

Before you start

  • Charts for Confluence is installed on your Confluence Cloud site.
  • Your site has a trial or a subscription, so you can create charts. See Licensing.
  • You can edit the page you want to add the chart to.

Step 1: Add a table to the page

Edit a page and add a table like this one:

Month Revenue Costs
Jan 12,400 8,100
Feb 13,900 8,600
Mar 15,200 9,000

Values such as "1,200", "$12", "45%" and "(30)" are read as numbers, so you don't need to clean them up first.

Step 2: Insert the chart

  1. Put your cursor where the chart should go.
  2. Type /Charts for Confluence and press Enter.
  3. The chart editor opens full screen and asks Where's your data?

Step 3: Pick the table

  1. Choose Table on this page. When the page has tables, this option comes first and says Found N tables.
  2. The first table is picked for you. Pick another one if you need to.

Step 4: Chart it

  1. Under Chart it, keep Use the numbers. Month becomes the labels, and Revenue and Costs each become a series.
  2. Choose Bar as the chart type.
  3. Add a title, such as "Revenue and costs by month".
  4. Save the chart, then publish the page.

Step 5: Keep it up to date

The chart follows the table. When someone edits the table and publishes the page, the chart shows the new numbers. While you are still editing, use Re-read page in the chart editor, or reload, to see changes you typed into the table.

Try another data source

  • Enter data: type into the grid or paste a range from Excel or Google Sheets. Fill with example gives you sample rows to start from.
  • Upload a file: pick a CSV, TSV or .xlsx file up to 5 MB and 5,000 rows.
  • Jira issues: choose projects, a saved filter or JQL, and count issues by a field such as Status.

See Data sources for the details of each.

Next steps

  1. Read about chart types and options
  2. Ask a Confluence admin to set up branding and colour palettes
  3. Check the Known Issues

Need help? Visit our Support Portal.

Stuck on something this page does not cover? Ask the developers.