> ## Documentation Index
> Fetch the complete documentation index at: https://docs.superscale.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Video context

> Prepare scripts, footage, product references, voice, captions, and guardrails before spending video credits.

Video has more moving parts than a static ad: concept, script, scene plan, product visuals, creator style, voice, captions, overlays, pacing, and export format. Video context is the material Superscale uses to decide which parts it should generate and which parts it should preserve exactly.

The practical default is **hybrid**: use AI for hooks, creators, storyboards, scenes, and variations; use real footage, screen recordings, product clips, screenshots, and approved references whenever the detail must be true.

<Note>
  Do not treat video context as "more prompt." Treat it as pre-production. The more you decide before rendering, the fewer credits you spend fixing avoidable script, voice, product, or pacing issues.
</Note>

## Start with the workflow

Pick the workflow before you attach files. Different video types need different context.

| Workflow                         | Best for                                                                                           | Context that matters most                                                                                     |
| -------------------------------- | -------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------- |
| **Full AI video**                | Fast exploration, broad hooks, concept testing, visual ideas.                                      | Audience, angle, product facts, visual style, claims, target language, and examples of what good looks like.  |
| **UGC speaking / talking-head**  | Direct-response hooks, founder-style messages, testimonials, longer spoken explanations.           | Script, creator description, delivery style, language fit, claims, pronunciation, and testimonial boundaries. |
| **UGC lifestyle**                | Product/app story with a person on screen but less dependence on exact lip-sync.                   | Scene plan, product shots, market setting, voiceover, B-roll, and target-language context.                    |
| **B-roll voiceover**             | Apps, SaaS, websites, high-trust products, product demos, exact UI, and non-English/localized ads. | Screen recordings, product clips, storyboard, voiceover, captions, overlays, and what each clip proves.       |
| **Animated brand/product video** | Stylized product motion, brand characters, simple explainers, or abstract offers.                  | Brand style, product shape, colors, logo treatment, motion references, and end-card rules.                    |

<Tip>
  If the product, app UI, packaging, legal proof, testimonial, or market detail must be exact, start from real material and let Superscale generate around it.
</Tip>

## What to provide

<CardGroup cols={2}>
  <Card title="Script and storyboard">
    Hook, angle, scene order, voiceover, CTA, target length, and which moments must be shown rather than invented.
  </Card>

  <Card title="Product and UI references">
    Product shots, packaging, labels, app screenshots, website captures, screen recordings, demos, and any exact visual assets.
  </Card>

  <Card title="B-roll and source footage">
    Existing clips, customer footage, founder footage, testimonials, app walkthroughs, product handling, lifestyle clips, and old ads to reuse.
  </Card>

  <Card title="Reference videos">
    Examples of pacing, framing, creator delivery, edit density, caption style, hook structure, or visual mood.
  </Card>

  <Card title="Voice and pronunciation">
    Language, market, accent, age, gender, pace, tone, custom pronunciation, brand-name spelling, acronyms, and words that are often misread.
  </Card>

  <Card title="Claims and guardrails">
    Approved claims, forbidden claims, required disclaimers, testimonial rules, legal restrictions, and anything the ad must not imply.
  </Card>

  <Card title="Caption and overlay rules">
    Caption style, position, emphasis, on-screen text, subtitles, end card, offer text, CTA, and what should be edited after render.
  </Card>

  <Card title="Export requirements">
    Target platforms, aspect ratios, safe zones, duration, file handoff needs, and whether the output is for testing or final launch.
  </Card>
</CardGroup>

## What belongs where

Some video information is durable. Some only belongs to one video.

| Context                | Put it here                         | Example                                                                                                                   |
| ---------------------- | ----------------------------------- | ------------------------------------------------------------------------------------------------------------------------- |
| Brand-wide video style | Brand context                       | Caption style, tone, logo placement, visual polish level, "do not use fake testimonials."                                 |
| Saved video defaults   | Video Context tab                   | Captions on/off/auto, caption preset, caption position, shadow, font, colors, end-card behavior, and pronunciation audio. |
| Product-specific truth | Product context                     | Exact packaging, app screens, claims, pricing, feature names, demos, and offer restrictions.                              |
| One video brief        | Current task/chat                   | "Make a 20-second Father's Day variant with a calm founder-style voice."                                                  |
| Exact source footage   | Asset Drive or attached to the task | Screen recording, product clip, founder video, customer testimonial, or B-roll scene.                                     |
| One-off inspiration    | Attached reference                  | "Use this competitor ad's pacing, but not their brand, claims, or visuals."                                               |
| Reusable learning      | Saved context                       | "For this market, B-roll voiceover beats synthetic talking-head testimonials."                                            |

<Card title="How context is used" horizontal href="/context/how-context-is-used">
  Understand what stays in the current chat and what becomes durable context.
</Card>

## Saved video defaults

