> ## 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.

# Common questions

> Short answers to the questions that come up most often when setting up Superscale.

These are the questions users ask most when they start using Superscale. For deeper explanations, follow the linked pages.

## Context and setup

<AccordionGroup>
  <Accordion title="Where should I put brand, product, and workspace context?" icon="folder-tree">
    Put each piece of context at the lowest level where it is always true. Workspace is for rules shared by every brand. Brand is for identity, voice, guidelines, audiences, competitors, and ad accounts. Product is for one offer, SKU, app, category, or landing page. See [Levels & sources](/context/levels-and-sources).
  </Accordion>

  <Accordion title="What should I upload before generating?" icon="upload">
    Start with brand guidelines, product facts, customer language, approved ads, product shots, logos, and any claims or restrictions. If the output has to look a certain way, include visual references. See [Reference images & winning ads](/context/reference-images).
  </Accordion>

  <Accordion title="Do I need perfect prompts?" icon="message-square">
    No. Superscale is context-first, so durable facts should live in context. The prompt should say what you want now: audience, angle, format, references, and what variable to test.
  </Accordion>

  <Accordion title="What is the difference between context files and skills?" icon="brain-circuit">
    Context files teach the agent what is true. Skills teach it how to run a repeatable workflow. Use context for brand facts, customer language, claims, and product info. Use skills for recurring reports, QA checks, research methods, or creative formulas.
  </Accordion>

  <Accordion title="Why are my outputs generic or off-brand?" icon="palette">
    Usually the agent lacks specific references or durable rules. Add approved winners, product shots, logo rules, customer language, and examples of what not to do. Then ask for one controlled generation.
  </Accordion>
</AccordionGroup>

## Credits and troubleshooting

<AccordionGroup>
  <Accordion title="What costs credits?" icon="coins">
    Generating assets costs credits. Chatting, planning, organizing context, and preparing the brief are where you should refine before spending. See [How credits work](/billing/how-credits-work).
  </Accordion>

  <Accordion title="Do iterations cost credits?" icon="refresh-cw">
    If an iteration creates a new asset, expect it to use credits. Ask for surgical edits and lock what should stay fixed.
  </Accordion>

  <Accordion title="Does downloading cost credits?" icon="download">
    Downloading an existing output does not create a new asset. Generation is the credit event.
  </Accordion>

  <Accordion title="What if a generation fails or gets stuck?" icon="life-buoy">
    Report the failed generation or contact support. Superscale can inspect, retry, or refund credits when the failure is real. Do not keep regenerating the same broken prompt blindly.
  </Accordion>

  <Accordion title="How do I avoid wasting video credits?" icon="video">
    Plan the script first, attach exact references, preview voice/pronunciation where possible, and start with a smaller test before rendering a full video batch.
  </Accordion>
</AccordionGroup>

## Integrations and publishing

<AccordionGroup>
  <Accordion title="Does connecting Meta, TikTok, or Google mean Superscale can publish?" icon="plug">
    Not automatically. An integration can read data, import creative history, publish assets, or manage campaigns depending on permissions and platform support. See [Integrations overview](/integrations/introduction).
  </Accordion>

  <Accordion title="Is read-only access useful?" icon="eye">
    Yes. Read-only account data lets Superscale find winners, waste, fatigue, and creative patterns without changing anything in the account.
  </Accordion>

  <Accordion title="Will Superscale spend money without approval?" icon="shield-check">
    Publishing and budget actions should be approval-gated. Keep a human in the loop for spend, compliance, and brand risk.
  </Accordion>

  <Accordion title="What if my ad account is missing?" icon="circle-help">
    Check account permissions, selected business manager, page access, and integration scope. If it still does not appear, send the account ID to support.
  </Accordion>

  <Accordion title="Can I still download and upload manually?" icon="download">
    Yes. Manual export is useful for strict review workflows, unsupported platforms, or teams that prefer to upload through Ads Manager.
  </Accordion>
</AccordionGroup>

## Research and creative strategy

