// GLOSSARY · PERSONA FRAMES

Persona Frames

A Kompozy render path that wraps a HeyGen avatar inside a HyperFrames composition template for branded scene shorts.

KompozyTurn one idea into a week of content — across every platform, published for you.
Get Started →

Last verified · 2026-05-29 · by Moe Ameen

What it is

Persona Frames composites a HeyGen avatar as a movable layer inside one of the 8 HyperFrames templates. The result is a branded scene short — the avatar speaks inside your layout, not on HeyGen’s default background. The engine picks a template per render based on persona bindings and the topic-pool angle.

Persona Frames renders via ffmpeg filter graphs (not the Puppeteer screenshot path). It requires a new-schema persona — existing v1 personas do not auto-upgrade.

Frequently asked questions

What are Persona Frames in Kompozy?

Persona Frames is a Kompozy render path that composites a HeyGen avatar as a movable layer inside one of the 8 HyperFrames templates. The result is a branded scene short where the avatar speaks inside your layout rather than on HeyGen's default background.

How does Kompozy choose which template a Persona Frame uses?

The engine picks a template per render based on persona bindings and the topic-pool angle. It selects from the eight HyperFrames templates.

How does Persona Frames render the video?

Persona Frames renders via ffmpeg filter graphs, not the Puppeteer screenshot path. This is what lets it composite a video layer inside the template.

Does every persona support Persona Frames?

No. Persona Frames requires a new-schema persona, and existing v1 personas do not auto-upgrade. Only personas on the new schema can render Persona Frames.

What is the difference between Persona Frames and Persona Shorts?

Persona Frames wraps the HeyGen avatar inside a HyperFrames composition template for a branded scene, while Persona Shorts puts the avatar on HeyGen's default background with auto-captions and no template.

Related terms

  • Persona Shorts — Kompozy’s default avatar-video path: HeyGen avatar plus auto-captions plus optional B-roll, without a HyperFrames template.
  • HyperFrames — Kompozy’s self-hosted HTML→MP4 template renderer that burns in branded captions and overlays pixel-exact to your style.
  • Avatar video — AI-generated talking-head video where a digital avatar speaks a written script using voice cloning or synthetic voice.
Related deep guides

← All terms · Get started →