Layout Reference¶

Complete reference for all available slide layouts in SlideGen. Each layout has specific properties and use cases.

Overview¶

SlideGen supports 10 layout types, each optimized for different content types:

Title - Title slide with subtitle
Section Header - Full-slide section divider
Bullet List - Title with bullet points
Two Column - Side-by-side content
Comparison - Before/after or A/B comparison
Image - Title with image
Chart - Title with data visualization
Table - Title with data table
Quote - Large centered quote
Blank - Empty slide for custom content

Title Layout¶

A title slide with title and optional subtitle. Perfect for opening slides.

slides:
  - layout: title
    title: "Q4 2025 Results"
    subtitle: "Year-End Review and Outlook"

Properties:

Property	Type	Required	Description
`title`	string	Yes	Main title text
`subtitle`	string	No	Subtitle text displayed below title

Example:

- layout: title
  title: "Welcome to SlideGen"
  subtitle: "AI-Powered Presentation Generation"

Section Header Layout¶

A full-slide section divider with centered text. Use to separate major sections.

slides:
  - layout: section_header
    text: "Part 1: Introduction"

Properties:

Property	Type	Required	Description
`text`	string	Yes	Section header text

Example:

- layout: section_header
  text: "Executive Summary"

Bullet List Layout¶

A slide with a title and bullet points. The most common layout type.

slides:
  - layout: bullet_list
    title: "Key Metrics"
    bullets:
      - "Revenue: +15% YoY"
      - "Profit margin: 22%"
      - "Customer growth: +1.2M users"

Properties:

Property	Type	Required	Description
`title`	string	Yes	Slide title
`bullets`	array	Yes	Array of bullet point strings or objects

Simple Bullets:

bullets:
  - "First point"
  - "Second point"
  - "Third point"

Nested Bullets:

bullets:
  - "Main point"
  - text: "Sub-point"
    level: 1
  - "Another main point"
  - text: "Another sub-point"
    level: 1

Best Practices:

Keep bullets concise (5-7 per slide)
Use parallel structure
Limit nesting to 1 level

Two Column Layout¶

Side-by-side content with flexible content types. Great for comparisons or related content.

slides:
  - layout: two_column
    title: "Comparison"
    left:
      type: bullet_list
      bullets:
        - "Left side point 1"
        - "Left side point 2"
    right:
      type: bullet_list
      bullets:
        - "Right side point 1"
        - "Right side point 2"

Properties:

Property	Type	Required	Description
`title`	string	Yes	Slide title
`left`	object	Yes	Left column content (see Column Content)
`right`	object	Yes	Right column content (see Column Content)

Column Content Types:

Each column can be one of:

bullet_list: Array of bullets
text: Plain text paragraph
image: Image with optional caption

Text Column:

left:
  type: text
  text: "This is a paragraph of text that will flow naturally in the left column."

Image Column:

right:
  type: image
  src: "images/dashboard.png"
  caption: "New dashboard design"

Comparison Layout¶

Before/after or option A/B comparison. Similar to two-column but with semantic labels.

slides:
  - layout: comparison
    title: "Before vs After"
    before:
      type: bullet_list
      bullets:
        - "Manual process"
        - "2 hours per day"
    after:
      type: bullet_list
      bullets:
        - "Automated process"
        - "5 minutes per day"

Properties:

Property	Type	Required	Description
`title`	string	Yes	Slide title
`before`	object	Yes	Left side content (column content)
`after`	object	Yes	Right side content (column content)

Use Cases:

Process improvements
Product comparisons
Feature comparisons
Before/after transformations

Image Layout¶

Title with an image. Perfect for screenshots, diagrams, or visual content.

slides:
  - layout: image
    title: "Product Screenshot"
    image:
      src: "images/product.png"
      alt: "Product interface"
      caption: "New dashboard design"

Properties:

Property	Type	Required	Description
`title`	string	Yes	Slide title
`image`	object	Yes	Image object
`image.src`	string	Yes	Path to image file (relative to schema file)
`image.alt`	string	No	Alternative text for accessibility
`image.caption`	string	No	Image caption displayed below image

Supported Formats:

PNG (.png)
JPEG (.jpg, .jpeg)
GIF (.gif)

