Overview

A narrative defines the story arc of your presentation — the sequence of slide types that guide your audience from opening hook to closing action. The pptx.dev API provides 10 built-in narrative structures, each optimized for a different presentation purpose.

How Narratives Work

When you set a narrative in your API request, the API generates a structured sequence of slides that follow the story arc. Each narrative defines:

• Slide types — title, text, list, chart, or number slides
• Slide order — the logical flow from setup to conclusion
• Content prompts — what each slide should communicate

{
  "narrative": "venture-pitch",
  "title": "Series A Pitch Deck",
  "colorScheme": "bold-red",
  "fontScheme": "segoe-ui"
}

Available Narratives

Classic Story

Slug: classic-story Best for: All-hands meetings, keynotes, any topic that benefits from storytelling

Follows a movie-style narrative: cinematic hook → setup (protagonist, context, stakes) → resolution. Makes any topic engaging through story structure.

Challenge-Resolution

Slug: challenge-resolution Best for: Problem-solving presentations, strategy reviews, operational meetings

Opens with the business challenge and evidence, then presents recommended actions with expected outcomes. Structured for decision-makers who need diagnosis and solution.

Persuasive Sales

Slug: persuasive-sales Best for: Sales pitches, prospect meetings, customer presentations

Describes the customer's problem in their language, then explains how your offering uniquely solves it. Built around empathy and alignment.

Venture Pitch

Slug: venture-pitch Best for: Fundraising decks, investor meetings, Series A/B pitches

Shows traction metrics and growth curves, then highlights the founding team. Optimized for what investors want to see.

Company Intro

Slug: company-intro Best for: First meetings, partnership discussions, onboarding decks

States the company mission, then lists key value propositions. Clean, concise, and designed to make a strong first impression.

Rags to Riches

Slug: rags-to-riches Best for: Inspirational talks, brand origin stories, leadership presentations

Describes the low point and obstacles, then celebrates the eventual success with proof. Powerful for building emotional connection.

Strategic Advisory

Slug: strategic-advisory Best for: Consulting engagements, management presentations, board advisory

Summarizes diagnostic findings, then presents prioritized recommendations. Structured like a management consulting deliverable.

Failure Analysis

Slug: failure-analysis Best for: Post-mortems, incident reviews, lessons-learned presentations

Outlines the failure timeline and impact, then identifies root causes with evidence. Turns setbacks into learning opportunities.

Marketing Strategy

Slug: marketing-strategy Best for: Marketing plans, go-to-market presentations, campaign briefs

Defines target segments and ICP, then lists acquisition channels with KPIs. A structured framework for marketing teams.

Quarterly Review

Slug: quarterly-review Best for: QBRs, executive updates, operational reviews

Shows quarterly KPIs vs. plan, then summarizes risks and mitigations. The standard format for recurring business reviews.

Choosing the Right Narrative

Combining Narratives with Layouts

Narratives define the slide sequence, but you can customize each slide's layout. For example, in a venture-pitch narrative, you might override the traction slide to use a specific chart layout:

{
  "narrative": "venture-pitch",
  "slides": [
    {
      "layout": "chart-1x-title-center",
      "content": {
        "heading": "Revenue Growth",
        "chart": {
          "type": "LINE_WITH_MARKERS",
          "categories": ["Q1", "Q2", "Q3", "Q4"],
          "series": [{ "name": "ARR ($K)", "values": [120, 340, 780, 1200] }]
        }
      }
    }
  ]
}

Next Steps

• Deep dive into building a venture pitch deck
• Learn about quarterly review presentations
• Browse all narratives in the gallery