Skip to main content
This guide shows you how to create videos with custom captions that are separate from your story text. Perfect for creating multilingual content where the visuals are selected based on one language while displaying subtitles in another.

What You’ll Learn

Custom Captions

Add subtitles separate from story text

Multi-Language Support

Display captions in different languages

Dual Text System

Story for visuals, captions for display

Translation Ready

Perfect for international audiences

Before You Begin

Make sure you have:
  • A Pictory API key
  • Node.js or Python installed on your machine
  • Your content text and translated captions prepared
  • Language codes for your target language

How Caption System Works

Pictory’s caption system uses a dual-text approach:
  1. Story Text - The main content used by AI to understand context and select appropriate visuals
  2. Caption Text - The text displayed as subtitles in your final video
  3. Language Code - Specifies the caption language for proper formatting
  4. Automatic Sync - Captions are automatically synchronized with video timing
This separation allows you to create videos in one language (for visual selection) while displaying subtitles in another language, making your content accessible to global audiences.

Complete Example

Caption Configuration Parameters

Scene Configuration

Important Limitation: When using custom captions, both createSceneOnNewLine and createSceneOnEndOfSentence must be set to false. This means you need to manually create multiple scenes if you want scene breaks with captions.

Supported Caption Languages

Story vs Caption: Understanding the Difference

Story text is the content the AI uses to:
  • Understand the context and meaning of your video
  • Select appropriate stock visuals and images
  • Determine the overall theme and mood
  • Generate relevant background content
Use story text in the language that best describes your visual needs, even if your audience speaks a different language.
Caption text is what your viewers will see:
  • Displayed as subtitles throughout the video
  • Can be a translation of the story text
  • Can be simplified or adapted for your audience
  • Should match your target audience’s language
Use caption text in the language your viewers will understand.
Scenario: Creating a video for Spanish-speaking students about AI in education.
The AI understands the English concept to select educational visuals, but Spanish subtitles appear for your audience.

Common Use Cases

Creating Multilingual Marketing Videos

Result: Professional marketing video with French subtitles, using English-sourced visuals.

Educational Content for International Students

Result: Programming tutorial with Japanese subtitles, maintaining clear technical visuals.

Accessibility and Localization

Result: Corporate presentation accessible to German-speaking audiences.

Working with Multiple Scenes

Since automatic scene breaks are disabled when using captions, you need to manually create scenes:

Best Practices

Ensure your caption text accurately reflects the story text:
  • Use professional translation services when possible
  • Keep the meaning and tone consistent
  • Avoid direct word-for-word translations that may sound unnatural
  • Test with native speakers before production
Always use the correct ISO 639-1 language code:
  • Double-check the code matches your caption language
  • Use region-specific codes when necessary (e.g., zh-CN vs zh-TW)
  • Verify the language is supported (see table above)
Keep captions readable within the scene duration:
  • Shorter captions are easier to read
  • Break long sentences into multiple scenes
  • Aim for 1-2 lines of text per scene
  • Test video playback to ensure captions are comfortable to read
Since automatic scene breaks do not work with captions:
  • Plan scene breaks manually before creating the video
  • Group related content into logical scenes
  • Create separate scene objects for each caption segment
  • Consider the visual flow between scenes

Troubleshooting

Problem: You set createSceneOnNewLine or createSceneOnEndOfSentence to true with captions.Solution: Set both parameters to false:
Problem: The caption text displays but formatting is incorrect.Solution:
  • Verify you are using the correct language code (e.g., “es” not “spanish”)
  • Check the supported languages table above
  • Ensure the caption text is properly encoded (UTF-8)
Problem: The selected visuals do not seem relevant to your captions.Solution: Remember that visuals are selected based on story text, not caption text:
  • Make sure your story text clearly describes the visuals you want
  • Keep story text in a language the AI handles well (English recommended)
  • The caption is only for subtitle display, not visual selection
Problem: Captions are cut off or hard to read.Solution:
  • Break long text into multiple scenes
  • Keep each caption to 1-2 lines (approximately 60-100 characters)
  • Create separate scene objects for longer content:

Next Steps

Enhance your captioned videos with these features:

AI Voice-Over

Add narration in the caption language

Custom Subtitle Styles

Customize caption appearance and formatting

Multi-Level Voice-Over

Use different voices for different scenes

Brand Settings

Apply consistent branding across videos

API Reference

For complete technical details, see:

Render Storyboard Video

Direct video rendering with captions

Get Text Styles

Customize subtitle appearance

Create Storyboard Preview

Create preview before rendering

Get Storyboard Preview Job

Monitor storyboard creation progress