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

The layout IDs keep their number-* names, while OPF uses the metric content kind. Select an exact variant from the layout catalog; suffixes are not interchangeable. Repeated metrics live in separate blocks entries.

Example: Single Hero Metric

{
  "$schema": "https://openpresentation.org/schema/opf/v1",
  "name": "Monthly Active Users",
  "slides": [
    {
      "layout": "number-1x",
      "title": "Monthly Active Users",
      "metric": {
        "value": "2.4M",
        "label": "Active users in February"
      },
      "design": {
        "contentAlignment": "center"
      }
    }
  ]
}

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 '{
  "$schema": "https://openpresentation.org/schema/opf/v1",
  "name": "Q1 Metrics",
  "slides": [
    {
      "layout": "number-3x-title-center",
      "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": {
    "layouts": {
      "records": [
        {
          "$schema": "https://openpresentation.org/schema/opf-layout/v1",
          "id": "number-3x-title-center",
          "name": "Number 3x Title Center",
          "placeholders": [
            {
              "type": "title"
            },
            {
              "type": "metric"
            },
            {
              "type": "metric"
            },
            {
              "type": "metric"
            }
          ],
          "composition": {
            "mode": "row"
          }
        }
      ]
    }
  }
}'

Example: Six-Metric Dashboard

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

{
  "$schema": "https://openpresentation.org/schema/opf/v1",
  "name": "Company Dashboard",
  "slides": [
    {
      "layout": "number-6x",
      "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"
      }
    }
  ]
}

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