<AccordionGroup>
  <Accordion title="Should I copy competitor ads?" icon="copy">
    Copy the structure, not the brand. Learn from hooks, pacing, proof, layout, and offer, then translate the pattern into your product and audience.
  </Accordion>

  <Accordion title="What if the agent finds irrelevant competitors?" icon="sliders-horizontal">
    Add your own list, remove bad matches, and describe what makes a competitor relevant: same buyer, same price point, same market, same production quality, or same objection.
  </Accordion>

  <Accordion title="What does an ad score mean?" icon="gauge">
    Public ad-library signals are directional. Runtime, variants, recurrence, and format repetition suggest what is worth studying, but they are not private ROAS.
  </Accordion>

  <Accordion title="How many variants should I generate?" icon="copy-plus">
    Generate enough to test a hypothesis, not as many as possible. Change one variable at a time: hook, audience, value proposition, format, offer, or visual style.
  </Accordion>

  <Accordion title="What if I have no past account data?" icon="chart-no-axes-column">
    Start with competitor research, reviews, and a small testing matrix. Once ads run, connect account data so future batches learn from your own results.
  </Accordion>
</AccordionGroup>

## Video, voice, and localization

<AccordionGroup>
  <Accordion title="Should I generate the whole video from scratch?" icon="clapperboard">
    Not always. Many strong workflows are hybrid: AI for the hook or creator, real B-roll or screen recordings for product trust, and Superscale for captions, voice, and editing.
  </Accordion>

  <Accordion title="Can I edit one video scene?" icon="square-pen">
    Think scene-by-scene. Regenerate or replace the weak scene where supported instead of rebuilding the entire video.
  </Accordion>

  <Accordion title="How do I fix pronunciation?" icon="mic">
    Add pronunciation guidance in brand context and in the video prompt. Use simple phonetics for names, acronyms, and industry terms.
  </Accordion>

  <Accordion title="How do I localize an ad?" icon="languages">
    Localize copy, visuals, audio, and market context. Do not only translate the script. Specify the market, accent, currency, and local examples.
  </Accordion>

  <Accordion title="What if the video looks too AI?" icon="eye">
    Use real footage, less polished scripts, tighter scenes, a better voice, and more natural references. Hybrid workflows usually feel more authentic.
  </Accordion>
</AccordionGroup>

## Products, assets, and formats

<AccordionGroup>
  <Accordion title="Can a product be a collection or bundle?" icon="boxes">
    Yes, if that is the level the ad should reason about. Create a product-like entry for a collection or bundle and attach representative images and offer details.
  </Accordion>

  <Accordion title="What if I do not use Shopify?" icon="shopping-bag">
    Use a website, landing page, manual product setup, CSV, or attached product context. Shopify is the easiest path, not the only one.
  </Accordion>

  <Accordion title="How do I keep product images exact?" icon="scan-line">
    Attach the exact product asset, keep the reference set narrow, and say what must not change: packaging, logo, UI, color, label, screenshot, or layout.
  </Accordion>

  <Accordion title="Can Superscale export every aspect ratio?" icon="crop">
    Superscale supports common paid-social formats. The export view shows which ratios are available for the creative type you are working with.
  </Accordion>

  <Accordion title="Can I bulk download a batch?" icon="download">
    Use batch or project export controls where available. If a creative type still exports one by one, organize outputs in a project and download the final selections first.
  </Accordion>
</AccordionGroup>

## Teams, agencies, security, and advanced workflows

<AccordionGroup>
  <Accordion title="How should agencies set up clients?" icon="building-2">
    Use one workspace with many brands when the agency owns operations and billing. Use separate workspaces when clients need isolated billing, members, ownership, or access boundaries. See [Agencies](/business-types/agencies).
  </Accordion>

  <Accordion title="Where do compliance rules belong?" icon="shield-check">
    Put durable legal, brand-safety, and claims rules into context. Use workspace level for agency-wide rules, brand level for one client, and product level for offer-specific restrictions.
  </Accordion>

  <Accordion title="Can I upload confidential assets?" icon="lock">
    Follow your contract, DPA, and internal policy. For unreleased or sensitive material, confirm the processing boundary before uploading.
  </Accordion>

  <Accordion title="Can I use Superscale with external agents or APIs?" icon="bot">
    Superscale for Agents is the direction for API and MCP workflows. Until a workflow is available in your account, use the UI and file handoff patterns.
  </Accordion>

  <Accordion title="How do scheduled tasks work?" icon="calendar">
    Schedule narrow recurring jobs: weekly competitor scans, daily account health checks, Monday creative concepts, or report summaries. Define the source, cadence, and exact output.
  </Accordion>
</AccordionGroup>