> For the complete documentation index, see [llms.txt](https://help.intangible.ai/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.intangible.ai/compose/shots.md).

# Shots

Add, duplicate, reorder. Each shot saves its own camera, lens, and aspect ratio; animation lives on the shared scene timeline.

A shot is a saved camera framing inside a scene. Add, duplicate, delete, reorder. Each shot remembers its camera position, lens, and aspect ratio. Animation isn't saved per shot; it lives on one shared scene timeline, and each shot is a time window into it.

## Watch

<https://www.youtube.com/watch?v=BbS5ml0Uzx4>

![Compose mode with multiple shots visible in the Storyboard at the bottom, each shot card showing duration and a thumbnail](https://1179478100-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FSWrjIqlgVAblx6vHGJiM%2Fuploads%2Fgit-blob-4a44da33be7ac97470e7d80fd570300ffa4cc09d%2Fstoryboard-01.png?alt=media)

## What it does

Setting up a shot in a previs pipeline means manually keying camera transforms, naming them by hand, and remembering which file holds which take. Intangible's shots are a built-in primitive – click the camera **+** icon below the viewport, the current framing becomes a saved shot in the storyboard at the bottom of the screen. From then on, click the shot thumbnail and the camera snaps to that framing.

The thing that catches new users: animation in Compose mode lands on the shared scene timeline, not on the active shot. Move an object in Compose with a shot active and the keyframe records on the scene timeline; every shot whose time window covers that frame shows the motion. Move the same object in Build mode and it commits to permanent scene state, no animation. See [Animation and shot time](/overview/concepts/animation-and-shot-time.md) for the why.

## How to use it

The take-shot control is the camera **+** icon directly below the camera viewport. Click it to capture the current framing as a shot, the same gesture as a physical camera. The storyboard with thumbnails sits across the bottom of the screen.

1. **Add a shot.** Click the camera **+** icon below the viewport, or press `C` (see [Keyboard shortcuts](/overview/reference/keyboard-shortcuts.md)). The current viewport framing becomes Shot 1 with a thumbnail in the storyboard. Each new shot is placed sequentially in scene time, starting where the previous shot ends.

   To place it somewhere else, use the dropdown beside that button. It holds two items: **Add Shot at End**, which is what clicking the button does, and **Add Shot at Current Frame**, which starts the shot at the playhead instead.
2. **Frame the shot.** Move the camera as needed – free cam or fine-tune (see [Camera controls](/compose/camera-controls.md)). The framing updates live in the thumbnail.
3. **Duplicate.** Use the ellipsis (⋯) menu on a shot card → **Duplicate**. The duplicate copies the shot's camera framing plus its point in time and duration, and lands at the same point in scene time as the original. It does not copy the shot's generated renders.
4. **Reorder.** Drag a shot thumbnail left or right in the storyboard to change its position within the scene.
5. **Delete.** Ellipsis (⋯) menu on a shot card → **Delete**. Confirms before removing.
6. **Set a lens.** Each shot has its own lens choice – defaults to the scene-camera lens but overrides freely. See [Lenses](/compose/lenses.md).
7. **Add details.** The shot details panel has Name and Description fields. These feed the auto-prompt at render time, so a shot named "low-angle hero" with a description of "Lamborghini accelerating from a stop" gives the visualizer specific context.

### Adding a shot at the current frame

Sequential placement is the default, and it isn't always what you want. A shot can also be added at the current frame, so it starts there instead of after the last shot.

### Sequencing rule worth knowing

To author motion in Compose mode, have a shot active first. Keyframes only record while a shot is active, and they land on the shared scene timeline at the current frame. Move an object in Build mode (or in Compose with no shot active) and it commits to permanent scene state instead, with no animation. See [Animation and shot time](/overview/concepts/animation-and-shot-time.md).

{% hint style="danger" %}
**Deleting a scene deletes every render in it.** The scene's ellipsis (⋯) menu and a shot card's ellipsis (⋯) menu sit close together and sometimes stack right above each other. Before you confirm a delete, check you're on the shot's thumbnail, not the scene. Deleting the shot removes the framing; deleting the scene removes the scene and all the generations made inside it.
{% endhint %}

![Adding shots to a scene: each new shot lands as its own card in the storyboard below the viewport](https://1179478100-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FSWrjIqlgVAblx6vHGJiM%2Fuploads%2Fgit-blob-28cc2cf6aa1c66713a651cba825254c8588adae2%2Fadd-shots-storyboard-01.gif?alt=media)

## Details

| Action           | Where                                        |
| ---------------- | -------------------------------------------- |
| Add Shot         | Camera **+** icon below the viewport, or `C` |
| Duplicate        | Shot card ellipsis (⋯) → Duplicate           |
| Reorder          | Drag thumbnail in the storyboard             |
| Delete           | Shot card ellipsis (⋯) → Delete              |
| Rename           | Click the shot name in the details panel     |
| Set lens         | Lens picker in the viewport                  |
| Set aspect ratio | Aspect ratio picker in the viewport          |

## Limits and known issues

* **Shots are scene-bound.** A shot can't reference a camera in a different scene. Cross-scene edits live in the [Sequence Timeline](/compose/timeline.md).
* **Reordering doesn't update the auto-prompt history.** If you renumber shots after rendering, the rendered images keep their original shot numbers in metadata. Rename rather than reorder for this reason if you care about file naming.
* **Animation lives on the shared scene timeline, not per shot.** Keyframes record while a shot is active but belong to the scene; Build-mode moves commit to permanent scene state. This trips up users coming from sequencer-style tools. See [Animation and shot time](/overview/concepts/animation-and-shot-time.md).

## Seeing your shots in Build

Every shot puts a camera in the scene, and those cameras are visible while you work in Build.

Each camera carries its shot number. The selected camera draws in amber with frustum lines showing what it covers; the others stay dark. Two cameras aimed at the same spot from different heights are obvious at a glance, which is hard to tell from the storyboard alone.

![Shot cameras in the Build viewport, each carrying its shot number, with the selected one in amber and its frustum drawn](https://1179478100-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FSWrjIqlgVAblx6vHGJiM%2Fuploads%2Fgit-blob-4009ca0bd206a4c27bb9257e8590423cb49073e9%2Fshot-cameras-in-build-01.png?alt=media)

### Jump from a shot to its place in the set

The shot viewfinder has a **See Shot in Build Mode** button.

![The See Shot in Build Mode button on the shot viewfinder](https://1179478100-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FSWrjIqlgVAblx6vHGJiM%2Fuploads%2Fgit-blob-9176b12eae9b1cb5b5e0455d0d3a27cd37f42dc0%2Fsee-shot-in-build-01.png?alt=media)

Click it and Studio switches to Build with the viewfinder still docked, labelled with the shot name. You keep seeing what the camera sees while you move the set around it.

![Build mode with the shot viewfinder docked, labelled 09 Floral Detail](https://1179478100-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FSWrjIqlgVAblx6vHGJiM%2Fuploads%2Fgit-blob-00ddbb60c8d7a0f7b22a456bf0b9812d632d6aa1%2Fshot-viewfinder-in-build-01.png?alt=media)

Close the docked viewfinder with its X.

## Related

* [Camera controls](/compose/camera-controls.md)
* [Lenses](/compose/lenses.md)
* [Aspect ratios and film gates](/compose/aspect-ratios-and-film-gates.md)
* [Shot details](/compose/shot-details.md)
* [Animation](/compose/animation.md)
* [Animation and shot time](/overview/concepts/animation-and-shot-time.md)


---

# 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 dynamically by asking a question.

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

```
GET https://help.intangible.ai/compose/shots.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 `build a script that syncs our docs to a CMS` 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.
