
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 (get one here)
- 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:| Layout Name | Style | Best Used For |
|---|---|---|
| Modern minimalist | Clean, professional design with subtle animations | Business presentations, corporate content, professional tutorials |
| Kinetic | Dynamic, energetic layout with bold typography | Marketing videos, product launches, social media ads |
| Chic | Elegant, sophisticated design with stylish elements | Fashion, lifestyle content, premium brand videos |
| Wanderlust | Travel-inspired layout with split-screen visuals | Travel content, testimonials, storytelling videos |
| Bulletin | News-style layout with structured information display | Educational content, news updates, informational videos |
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:- Layout Selection - You specify the layout by name or ID
- Text Processing - Your story content is analyzed and formatted
- Visual Styling - Layout-specific styling is applied to text and elements
- Animation Application - Pre-designed animations enhance visual appeal
- Scene Composition - Text, visuals, and backgrounds are combined
- Video Rendering - Final video is assembled with the complete layout design
Complete Example
Understanding the Parameters
Smart Layout Configuration
| Parameter | Type | Required | Description |
|---|---|---|---|
smartLayoutName | string | No | Name of the smart layout (use this OR smartLayoutId, not both) |
smartLayoutId | string | No | ID of the smart layout (use this OR smartLayoutName, not both) |
Valid Smart Layout Names
| Value | Description |
|---|---|
modern minimalist | Clean, professional design with subtle animations |
kinetic | Dynamic, energetic layout with bold typography |
chic | Elegant, sophisticated design with stylish elements |
wanderlust | Travel-inspired layout with split-screen visuals |
bulletin | News-style layout with structured information display |
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
Marketing Campaign
Fashion and Lifestyle
Travel Content
Educational Content
Best Practices
Match Layout to Content Type
Match Layout to Content Type
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
Combine with Voice-Over
Combine with Voice-Over
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
Consider Your Audience
Consider Your Audience
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
Error: Invalid smart layout name
Error: Invalid smart layout name
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’re not using both name and ID
- Remove extra spaces or characters from the name
maxSubtitleLines error with smart layout
maxSubtitleLines error with smart layout
Problem: API returns error about maxSubtitleLines not being allowed.Solution:
- Remove
maxSubtitleLinesfrom all scene configurations - Smart layouts automatically manage text display
- The layout handles subtitle line formatting
- Use scene breaks to control text pacing instead
Layout doesn't match expected style
Layout doesn't match expected style
Problem: Video uses a different layout than expected.Solution:
- Verify the layout name spelling is correct
- Double-check you’re 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
