> For the complete documentation index, see [llms.txt](https://docs.arcade.software/kb/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.arcade.software/kb/ai-video/ai-video/editing.md).

# Editing

## Two ways to edit

### What's the difference between editing with chat and editing manually?

Once your first draft is ready, you can keep refining it two ways: by chatting with the AI agent, or by editing directly on the timeline and in the Design panel. Neither replaces the other — the chat stays open the whole time you're working, so you can mix both as you go.

Use chat for big or open-ended changes — shortening the intro, swapping a visual, rewriting a voiceover. Use the timeline and Design panel for quick, specific tweaks — reordering scenes, trimming a clip, nudging a color.

### Does editing cost AI credits?

It depends on how you edit:

* **Editing manually** — reordering, trimming, dragging on the timeline, or changing anything directly in the Design panel — is always free, no matter how much you do.
* **Editing through chat** costs credits — how much depends on your model and, from the November 18, 2026 pricing change onward, how soon you ask relative to your last request (an edit sent within 5 minutes of your last request costs less than one sent later). See [Plans, Credits & Pricing](https://docs.arcade.software/kb/ai-video/plans-credits-and-pricing.md) for the exact costs. You're only charged once a chat edit actually applies to the video — if it fails, gets stopped, or you're just asking a question without requesting a change, you keep your credits.

{% hint style="info" %}
A few actions are free even through chat: regenerating a voiceover, fitting the music to a new cut, viewing captions, and voice suggestions. Everything else you ask the agent to change counts as a chat edit.
{% endhint %}

If a chat edit makes your video longer than what you already paid for, Arcade charges the difference in credits for the extra length — but this never blocks the edit itself; if you're short on credits for the length increase, Arcade covers it rather than stopping your edit.

## The timeline

### What does the timeline actually show?

Beyond the row of scene thumbnails, the timeline has a separate track for each layer of a scene:

* **Voiceover** — the narration script for that scene, shown as its own clip
* **Music** — one continuous track across the whole video
* **Sound effects** — a collapsible track, expand it to see individual effects placed on the timeline
* **Pan & Zoom** — the camera movement Arcade applies over a scene's footage or screenshot, shown as its own clip

Each track can be edited independently — you can change a scene's voiceover without touching its visuals, for example.

### Is there a keyboard shortcut for anything here?

Yes — press `Shift+?` any time to open the full shortcuts list. Some of the ones people use most:

* **Playback** — Space (play/pause), `←`/`→` (step a frame), Shift+`←`/`→` (step a second), Home/End, M (mute)
* **Scenes** — 1–9 to select a scene by position, `↑`/`↓` for previous/next, Delete to remove the selected one
* **Editing** — Cmd/Ctrl+Z (undo), Cmd/Ctrl+Shift+Z (redo), `T` to switch the timeline view, `/` to jump into the chat box
* **Timeline clips** — Cmd/Ctrl+D/C/X/V/A (duplicate/copy/cut/paste/select all), Shift+M (toggle snapping)

The shortcuts panel also has a toggle to turn off single-key shortcuts (the ones that are just a letter or number, like `T` or `1`–`9`) if they get in the way of typing — Cmd/Ctrl-based shortcuts and `Shift+?` itself keep working either way.

## Editing with chat

### What can I ask the agent to do?

Tell it what to change in plain language. For example:

* "Make the intro shorter."
* "Swap the second scene for this screenshot."
* "Rewrite the voiceover on scene 3 to be more upbeat."
* "Add a call-to-action at the end linking to our pricing page."
* "Reorder the scenes so the demo comes first."
* "Start this clip at 0:36" or "play it at half speed" — for scenes with real footage
* "Use a different cursor style," "zoom in more here," or "don't zoom at 0:14" — for screen recordings with a cursor or zoom effect

### Can I edit one element without describing which one I mean?

Yes. Hover over any element in the preview and it outlines in blue with a small AI icon in the corner — click it and Arcade adds that element as a reference in your existing chat box, instead of opening a separate chat, so you can just type what you want changed about it.

### How do I point the agent at one specific scene?

Select the scene in the timeline to bring it into the chat, so you can say "make this one longer" without describing which scene you mean. You can also @ mention a scene directly by name instead of selecting it — see [Scenes](https://docs.arcade.software/kb/ai-video/ai-video/scenes.md).

### Can I adjust the cursor or zoom on a screen recording?

Yes, through chat. The cursor and zoom effects you see on a screen recording are added by the AI agent on top of your footage, not baked into the original capture — so you can ask for a different cursor style or size, more or less zoom, or to skip zooming at a specific moment ("don't zoom here," "zoom at 0:14").

### How do I reference a specific moment instead of a whole scene?

Type `@` to insert the video's current playback position as a timestamp into your message, instead of typing the time by hand.

## Editing manually on the timeline

### What can I do directly on the timeline, without chat?

* Reorder scenes by dragging them
* Trim a scene by dragging its edge handles
* Add a scene with the `+` button — see [Scenes](https://docs.arcade.software/kb/ai-video/ai-video/scenes.md) for the four ways to fill it
* Duplicate, copy, cut, and paste scenes (keyboard shortcuts included)
* Delete a scene from its context menu or the scene panel

### Can I edit just one scene instead of the whole video?

Yes. Select the scene in the timeline (or reference it in chat) and either edit it directly or ask the agent to change just that scene — for example, "regenerate scene 2 with a different layout" or "make this scene's headline bigger."

### Is there a limit to how many scenes or files a video can have?

Yes — 128 files total, counting every scene file in the project (used or not), not just the scenes currently on your timeline. Past that limit, adding a new scene, pasting, or duplicating one is refused with "This video has reached its file limit, so the scene wasn't added." If you hit it, delete unused scenes first.

### Does the editor work on a phone?

Yes — on a narrow screen it switches to a simplified two-tab layout (Chat / Video) instead of the full desktop timeline and panels. Once a video exists it opens on the Video tab; full manual editing controls are desktop-only for now.

## Fine-tuning in the Design panel

### What can I adjust in the Design panel?

Select a scene and open the Design panel to change it directly. What's editable depends on the scene — a title or opening scene exposes its own text fields (for example, a year, a name, a tagline) plus background and text colors, while other scenes expose:

* Voiceover — edit the script, and choose the voice and language
* Footage — for scenes with real video, scrub to the clip's start point, set its speed, and turn on its original sound
* Scene settings — the text, numbers, and colors the scene exposes (this varies scene by scene — see [Scenes](https://docs.arcade.software/kb/ai-video/ai-video/scenes.md))
* Background music — a track Arcade composed for your video, one of Arcade's built-in tracks, or your own upload; adjust the volume for any of them
* Captions — edit text and timing (the on/off toggle itself lives in the player's playback controls, not here — see below)

You can also ask the agent in chat to make any of these changes for you.

### How does voiceover editing work?

Each scene has a voiceover track. For any scene you can edit the script, and choose the voice and language — Arcade automatically picks a voice model that supports the language you choose; coverage is broad, but exactly which voices are available can vary somewhat by language. Video generation currently supports synthetic voiceover only.

If a scene includes a screen or camera recording with your own speech, captions are generated for that speech too — not just synthetic narration — and viewers can toggle them the same way as any other caption.

### Where's the captions on/off toggle?

It's a permanent CC button in the player's own playback controls — right next to play/pause and mute — not inside the Design panel. Click it to turn captions on or off for the whole video. Hover over it and an `Edit` button appears too; that opens the caption text/timing editor, which is the same place the Design panel's Captions field opens.

### Can I customize captions — font, position, color, or language?

Not yet. Captions are an on/off toggle for now, generated automatically in the video's own language — there's no styling or translation control.

### How does background music work?

When music matters to the video you're describing, Arcade asks what feel you're going for and composes a custom instrumental track to match — timed to the video's own pacing. You can also pick one of Arcade's built-in tracks instead, or upload your own, from the Design panel. Whichever you use, you can adjust its volume.

If you edit the video after a composed track is in place — making it longer or shorter, or changing the pacing — ask the agent to fit the music to the new cut rather than just looping or cutting it off early.

### What is AI b-roll?

When a scene needs supporting footage beyond your own recordings, Arcade can either use a free stock clip or generate custom footage with AI instead — the agent asks which you'd prefer once for the video.

* **Stock footage** — free on every plan.
* **AI-generated footage ("AI b-roll")** — available on Pro and Enterprise (Free scenes use stock footage instead), and charged by the second of generated footage — about **1.4 credits/sec** at the tier most workspaces get today. Arcade is rolling out a version that lets you pick between two tiers up front (Standard, around 1.4 credits/sec, and Premium, around 3.2 credits/sec) — that explicit choice is only live in one internal workspace so far, so most of you won't see it yet, but the per-second billing itself is live for everyone now that AI credits have launched.

However the footage gets there, the clip controls below (speed, start point, volume) work the same on it. See [Plans, Credits & Pricing](https://docs.arcade.software/kb/ai-video/plans-credits-and-pricing.md) for how this fits into your overall credit usage.

### Can I control a clip's speed, start point, or volume?

Yes, for any scene that includes real footage — your own recording, a stock clip, or AI b-roll. Open the Design panel to:

* Scrub to the moment you want the clip to start — the window always matches exactly how much footage the scene will use at the current speed
* Set its speed anywhere from `0.5x` to `2x`
* Turn on its original sound and set its volume

You can also ask the agent to make the same changes from chat — for example, "start this clip at 0:36" or "play it at half speed."

### Why is a clip's volume locked at zero?

If a clip has no sound of its own, its volume control locks at `Muted` with a note explaining there's nothing to turn up. If you turn a clip's volume up and it turns out to have no actual sound, Arcade warns you and offers a one-click `Turn sound off` — publishing is blocked until a muted clip with no sound is actually set to muted.

## Style and reference

### Can I use another video as a style reference?

Yes. When creating or editing a video, choose `Add reference video` to open the same library picker used for `Add files` — including videos Arcade generated, even drafts. Arcade breaks down the reference video's pacing, transitions, and camera work, and carries that look into your new video.

Use this to keep a series visually consistent, or to build on a video that's already working. The library lets you filter between `Published` and `Draft` videos when picking a reference.

For copying an existing video's scene structure directly — not just its style — use a **template** instead of a reference. See [Templates](https://docs.arcade.software/kb/ai-video/ai-video/templates.md) for the difference.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.arcade.software/kb/ai-video/ai-video/editing.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
