PPTX.gallery
sectionsstructureapi

Overview

Long presentations need structure. Sections break your deck into logical groups — each with its own title slide and focused content. The pptx.dev API makes it easy to build multi-section presentations with clear visual hierarchy.

Creating Sections with Title Slides

Use title slide layouts as section dividers. Place a title slide before each group of content slides:

{
  "$schema": "https://openpresentation.org/schema/opf/v1",
  "name": "Annual Strategy Review",
  "slides": [
    {
      "layout": "cover",
      "title": "Annual Strategy Review",
      "subtitle": "March 2026",
      "design": {
        "titleAlignment": "center"
      }
    },
    {
      "layout": "cover",
      "title": "Section 1: Financial Performance",
      "design": {
        "contentBox": true
      }
    },
    {
      "layout": "metrics",
      "title": "Key Financials",
      "blocks": [
        {
          "metric": {
            "value": "$12M",
            "label": "Revenue"
          }
        },
        {
          "metric": {
            "value": "88%",
            "label": "Gross Margin"
          }
        },
        {
          "metric": {
            "value": "$2.1M",
            "label": "EBITDA"
          }
        },
        {
          "metric": {
            "value": "18mo",
            "label": "Runway"
          }
        }
      ],
      "design": {
        "titleAlignment": "center",
        "contentAlignment": "center"
      }
    },
    {
      "layout": "chart",
      "title": "Revenue Trend",
      "chart": {
        "type": "line-with-markers",
        "data": {
          "columns": [
            "Series",
            "Q1",
            "Q2",
            "Q3",
            "Q4"
          ],
          "rows": [
            [
              "Revenue ($M)",
              2.4,
              2.8,
              3.2,
              3.6
            ]
          ]
        }
      },
      "design": {
        "titleAlignment": "center",
        "contentAlignment": "center"
      }
    },
    {
      "layout": "cover",
      "title": "Section 2: Product Roadmap",
      "design": {
        "contentBox": true
      }
    },
    {
      "layout": "list",
      "title": "Q2 Priorities",
      "blocks": [
        {
          "items": [
            {
              "text": "Enterprise SSO",
              "description": "SAML + OIDC support"
            }
          ]
        },
        {
          "items": [
            {
              "text": "API v2",
              "description": "Batch generation, webhooks"
            }
          ]
        },
        {
          "items": [
            {
              "text": "Analytics Dashboard",
              "description": "Usage tracking and insights"
            }
          ]
        }
      ],
      "design": {
        "titleAlignment": "center",
        "contentAlignment": "center"
      }
    },
    {
      "layout": "cover",
      "title": "Section 3: Next Steps",
      "design": {
        "contentBox": true
      }
    },
    {
      "layout": "text",
      "title": "Key Decision",
      "text": "Approve Q2 budget allocation and headcount plan.",
      "design": {
        "contentAlignment": "center"
      }
    }
  ],
  "design": {
    "colorScheme": "slate-gray",
    "fontScheme": "calibri"
  },
  "catalogs": {
    "default": {
      "source": "https://www.pptx.gallery",
      "colorSchemes": {
        "slate-gray": {
          "name": "Slate Gray",
          "summary": "Neutral gray palette for understated executive communication.",
          "description": "A disciplined gray scale with strong neutral contrast. Use it when the content should feel calm, mature, and analytical.",
          "accent1": "#9E9E9E",
          "accent2": "#424242",
          "accent3": "#616161",
          "accent4": "#757575",
          "accent5": "#9E9E9E",
          "accent6": "#212121",
          "dark1": "#000000",
          "dark2": "#1B1B1B",
          "light1": "#FFFFFF",
          "light2": "#F8F8F8",
          "hyperlink": "#212121",
          "followedHyperlink": "#424242",
          "tags": [
            "neutral",
            "minimal",
            "mature",
            "analytical",
            "restrained"
          ]
        }
      },
      "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": {
        "cover": {
          "name": "Cover",
          "summary": "The opening slide: title, subtitle and an optional picture.",
          "tags": [
            "Openers and closers"
          ],
          "design": {
            "titleAlignment": "center",
            "contentAlignment": "center"
          },
          "direction": "row",
          "regions": [
            {
              "name": "title"
            },
            {
              "name": "media",
              "accepts": [
                "image",
                "video"
              ],
              "role": "media",
              "flow": "none",
              "bleed": true
            }
          ],
          "description": "Open a presentation with its subject and a short introduction. Add a picture when it helps establish the context.",
          "preview": {
            "vectorSrc": "https://www.pptx.gallery/layout-previews/cover.svg"
          }
        },
        "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"
          }
        },
        "chart": {
          "name": "Chart",
          "summary": "One to six charts, with an optional note.",
          "tags": [
            "Visuals"
          ],
          "direction": "column",
          "regions": [
            {
              "name": "title"
            },
            {
              "name": "charts",
              "accepts": [
                "chart",
                "group"
              ],
              "role": "primary",
              "flow": "grid"
            },
            {
              "name": "note",
              "size": "auto",
              "accepts": [
                "text"
              ],
              "role": "supporting",
              "flow": "none"
            }
          ],
          "description": "Give a chart enough space to show its evidence. Use the title to state the conclusion and labels to explain the measures.",
          "preview": {
            "vectorSrc": "https://www.pptx.gallery/layout-previews/chart.svg"
          }
        },
        "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"
          }
        },
        "text": {
          "name": "Text",
          "summary": "Prose. Several blocks sit side by side when short and stack when long.",
          "tags": [
            "Text"
          ],
          "direction": "column",
          "regions": [
            {
              "name": "title"
            },
            {
              "name": "body",
              "accepts": [
                "text",
                "list",
                "quote",
                "code",
                "group"
              ],
              "role": "primary",
              "flow": "auto"
            }
          ],
          "description": "Explain one idea in continuous prose. Use paragraphs or flowing blocks for detail that needs to be read in sequence.",
          "preview": {
            "vectorSrc": "https://www.pptx.gallery/layout-previews/text.svg"
          }
        }
      }
    }
  }
}

Section Divider Patterns

Pattern Layout Effect
Section divider section Section heading with an optional subtitle
Clean divider section with design.titleAlignment: "center" Centered heading on a blank slide
Image divider section with an image design.background Section heading over a background image
Minimal divider text Short section intro as body text

Using Narratives for Structure

Narratives guide the sections you author. For example, plan a quarterly-review deck around:

  1. KPIs section (chart slides)
  2. Risks section (list slides)

Use a narrative to plan your section order, then author the complete slides array in that order.

Structuring Tips

  1. One idea per section. Each section should have a clear theme.
  2. Use consistent divider layouts. Pick one divider style and use it throughout.
  3. Limit sections to 3-5. More than that and the audience loses the thread.
  4. Include a section summary. End each section with a text slide that recaps the key takeaway.

Next Steps