Overview
OPF chart content pairs a chart type with tabular data. The Gallery has 27 chart presets: 26 chart types and a combo preset. This guide shows how to add that content to a presentation and choose a layout for its evidence.
Chart Layout Options
| Layout | Description |
|---|---|
chart |
One to six charts in a grid, with an optional note |
chart-beside |
A chart with its takeaway beside it |
dashboard |
Headline metrics above charts or tables |
two-column |
Two independent columns, each accepting a chart or other content |
Any of them can sit on an image background: set the slide's design.background to an image ({ "type": "image", "src": "…" }).
OPF Chart Types
Use these lowercase values in chart.type. The columns in chart.data determine the number of series; numbered suffixes are not separate types.
- Columns and bars:
column,stacked-column,100pct-stacked-column,bar,stacked-bar,100pct-stacked-bar. - Lines:
line,line-with-markers,stacked-line,stacked-line-with-markers. - Areas:
area,stacked-area,100pct-stacked-area. - Circular charts:
pie,doughnut. - Specialty charts:
waterfall,funnel,treemap,histogram,box-and-whisker,scatter,radar,radar-with-markers,filled-radar,pareto. - Maps:
world; the category values name the places. - Mixed charts:
combo, with selected series drawn as lines beside the column series.
Browse the chart catalog for each type’s data shape and complete OPF example.
Example: Revenue Column Chart
Use this complete OPF document with the complete authenticated API recipe, which saves the response bytes as a .pptx file.
{
"$schema": "https://openpresentation.org/schema/opf/v1",
"name": "Revenue Report",
"slides": [
{
"layout": "chart",
"title": "Revenue by Quarter",
"chart": {
"type": "column",
"data": {
"columns": [
"Series",
"Q1",
"Q2",
"Q3",
"Q4"
],
"rows": [
[
"2025",
1200,
1800,
2100,
2400
],
[
"2026",
1500,
2200,
2800,
null
]
]
}
},
"design": {
"titleAlignment": "center",
"contentAlignment": "center"
}
}
],
"design": {
"colorScheme": "forest-green",
"fontScheme": "calibri"
},
"catalogs": {
"default": {
"source": "https://www.pptx.gallery",
"colorSchemes": {
"forest-green": {
"name": "Forest Green",
"summary": "Organic green palette for growth, health, and sustainability stories.",
"description": "A green and soft-neutral scheme for decks about growth, renewal, wellness, and environmental impact.",
"accent1": "#4A7C59",
"accent2": "#68B0AB",
"accent3": "#8FC0A9",
"accent4": "#C8D5B9",
"accent5": "#FAF3DD",
"accent6": "#BFBFBF",
"dark1": "#000000",
"dark2": "#263F2E",
"light1": "#FFFFFF",
"light2": "#EEF5F0",
"hyperlink": "#4A7C59",
"followedHyperlink": "#68B0AB",
"tags": [
"organic",
"healthy",
"sustainable",
"fresh",
"balanced"
]
}
},
"fontSchemes": {
"calibri": {
"name": "Calibri",
"major": "Calibri",
"minor": "Calibri",
"type": "sans-serif",
"app": "powerpoint",
"languageFamily": "latin",
"languages": [],
"textSample": "Smooth professional look",
"description": "Calibri is a sans serif OPF font scheme for Latin presentations, using Calibri for both headings and body text."
}
},
"layouts": {
"chart": {
"name": "Chart",
"summary": "One to six charts, with an optional note.",
"tags": [
"Visuals"
],
"direction": "column",
"regions": [
{
"name": "title"
},
{
"name": "charts",
"accepts": [
"chart",
"group"
],
"role": "primary",
"flow": "grid"
},
{
"name": "note",
"size": "auto",
"accepts": [
"text"
],
"role": "supporting",
"flow": "none"
}
],
"description": "Give a chart enough space to show its evidence. Use the title to state the conclusion and labels to explain the measures.",
"preview": {
"vectorSrc": "https://www.pptx.gallery/layout-previews/chart.svg"
}
}
}
}
}
}
Example: Pie Chart
{
"$schema": "https://openpresentation.org/schema/opf/v1",
"name": "Market Share",
"slides": [
{
"layout": "chart-beside",
"title": "Market Share",
"chart": {
"type": "pie",
"data": {
"columns": [
"Series",
"Our Product",
"Competitor A",
"Competitor B",
"Others"
],
"rows": [
[
"Share",
35,
28,
22,
15
]
]
}
},
"design": {
"contentAlignment": "center"
}
}
],
"catalogs": {
"default": {
"source": "https://www.pptx.gallery",
"layouts": {
"chart-beside": {
"name": "Chart beside",
"summary": "A chart with the takeaway beside it.",
"tags": [
"Visuals"
],
"direction": "column",
"regions": [
{
"name": "title"
},
{
"direction": "row",
"regions": [
{
"name": "chart",
"size": 3,
"accepts": [
"chart"
],
"role": "primary",
"flow": "none"
},
{
"name": "notes",
"size": 2,
"accepts": [
"text",
"list",
"metric",
"quote",
"chart"
],
"role": "supporting",
"flow": "column"
}
]
}
],
"description": "Pair a chart with an explanation of its result. Keep the text focused on the pattern or decision supported by the data.",
"preview": {
"vectorSrc": "https://www.pptx.gallery/layout-previews/chart-beside.svg"
}
}
}
}
}
}
Example: Two Charts Side by Side
{
"$schema": "https://openpresentation.org/schema/opf/v1",
"name": "Sales Overview",
"slides": [
{
"layout": "chart",
"title": "Sales Overview",
"blocks": [
{
"chart": {
"type": "line-with-markers",
"data": {
"columns": [
"Series",
"Jan",
"Feb",
"Mar",
"Apr"
],
"rows": [
[
"Revenue",
100,
120,
115,
140
]
]
}
}
},
{
"chart": {
"type": "doughnut",
"data": {
"columns": [
"Series",
"Online",
"In-Store",
"Partners"
],
"rows": [
[
"Channel",
55,
30,
15
]
]
}
}
}
],
"design": {
"contentAlignment": "center"
}
}
],
"catalogs": {
"default": {
"source": "https://www.pptx.gallery",
"layouts": {
"chart": {
"name": "Chart",
"summary": "One to six charts, with an optional note.",
"tags": [
"Visuals"
],
"direction": "column",
"regions": [
{
"name": "title"
},
{
"name": "charts",
"accepts": [
"chart",
"group"
],
"role": "primary",
"flow": "grid"
},
{
"name": "note",
"size": "auto",
"accepts": [
"text"
],
"role": "supporting",
"flow": "none"
}
],
"description": "Give a chart enough space to show its evidence. Use the title to state the conclusion and labels to explain the measures.",
"preview": {
"vectorSrc": "https://www.pptx.gallery/layout-previews/chart.svg"
}
}
}
}
}
}
Chart Best Practices
- Limit data points. 4-8 categories per chart keeps slides readable.
- Use the right chart type. Comparisons → column/bar. Trends → line. Parts of whole → pie/doughnut.
- Label clearly. Use descriptive series names and category labels.
- Pair with KPI slides. Lead with a number slide for the headline metric, then follow with a chart for the trend.
Next Steps
- Deep dive into column and bar charts
- Learn about line charts
- Explore pie and doughnut charts