Use **Context & Skills → Video Context** for video defaults that should apply across future generations for the brand. These settings are saved at brand level and are passed to the video agent before it generates.

| Setting                 | What it controls                                                                    | How to use it                                                                                                                                                           |
| ----------------------- | ----------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Captions**            | Whether generated videos should receive post-processing captions.                   | Use **On** when captions should be a fixed brand default, **Off** when videos should stay clean unless requested, and **Auto** when Superscale should decide per video. |
| **End Card**            | Whether videos should receive a final brand/product card after the generated video. | Use **On** for a fixed closing-card default, **Off** to avoid automatic end cards, and **Auto** when an end card should be used only when it improves the ad.           |
| **Caption position**    | Where captions appear in the frame.                                                 | Choose top, center, or bottom based on the footage and platform safe zones.                                                                                             |
| **Caption shadow**      | Caption separation from busy footage.                                               | Increase the shadow for noisy or high-motion backgrounds; reduce it for clean, premium, or editorial videos.                                                            |
| **Baseline text**       | The default caption text style.                                                     | Set font, weight, and color for ordinary caption words.                                                                                                                 |
| **Highlighted text**    | The style for emphasized caption words.                                             | Use a brand color or heavier weight when specific words should pop.                                                                                                     |
| **Caption preset**      | The overall caption look.                                                           | Pick the preset that matches the brand: plain/corporate for clean demos, bold creator presets for direct-response UGC, or softer presets for lifestyle.                 |
| **Brand pronunciation** | How the brand name should be said in generated videos.                              | Upload a short `.mp3`, `.wav`, or `.m4a` clip when the brand name, acronym, or product name is easy to mispronounce.                                                    |

<Note>
  **Auto** does not mean "ignore this setting." It means Superscale makes the choice for the current video, and if it uses captions or an end card, it should use the saved brand style.
</Note>

## Use real footage when exactness matters

AI can generate useful motion and scenes, but it should not be asked to invent details that have to be commercially exact.

Use real footage, screenshots, or product references for:

* App UI, website flows, dashboards, checkout pages, and onboarding steps.
* Product packaging, labels, bottles, supplements, books, devices, and physical product shape.
* Founder, customer, testimonial, clinical, financial, legal, or regulated proof.
* Precise text, pricing, small UI labels, logos, disclaimers, and compliance language.
* Game footage, software walkthroughs, before/after proof, or any result that must be literal.

Use AI-generated scenes for:

* Hook scenes, transitions, explainers, creator intros, visual metaphors, background lifestyle shots, and fast concept variations.
* Shots where mood and message matter more than exact product fidelity.
* Early exploration before you commit to a higher-control hybrid edit.

<Note>
  If a logo, product, UI, or text must not change, attach the exact source asset and say what must stay fixed. Do not rely on the video model to redraw exact commercial assets from memory.
</Note>

## Script and scene plan

Video context should tell Superscale what each scene is supposed to do. A good scene plan is short but explicit.

| Scene field        | What to define                                                                                             |
| ------------------ | ---------------------------------------------------------------------------------------------------------- |
| **Job**            | Hook, problem, proof, demo, objection, comparison, social proof, or closing beat.                          |
| **Visual source**  | AI-generated scene, product clip, screen recording, uploaded B-roll, static image, or previous generation. |
| **Spoken line**    | What the creator or voiceover says in that scene.                                                          |
| **On-screen text** | Headline, callout, price, offer, disclaimer, or CTA that should be added as an overlay or edit layer.      |
| **Must preserve**  | Product, logo, UI, face, voice, text, claim, timing, or exact clip.                                        |
| **Can vary**       | Hook, setting, creator, pacing, B-roll, CTA, music, overlay, or caption style.                             |

<Note>
  Do not ask the video model to draw captions, subtitles, logo holds, or end-card frames inside the generated scene. In Superscale's current video flow, captions and end cards are post-processing layers. Keep the generated video focused on the scene, then apply captions and the end card through the video settings or the final edit.
</Note>

## Voice and localization

Voice context is about market fit, not just language.

Before rendering, specify:

* Target market and language variant, not just the language.
* Accent and delivery: energetic, calm, founder-like, creator-style, premium, playful, technical, native, or studio.
* Pronunciation hints for brand names, product names, acronyms, payment terms, and unusual words.
* Whether the voice is native audio, voiceover, or a silent/ambient scene with captions.
* Whether visuals need localization too: currency, screenshots, people, examples, slang, competitors, and claims.

<Tip>
  For pronunciation, write it plainly: "Amaze, rhymes with days", "HVAC, say each letter", or "Mexican Spanish, not generic Spanish."
</Tip>

## Captions, overlays, and end cards

Captions are part of the creative, not a finishing detail. Decide them before rendering when they affect pacing or safe zones.

Use context to define:

