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

Each variant also supports -title-center, -title-left, -box, and -slideimage modifiers.

Example: Single Hero Metric

{
  "layout": "number-1x",
  "content": {
    "heading": "Monthly Active Users",
    "items": [
      {
        "value": "2.4M",
        "label": "Active users in February"
      }
    ]
  }
}

Example: Three KPIs with Title

curl -X POST https://api.pptx.dev/v1/presentations \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "title": "Q1 Metrics",
    "colorScheme": "forest-green",
    "fontScheme": "calibri",
    "slides": [
      {
        "layout": "number-3x-title-center",
        "content": {
          "heading": "Q1 Performance",
          "items": [
            { "value": "$1.2M", "label": "Revenue" },
            { "value": "94%", "label": "Retention" },
            { "value": "72", "label": "NPS Score" }
          ]
        }
      }
    ]
  }'

Example: Six-Metric Dashboard

For executive dashboards, the number-6x layout arranges six KPIs in a clean grid:

{
  "layout": "number-6x",
  "content": {
    "heading": "Company Dashboard",
    "items": [
      { "value": "$4.8M", "label": "ARR" },
      { "value": "1,240", "label": "Customers" },
      { "value": "98.7%", "label": "Uptime" },
      { "value": "12ms", "label": "Avg Latency" },
      { "value": "4.8/5", "label": "CSAT" },
      { "value": "23%", "label": "MoM Growth" }
    ]
  }
}

Formatting Tips

• Use short values. $1.2M reads better than $1,200,000 at 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