Overview
Number slides put your KPIs front and center. The pptx.dev API supports layouts for one through six metrics per slide, so you can build anything from a single hero stat to a full metrics dashboard.
Available Number Layouts
| Layout | Description |
|---|---|
metrics |
One to six labeled values in adaptive grid flow, with an optional note |
dashboard |
Headline metrics above charts or tables |
two-column |
A metric beside another metric or supporting content |
OPF uses the metric content kind. Repeated metrics live in separate blocks entries. Select a current intent from the layout catalog; numbered number-* variants are retired.
Example: Single Hero Metric
{
"$schema": "https://openpresentation.org/schema/opf/v1",
"name": "Monthly Active Users",
"slides": [
{
"layout": "metrics",
"title": "Monthly Active Users",
"metric": {
"value": "2.4M",
"label": "Active users in February"
},
"design": {
"contentAlignment": "center"
}
}
],
"catalogs": {
"default": {
"source": "https://www.pptx.gallery",
"layouts": {
"metrics": {
"name": "Metrics",
"summary": "One to six headline numbers, with an optional note.",
"tags": [
"Numbers"
],
"design": {
"contentAlignment": "center"
},
"direction": "column",
"regions": [
{
"name": "title"
},
{
"name": "metrics",
"accepts": [
"metric",
"group"
],
"role": "primary",
"flow": "grid",
"anchor": "middle"
},
{
"name": "note",
"size": "auto",
"accepts": [
"text",
"list"
],
"role": "supporting",
"flow": "none"
}
],
"description": "Highlight a small set of important numbers. Give each number a label and the context needed to interpret it.",
"preview": {
"vectorSrc": "https://www.pptx.gallery/layout-previews/metrics.svg"
}
}
}
}
}
}
Example: Three KPIs with Title
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": "Q1 Metrics",
"slides": [
{
"layout": "metrics",
"title": "Q1 Performance",
"blocks": [
{
"metric": {
"value": "$1.2M",
"label": "Revenue"
}
},
{
"metric": {
"value": "94%",
"label": "Retention"
}
},
{
"metric": {
"value": "72",
"label": "NPS Score"
}
}
],
"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": {
"metrics": {
"name": "Metrics",
"summary": "One to six headline numbers, with an optional note.",
"tags": [
"Numbers"
],
"design": {
"contentAlignment": "center"
},
"direction": "column",
"regions": [
{
"name": "title"
},
{
"name": "metrics",
"accepts": [
"metric",
"group"
],
"role": "primary",
"flow": "grid",
"anchor": "middle"
},
{
"name": "note",
"size": "auto",
"accepts": [
"text",
"list"
],
"role": "supporting",
"flow": "none"
}
],
"description": "Highlight a small set of important numbers. Give each number a label and the context needed to interpret it.",
"preview": {
"vectorSrc": "https://www.pptx.gallery/layout-previews/metrics.svg"
}
}
}
}
}
}
Example: Six-Metric Dashboard
For executive dashboards, the metrics layout arranges six KPIs in a clean grid:
{
"$schema": "https://openpresentation.org/schema/opf/v1",
"name": "Company Dashboard",
"slides": [
{
"layout": "metrics",
"title": "Company Dashboard",
"blocks": [
{
"metric": {
"value": "$4.8M",
"label": "ARR"
}
},
{
"metric": {
"value": "1,240",
"label": "Customers"
}
},
{
"metric": {
"value": "98.7%",
"label": "Uptime"
}
},
{
"metric": {
"value": "12ms",
"label": "Avg Latency"
}
},
{
"metric": {
"value": "4.8/5",
"label": "CSAT"
}
},
{
"metric": {
"value": "23%",
"label": "MoM Growth"
}
}
],
"design": {
"contentAlignment": "center"
}
}
],
"catalogs": {
"default": {
"source": "https://www.pptx.gallery",
"layouts": {
"metrics": {
"name": "Metrics",
"summary": "One to six headline numbers, with an optional note.",
"tags": [
"Numbers"
],
"design": {
"contentAlignment": "center"
},
"direction": "column",
"regions": [
{
"name": "title"
},
{
"name": "metrics",
"accepts": [
"metric",
"group"
],
"role": "primary",
"flow": "grid",
"anchor": "middle"
},
{
"name": "note",
"size": "auto",
"accepts": [
"text",
"list"
],
"role": "supporting",
"flow": "none"
}
],
"description": "Highlight a small set of important numbers. Give each number a label and the context needed to interpret it.",
"preview": {
"vectorSrc": "https://www.pptx.gallery/layout-previews/metrics.svg"
}
}
}
}
}
}
Formatting Tips
- Use short values.
$1.2Mreads better than$1,200,000at presentation scale. - Include units in the label. Keep the value clean and put context in the label text.
- Limit to 3-4 metrics per slide for most audiences. Use 5-6 only for executive dashboards where the audience expects density.
Next Steps
- Visualize trends with chart slides
- Add context with text slides
- Browse number layouts in the gallery