What's a reference

References are the reusable pieces you bring into a video — characters, objects/products, logos, styles, and voices — managed in your project's reference library and referenced in prompts with @name.

Swap a reference in one shot

Use chat for a one-off change to a single shot:

• "Swap @Erica for @Rebecca in shot 3"

• "Add @GlowSerum to shot 2"

• "Feature @Rebecca instead"

This works for adding, removing, or swapping a prop, product, logo, or character in that specific shot only.

Swap a reference throughout your video

To replace a reference consistently everywhere it appears, you have two options:

Via chat

Describe the change without limiting it to a shot:

• "Replace @Erica with @Rebecca everywhere"

• "Swap @GlowSerum for @HydraGlow across the whole video"

Via the Refs tab

1. Open the Refs tab to see every character, object, and voice used in the composition.

2. Pick a replacement from the dropdown next to the one you want to change.

3. Confirm.

Either way, every shot or track where that reference appears gets regenerated, for a shown credit cost. Chat is faster if you already know exactly what to swap — Refs gives you a visual list of everything currently in your video.