The Excerpt Chart macro lets you embed a chart from an Excel-like Table for Confluence (ETC) directly onto a Confluence page as a clean, focused visual. Instead of embedding the full spreadsheet or table, this macro displays only the selected chart, making it easier to showcase key insights where stakeholders need them.
Use it for dashboards, status pages, and executive summaries where clarity, context, and visual impact matter.
✨ Key benefits
-
Visual communication: Surface trends, comparisons, and key metrics in a compact, easy-to-read chart.
-
Contextual display: Place charts exactly where stakeholders need them without showing extra gridlines, sheet tabs, or scrollbars.
-
Automatic syncing: Keep the excerpted chart up to date when the source ETC table changes.
How to create
There are two ways to create the Excerpt Chart macro:
-
Create it directly from the fullscreen editor.
-
Create it manually from a Confluence page.
1. Create an Excerpt Chart from the fullscreen editor
Available in version 7.0 and later, this faster workflow lets you create an excerpt directly from an existing chart in the fullscreen editor.
-
Open the spreadsheet in the fullscreen editor.
-
Select the chart you want to excerpt.
-
Right-click the selected chart to open the context menu.
-
Select Create Excerpt Macro.
-
Configure where the Excerpt macro should add the chart.
-
Choose the target space and page.
-
Enable Auto Sync to update the excerpt automatically when the source table changes. If Auto Sync is disabled, refresh the excerpt manually.
-
Choose where to insert the macro: top of page or bottom of page.
-
The selected chart is added to the Confluence page as an excerpt, so you do not need to configure the Excerpt macro separately.
2. Create an Excerpt Chart from a Confluence page
1. Insert the macro
-
In Confluence page edit mode, type
/excerpt chart. -
Select the Excerpt Chart macro from the list.
2. Configure the macro
-
The configuration panel will open.
-
Choose the source page that contains the Excel-like Table.
-
Select the target ETC sheet and the specific chart you want to excerpt.
-
Click Excerpt to confirm your selection.
Tip: Enable Auto Sync if you want the excerpted chart to update automatically whenever the source table changes. If Auto Sync is disabled, you will need to refresh or update the macro manually.
3. Finalise and display
-
The selected chart will be displayed on your Confluence page.
Use case examples
|
Stakeholder group |
Use case |
Description |
|---|---|---|
|
Executives |
KPI dashboards |
Display charts for revenue, churn, customer growth, or other executive-level metrics. |
|
Marketing |
Campaign analytics |
Show campaign performance charts from tracking sheets. |
|
Product teams |
Release metrics |
Embed burn-down, velocity, or delivery trend charts into project pages. |
Known limitation
🎨 Chart styling may differ from the source
The Excerpt Chart macro reproduces the core chart data and structure, but some styling may not appear exactly the same as it does in the source ETC table.
-
Excel-like themes, including chart colour palettes, fonts, and backgrounds, may not be fully preserved in the excerpt view.
-
Some custom formatting, such as axis label rotation, gridline visibility, and legend positioning, may render differently or revert to default styles.
-
Charts composed of shapes will not render.
Modify an Excerpt Chart macro
-
Hover over the macro you want to edit.
-
Click Edit.
The macro settings will open, allowing you to update the source, selected chart, and sync options.