Scripts are the foundation of every video you create in HeyGen. They tell your avatar what to say and shape the narrative across your scenes. Whether you're building a product demo, onboarding guide, or social content, your script is where it all begins.
Each scene in your video can have its own script, making it easy to structure multi-part messages and guide your viewer through a clear story. Let's dive in.
How to Add a New Script
To create a new section of your video with its own script:
Click Add Scene
Choose either Blank or From Template
Type your script directly into the script editor
That’s it! Once your script is in place, you can assign an avatar, voice, and background to match your message.
💡 Pro Tip: To get the best results, click the play button next to your script to preview how it sounds before submitting your video. This lets you catch any awkward phrasing or pacing issues early.
How to Add a Pause in Scripts
To make your script sound more natural, you can add pauses between sentences. Simply place your cursor where you’d like the pause, then click the Pause button. Use the + or – icons to adjust the pause length in 0.5-second intervals.
How to Upload and Download Scripts in full
You can now download and upload your projects' scripts in full! simply click on the top-left menu option and choose Download or Upload for your script! This should include the pauses locations as well!
Supported file types
File type | Supported extensions | How it works |
Plain text |
| Each line is imported as a separate script segment. Blank lines are ignored. |
Microsoft Word |
| Each paragraph is imported as a separate script segment. |
Excel spreadsheet |
| Each cell is imported as a separate script segment. |
CSV |
| Each cell is imported as a separate script segment. |
Important notes
Maximum 1,000 characters per segment: If a line, paragraph, or cell is longer than 1,000 characters, it will automatically be split into multiple segments.
One segment = one scene: Imported segments are mapped to scenes in order. If your file contains more segments than your current video, new scenes will be created automatically.
Empty content is skipped: Blank lines, empty paragraphs, and empty cells will not be imported.
Processed locally in your browser: The file is read directly in your browser and is not uploaded to a server.
Only the first file is used: If multiple files are selected, only the first file will be processed.
.docfiles are not supported: If you are using Microsoft Word, make sure to save your file as.docx.
Tips
For
.txtfiles, place each scene’s script on a new line.For Excel or CSV files, place each scene’s script in its own cell.
If your video already contains text, the uploaded script will be added as new scenes instead of replacing existing content.
That’s all there is to it! We hope these tools make it easier for you to bring your words to life in AI Studio. For specific questions or troubleshooting tips, reach out to [email protected].