Overview

List slides organize information into scannable, structured items. The pptx.dev API supports one through six items per slide, with options for icons, images, and box styling.

Available List Layouts

Each supports modifiers like -title-center, -title-left, -box, -itemimage, -vertical, and -slideimage.

Example: Three-Item Feature List

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": "Product Features",
  "slides": [
    {
      "layout": "list-3x-title-center",
      "title": "Why Teams Choose Us",
      "blocks": [
        {
          "items": [
            {
              "text": "Fast Setup",
              "description": "Get started in under 5 minutes with our API."
            }
          ]
        },
        {
          "items": [
            {
              "text": "Brand Consistent",
              "description": "Every slide matches your color scheme and fonts."
            }
          ]
        },
        {
          "items": [
            {
              "text": "Fully Editable",
              "description": "Output is native .pptx — edit anything in PowerPoint."
            }
          ]
        }
      ],
      "design": {
        "titleAlignment": "center",
        "contentAlignment": "center"
      }
    }
  ],
  "design": {
    "colorScheme": "bold-red",
    "fontScheme": "segoe-ui"
  },
  "catalogs": {
    "layouts": {
      "records": [
        {
          "$schema": "https://openpresentation.org/schema/opf-layout/v1",
          "id": "list-3x-title-center",
          "name": "List 3x Title Center",
          "placeholders": [
            {
              "type": "title"
            },
            {
              "type": "list"
            },
            {
              "type": "list"
            },
            {
              "type": "list"
            }
          ],
          "composition": {
            "mode": "row"
          }
        }
      ]
    }
  }
}'

Example: List with Item Images

Use the -itemimage variant to add an image to each list item:

{
  "$schema": "https://openpresentation.org/schema/opf/v1",
  "name": "Our Leadership Team",
  "slides": [
    {
      "layout": "list-3x-itemimage-title-center",
      "title": "Our Leadership Team",
      "blocks": [
        {
          "items": [
            {
              "text": "Jane Smith",
              "description": "CEO — 15 years in enterprise SaaS"
            }
          ]
        },
        {
          "items": [
            {
              "text": "Alex Chen",
              "description": "CTO — Former engineering lead at Stripe"
            }
          ]
        },
        {
          "items": [
            {
              "text": "Maria Garcia",
              "description": "CPO — Built products used by 10M+ users"
            }
          ]
        }
      ],
      "design": {
        "titleAlignment": "center",
        "contentAlignment": "center"
      }
    }
  ],
  "catalogs": {
    "layouts": {
      "records": [
        {
          "$schema": "https://openpresentation.org/schema/opf-layout/v1",
          "id": "list-3x-itemimage-title-center",
          "name": "List 3x ItemImage Title Center",
          "placeholders": [
            {
              "type": "title"
            },
            {
              "type": "list"
            },
            {
              "type": "list"
            },
            {
              "type": "list"
            }
          ],
          "composition": {
            "mode": "row"
          }
        }
      ]
    }
  }
}

Vertical vs. Horizontal

• Horizontal (default) — items sit side by side. Best for 2-4 items.
• Vertical (-vertical) — items stack top to bottom. Good for timelines, step-by-step processes, or when items have longer descriptions.

When to Use Lists vs. Text Slides

Next Steps

• Add metrics with KPI number slides
• Pair with title slides for section openers
• Browse list layouts in the gallery