Skip to main content
This guide shows you how to create videos with smart layouts that enhance the visual presentation of your content. Smart layouts provide professionally designed templates that combine text, visuals, and animations for engaging video content.
Smart Layout Options

What You’ll Learn

Smart Layouts

Apply professionally designed visual layouts

Layout Selection

Choose layouts by name or ID

Visual Styles

Create consistent, polished video aesthetics

Combined Features

Use layouts with voice-over and other features

Before You Begin

Make sure you have:
  • A Pictory API key
  • Node.js or Python installed on your machine
  • Text content ready for video conversion
  • Understanding of which layout style fits your content

Available Smart Layouts

Pictory provides five distinct smart layout styles, each designed for different content types and visual aesthetics:
Smart layouts automatically handle text positioning, animations, and visual styling. When using smart layouts, the maxSubtitleLines parameter is not available at the scene level as the layout manages text display automatically.

How Smart Layouts Work

When you apply a smart layout to your video:
  1. Layout Selection - You specify the layout by name or ID
  2. Text Processing - Your story content is analyzed and formatted
  3. Visual Styling - Layout-specific styling is applied to text and elements
  4. Animation Application - Pre-designed animations enhance visual appeal
  5. Scene Composition - Text, visuals, and backgrounds are combined
  6. Video Rendering - Final video is assembled with the complete layout design

Complete Example

Understanding the Parameters

Smart Layout Configuration

Valid Smart Layout Names

Smart Layout RestrictionsWhen using smart layouts, the following restrictions apply:
  • maxSubtitleLines cannot be used at the scene level
  • The layout automatically manages text display and positioning
  • Use either smartLayoutName OR smartLayoutId, not both

Layout Selection Methods

Using Layout Name

The simplest way to select a smart layout is by name:

Using Layout ID

For programmatic consistency, you can use the layout ID:
Layout IDs provide stability if layout names change in the future. Use the name for human-readable code and ID for automated systems.

Common Use Cases

Corporate Presentation

Result: Professional, clean video perfect for business presentations.

Marketing Campaign

Result: Dynamic, energetic video for product launches and promotions.

Fashion and Lifestyle

Result: Elegant, sophisticated video for lifestyle and fashion brands.

Travel Content

Result: Immersive, travel-inspired video with testimonial-style presentation.

Educational Content

Result: Structured, informational video perfect for tutorials and courses.

Best Practices

Choose the right layout for your content:
  • Modern Minimalist: Business reports, corporate updates, professional tutorials
  • Kinetic: Product launches, social media ads, energetic promotions
  • Chic: Fashion content, luxury brands, lifestyle videos
  • Wanderlust: Travel vlogs, testimonials, storytelling
  • Bulletin: Educational content, news updates, informational videos
Smart layouts work best when paired with AI voice-over:
  • Voice narration enhances the visual storytelling
  • Text and voice complement each other
  • Creates more engaging, professional content
  • Voice speed should match the layout energy
Select layouts based on viewer expectations:
  • B2B Content: Modern Minimalist, Bulletin
  • Consumer Marketing: Kinetic, Chic
  • Social Media: Kinetic, Wanderlust
  • Educational: Bulletin, Modern Minimalist
  • Brand Storytelling: Wanderlust, Chic

Troubleshooting

Problem: API returns error about invalid layout name.Solution:
  • Check spelling and case sensitivity
  • Use exact names: “modern minimalist”, “kinetic”, “chic”, “wanderlust”, “bulletin”
  • Ensure you are not using both name and ID
  • Remove extra spaces or characters from the name
Problem: API returns error about maxSubtitleLines not being allowed.Solution:
  • Remove maxSubtitleLines from all scene configurations
  • Smart layouts automatically manage text display
  • The layout handles subtitle line formatting
  • Use scene breaks to control text pacing instead
Problem: Video uses a different layout than expected.Solution:
  • Verify the layout name spelling is correct
  • Double-check you are not using both name and ID
  • Ensure the parameter is at the video level, not scene level
  • Review the available layout options in this guide

Next Steps

Enhance your smart layout videos with these features:

AI Voice-Over

Add professional narration to complement layouts

Background Music

Add music to enhance the visual experience

Brand Settings

Apply consistent branding across videos

Logo Integration

Add your logo to branded content

API Reference

For complete technical details, see:

Get Smart Layouts

List all available smart layout templates

Render Storyboard Video

Apply smart layouts to rendered videos

Create Storyboard Preview

Preview videos with smart layouts

Get Storyboard Preview Job

Monitor storyboard creation progress