Overview

List slides organize information into scannable, structured items. OPF lists carry their authored items and can flow across columns. Design settings control bullets and cards.

Available List Layouts

The items payload holds the ordered list. Its columns setting can divide a long list across columns. Choose the layout by intent and use design settings for bullet style and cards; suffixes such as -3x or -box are not current layout IDs.

Example: Three-Item Feature List

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": "Product Features",
  "slides": [
    {
      "layout": "list",
      "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": {
    "default": {
      "source": "https://www.pptx.gallery",
      "colorSchemes": {
        "bold-red": {
          "name": "Bold Red",
          "summary": "Confident red and teal accents for urgent, high-salience stories.",
          "description": "A bold red-led scheme with teal and navy support. Use it when the deck needs urgency, contrast, and clear emphasis.",
          "accent1": "#A41410",
          "accent2": "#2693A1",
          "accent3": "#EFA517",
          "accent4": "#E86D1F",
          "accent5": "#324472",
          "accent6": "#EFECCA",
          "dark1": "#000000",
          "dark2": "#232323",
          "light1": "#FFFFFF",
          "light2": "#DCDCDC",
          "hyperlink": "#324472",
          "followedHyperlink": "#2693A1",
          "tags": [
            "bold",
            "urgent",
            "energetic",
            "decisive",
            "impactful"
          ]
        }
      },
      "fontSchemes": {
        "segoe-ui": {
          "name": "Segoe UI",
          "major": "Segoe UI Semibold",
          "minor": "Segoe UI",
          "type": "sans-serif",
          "app": "powerpoint",
          "languageFamily": "latin",
          "languages": [],
          "textSample": "Modern interface font",
          "description": "Segoe UI is a sans serif OPF font scheme for Latin presentations, using Segoe UI Semibold for headings with Segoe UI for body text."
        }
      },
      "layouts": {
        "list": {
          "name": "List",
          "summary": "Bulleted or numbered points; one long list flows into columns.",
          "tags": [
            "Text"
          ],
          "direction": "column",
          "regions": [
            {
              "name": "title"
            },
            {
              "name": "body",
              "accepts": [
                "list",
                "text",
                "group"
              ],
              "role": "primary",
              "flow": "auto",
              "listColumns": "auto"
            }
          ],
          "description": "Present several related points in a clear sequence. Use bullets for independent points or numbered items for an ordered list.",
          "preview": {
            "vectorSrc": "https://www.pptx.gallery/layout-previews/list.svg"
          }
        }
      }
    }
  }
}

Example: List with Image Bullets

Set design.listBullet to "image" and supply organization.logo.icon to use the same icon beside each list item. This example uses an owned abstract mark; use separate image blocks for individual portraits.

{
  "$schema": "https://openpresentation.org/schema/opf/v1",
  "name": "Our Leadership Team",
  "organization": {
    "id": "example-organization",
    "name": "Example Organization",
    "logo": {
      "icon": {
        "src": "data:image/svg+xml,%3Csvg%20xmlns%3D%22http%3A%2F%2Fwww.w3.org%2F2000%2Fsvg%22%20width%3D%2264%22%20height%3D%2264%22%3E%3Crect%20x%3D%228%22%20y%3D%228%22%20width%3D%2248%22%20height%3D%2248%22%20rx%3D%2212%22%20fill%3D%22%236E4EFF%22%2F%3E%3C%2Fsvg%3E",
        "alt": "Abstract example icon"
      }
    }
  },
  "slides": [
    {
      "layout": "list",
      "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",
        "listBullet": "image"
      }
    }
  ],
  "catalogs": {
    "default": {
      "source": "https://www.pptx.gallery",
      "layouts": {
        "list": {
          "name": "List",
          "summary": "Bulleted or numbered points; one long list flows into columns.",
          "tags": [
            "Text"
          ],
          "direction": "column",
          "regions": [
            {
              "name": "title"
            },
            {
              "name": "body",
              "accepts": [
                "list",
                "text",
                "group"
              ],
              "role": "primary",
              "flow": "auto",
              "listColumns": "auto"
            }
          ],
          "description": "Present several related points in a clear sequence. Use bullets for independent points or numbered items for an ordered list.",
          "preview": {
            "vectorSrc": "https://www.pptx.gallery/layout-previews/list.svg"
          }
        }
      }
    }
  }
}

Vertical vs. Horizontal

• A list keeps its authored item order. The resolved layout and available space determine column flow.
• For an explicit arrangement, use current list columns or group composition; -vertical is not a current layout suffix.

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