Image Sizing:

Images are automatically scaled to fit the slide while maintaining aspect ratio.

Chart Layout¶

Title with a data visualization. Supports multiple chart types and data sources.

slides:
  - layout: chart
    title: "Revenue Trend"
    chart:
      type: line
      data:
        labels: ["Q1", "Q2", "Q3", "Q4"]
        values: [100, 120, 140, 160]
      x_axis_label: "Quarter"
      y_axis_label: "Revenue ($M)"

Properties:

Property	Type	Required	Description
`title`	string	Yes	Slide title
`chart`	object	Yes	Chart object
`chart.type`	string	Yes	Chart type: `bar`, `line`, `pie`, `column`
`chart.data`	object	Yes	Chart data (inline or external source)
`chart.title`	string	No	Chart title (overrides slide title)
`chart.x_axis_label`	string	No	X-axis label
`chart.y_axis_label`	string	No	Y-axis label

Chart Types:

bar: Horizontal bar chart
column: Vertical column chart
line: Line chart
pie: Pie chart

Single Series:

chart:
  type: line
  data:
    labels: ["Q1", "Q2", "Q3", "Q4"]
    values: [100, 120, 140, 160]

Multi-Series:

chart:
  type: bar
  data:
    labels: ["Q1", "Q2", "Q3", "Q4"]
    series:
      - name: "Product A"
        values: [100, 120, 140, 160]
      - name: "Product B"
        values: [80, 90, 110, 130]

External Data Source:

See Data Binding for details on using CSV/JSON data sources.

Table Layout¶

Title with a data table. Supports inline data or external CSV sources.

slides:
  - layout: table
    title: "Sales by Region"
    table:
      data:
        - ["Region", "Q1", "Q2", "Q3", "Q4"]
        - ["North", "100", "120", "140", "160"]
        - ["South", "80", "90", "110", "130"]
        - ["East", "90", "100", "120", "140"]
      header_row: true

Properties:

Property	Type	Required	Description
`title`	string	Yes	Slide title
`table`	object	Yes	Table object
`table.data`	array	Yes	Array of rows (each row is array of cells) or external CSV source
`table.header_row`	boolean	No	Whether first row is styled as header (default: true)

Inline Data:

table:
  data:
    - ["Header 1", "Header 2", "Header 3"]
    - ["Row 1 Col 1", "Row 1 Col 2", "Row 1 Col 3"]
    - ["Row 2 Col 1", "Row 2 Col 2", "Row 2 Col 3"]
  header_row: true

External CSV Source:

See Data Binding for details on using CSV data sources.

Quote Layout¶

Large centered quote with optional attribution. Perfect for testimonials or key messages.

slides:
  - layout: quote
    quote:
      text: "The best way to predict the future is to invent it."
      attribution: "Alan Kay"

Properties:

Property	Type	Required	Description
`quote`	object	Yes	Quote object
`quote.text`	string	Yes	Quote text
`quote.attribution`	string	No	Author or source

Example:

- layout: quote
  quote:
    text: "Simplicity is the ultimate sophistication."
    attribution: "Leonardo da Vinci"

Blank Layout¶

Empty slide for custom content. Currently a placeholder for future extensibility.

slides:
  - layout: blank
    text: "Custom content placeholder"

Properties:

Property	Type	Required	Description
`text`	string	No	Placeholder text

Layout Selection Guide¶

Choose Title when: - Creating the opening slide - Need a simple title/subtitle combination

Choose Section Header when: - Separating major sections - Need a full-slide divider

Choose Bullet List when: - Presenting a list of points - Most common content type

Choose Two Column when: - Comparing related content side-by-side - Need flexible column content types

Choose Comparison when: - Showing before/after scenarios - Comparing two options (A/B)

Choose Image when: - Showing screenshots or diagrams - Visual content is primary

Choose Chart when: - Visualizing data trends - Showing quantitative comparisons

Choose Table when: - Presenting structured data - Need precise data display

Choose Quote when: - Highlighting testimonials - Emphasizing key messages

Choose Blank when: - Need custom layout (future use) - Placeholder for manual editing

Next Steps¶

Learn about data binding for charts and tables
Explore theming options
Check out real-world examples