* Caption preset or style: subtle, bold creator captions, high-contrast, editorial, playful, or plain.
* Position: bottom, top, center, or safe-zone-specific.
* Shadow strength: none, light, medium, or heavy depending on how busy the footage is.
* Baseline and highlighted text: font, weight, color, and which words or phrases need emphasis.
* Overlay copy: headline, proof point, CTA, offer, discount, disclaimer, or app/store badge.
* End card: final screen, logo, product, URL, CTA, promo code, or app-store prompt.

If exact text must be perfect, keep it simple or plan to edit the text layer after generation. Dense text is one of the easiest places for video output to drift.

Generated end cards need exact visual references, not only a text prompt. Make sure the brand logo, app icon, product image, packaging, or app screenshot exists in context. If you already have a finished end-card image, attach that exact file and ask Superscale to use it as-is instead of generating a new one.

## Before spending video credits

Run this check before the first render.

<Steps>
  <Step title="Lock the goal" icon="target">
    Decide whether the video is a hook test, product demo, testimonial-style ad, localization, retargeting creative, or winner iteration.
  </Step>

  <Step title="Choose the workflow" icon="layout-template">
    Pick full AI, UGC speaking, UGC lifestyle, B-roll voiceover, animated, or Studio/hybrid before choosing assets.
  </Step>

  <Step title="Approve the script" icon="file-text">
    Review hook, claims, spoken line, CTA, and target length before rendering. Fix script problems in chat, not after video generation.
  </Step>

  <Step title="Attach exact inputs" icon="paperclip">
    Add the product shot, UI screenshot, screen recording, B-roll, voice notes, reference ad, or testimonial that should guide the output.
  </Step>

  <Step title="Mark what cannot change" icon="lock">
    Say what must stay exact: product, label, logo, UI, price, claim, disclaimer, voice, caption, or source clip.
  </Step>

  <Step title="Check voice and market" icon="mic">
    Add language, accent, pronunciation, delivery style, and localization notes before a full batch.
  </Step>

  <Step title="Plan captions and end card" icon="captions">
    Decide caption style, overlay text, CTA, and final frame before export.
  </Step>
</Steps>

## Common video context mistakes

<AccordionGroup>
  <Accordion title="Asking the model to invent exact product footage" icon="package">
    If the product, UI, packaging, or claim must be accurate, attach the real asset. Use AI to create around the asset, not to guess it.
  </Accordion>

  <Accordion title="Treating B-roll as decoration" icon="clapperboard">
    B-roll should prove something: show the app flow, product texture, use case, result, objection, or moment the voiceover is talking about.
  </Accordion>

  <Accordion title="Approving the video before approving the script" icon="file-text">
    Script, claims, and pronunciation are cheaper to fix before render. If the message is wrong, do not spend credits to discover that in motion.
  </Accordion>

  <Accordion title="Forgetting the target market" icon="languages">
    "Spanish" is not the same as "Mexican Spanish." Localization includes examples, screenshots, people, currency, and cultural context.
  </Accordion>

  <Accordion title="Using synthetic testimonials where trust is fragile" icon="shield-alert">
    For regulated, premium, legal, health, finance, or high-trust offers, avoid fake first-person proof. Use approved claims, real proof, founder-style explainers, or B-roll voiceover instead.
  </Accordion>

  <Accordion title="Retrying the same broken generation" icon="life-buoy">
    If a video gets stuck, renders unusably, or keeps drifting, stop and diagnose the cause. Tighten context, switch workflow, or report the generation instead of burning credits.
  </Accordion>
</AccordionGroup>

## Format shortcuts

| If you are making             | Start with                                                                                                                                  |
| ----------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------- |
| Mobile app video              | App screen recording, app-store screenshots, top review language, target user, and a B-roll voiceover or talking-head-over-screen workflow. |
| SaaS or website video         | Screen recording, website screenshots, feature proof, customer problem, voiceover, and overlays that explain the UI.                        |
| Physical product video        | Product shots from multiple angles, packaging rules, claims, lifestyle use cases, and B-roll showing the real product.                      |
| Localized video               | Target market, language variant, voice/accent, localized screenshots, local offer, and pronunciation hints.                                 |
| Regulated or high-trust video | Approved claims, disclaimers, real proof, compliance no-gos, and a hybrid workflow that avoids fake testimonial claims.                     |
| Winner iteration              | The winning ad, what made it work, what variable to change, and what must stay fixed.                                                       |

<CardGroup cols={2}>
  <Card title="Creating videos" href="/features/video-ads">
    Choose the right video workflow and understand how video generation comes together.
  </Card>

  <Card title="Scripts" href="/features/scripts">
    Steer the hook, storyboard, spoken line, and scene structure before rendering.
  </Card>

  <Card title="Voiceover & lip-sync" href="/features/voiceover-lipsync">
    Control voice, localization, accents, and pronunciation.
  </Card>

  <Card title="Getting video right in fewer tries" href="/resources/troubleshooting/video-in-fewer-tries">
    Avoid wasting credits on avoidable retries.
  </Card>
</CardGroup>
