# Browse Preview Docs Source: https://docs.preview.io/index Generate, organize, and produce projects in Preview. A quick tour of how a project comes together, from your first canvas to a fully organized shoot. Sign up for Preview to start creating today. Open the app and keep working in your project. A creative AI partner that understands your project inside and out and helps you get anything done. Script against your projects, or connect ChatGPT, Claude, and Cursor straight to Preview. ## The Basics Before you start generating, three things are worth knowing: how the canvas works, how credits work, and how to keep your projects organized in Preview. The infinite canvas where you generate and arrange work, and where the rest of the flow begins. How Preview's pay-as-you-go credit system works, and how to buy more. Assign files to shots and watch your sequence take shape, right at the top of the canvas. All your sequences in a dedicated view, for metadata, status, and team collaboration. Write and develop your screenplay in blocks, with your library and Preview Agent built in. Everything you can do with a file on canvas, one click away. ## Generate with intention Multiple ways to generate, iterate, and push your ideas further. Generate images and videos with all of the latest generative models. One-click tools to help you ideate and create with consistency. Browse everything a canvas has generated in one feed, then choose what's worth placing on it. Organize the canvas and direct new generations into specific areas. ## Keep consistency Save characters, props, and locations once, reuse them in every prompt. Save and reuse characters, props, locations, and files. Pull saved files and past generations into any prompt by typing @. ## Collaborate and ship Review work with your team, then hand it off or export it. Leave feedback on the canvas and on individual files in File view. Invite collaborators or send a review link to clients outside the project. # Preview Agent Source: https://docs.preview.io/preview/agent Your AI creative partner that understands your whole project and helps you get anything done, from a shot list to a finished frame. Preview Agent isn't a chatbot bolted onto the side of the app. It's a creative collaborator that sees your whole project and can act anywhere in it: build a shot list, generate and organize files, keep a character consistent across scenes, or clean up a messy canvas. ## Open it Click the glowing orb in the page header, or press **⌘/Ctrl + /**, to open it as a chat panel on the right with its own threads: start a new one, rename it, or switch back to an earlier conversation anytime. Type your message or dictate via the mic icon. Type `@` to reference a library item, upload, or past generation. See [Referencing with @](/preview/at-references). Preview Agent chat panel ## What it can do * **Bring real filmmaking know-how**: cinematography, story development, shot-list planning, strong prompt-writing, and coverage are all built in, alongside every Quick Action. * **Understand your project**: reads your story, sequences, shots, canvases, library, tags, and activity history to answer questions and stay in context without re-explaining anything. * **Manage shots and sequences**: create, update, and batch-edit shots and sequences; assign or move files between them. * **Manage your library**: create and update Characters, Props, and Locations, attach reference images, and link them to shots. * **Generate images and video**: queue single or batched generations (up to 8 at a time) on any model, with cost shown before anything runs. * **Transform files for free**: resize, crop, or extract a frame instantly instead of paying for a full regeneration. * **Search the web**: pull in outside references or images when a prompt needs them. * **Keep a paper trail**: files it generates are marked as co-authored, with a link back to the chat that made them, visible from [File View](/preview/preview-window) and the canvas. ## Approving generations * **Ask mode (default)**: every generation pauses in chat for your approval before it runs. * **Auto mode**: skips approval, for when you just want it to handle everything. Switch modes from the **Confirmation** settings button in the chat header. ## Example prompts * "Build a shot list from this script." * "Give me more coverage on shot 12: a few reverse angles." * "Create a character sheet for my lead so I can keep her consistent." * "Storyboard scene 3, sketch style." * "Resize this to 1080x1920. No need to regenerate." * "Clean up this canvas." You can't delete anything through Preview Agent; delete manually instead. # Referencing with @ Source: https://docs.preview.io/preview/at-references Type @ in the prompt box or Preview Agent to pull in library items, past generations, uploads, and recently used references. Type `@` in the prompt box or a Preview Agent message to open the same reference menu in both places. ## What you can reference * **Recently used**: your last few references, for quick reuse. * **Characters, Locations, Props**: your library by category, each showing its item count. Type after `@` to search by name, or click a category to browse directly. An item with multiple [variations](/preview/project-library) or images shows a count; click through to pick one instead of the default. Only files saved to your [project library](/preview/project-library) show up here: save a Character, Location, or Prop first, then reference it by name. * **Gen History**: every file generated in this story. Search by description (subject, color, style), not just exact name. * **Uploads**: project files outside any library category. Only saved library items, uploads, and finished generations can be referenced this way, not items still generating or unsaved on the canvas. The @ reference menu ## After you pick The reference appears as a chip in your text. Right-click it to **Locate on canvas** (when it's placed there), **Replace** with something else, or **Remove**. Reference chip context menu The prompt box also has **Click to pick**, to reference directly from the canvas instead of the menu; it enforces each model's reference limit too. Preview Agent's chat has a simpler **+** attach button (Assets, Characters, Locations, Props, Upload) as a flatter alternative alongside the same `@` menu. ## Keyboard shortcuts Arrow keys move through the list, → drills into a category or variation, ← backs out, Enter picks, and Escape closes the menu. Press Escape twice with an active search or filter. Recently used references are shared across the prompt box, Preview Agent, and the whole project: pick something once to reuse it anywhere. # Studio Source: https://docs.preview.io/preview/canvas-overview Understand the infinite canvas, prompt box, sequence timeline, and live collaboration tools in Preview. The studio is where you generate images and videos and arrange them in a project. This page covers the canvas itself; the [Sequence Timeline](/preview/scene-timeline) and [Production](/preview/shotlists-overview) pages cover the rest. ## Key parts of the canvas Key parts of the canvas, numbered The numbers below match the callouts in the image above. On the canvas itself: 1. **[Prompt box](/preview/prompt-box-overview)** (bottom center): generate images and videos. 2. **Toolbar** (bottom left): Cursor, Hand, Comments, and Sticky note tools, plus an **Add** button for bringing in files (**Upload** or **Uploads**). 3. **Minimap** (lower right): zoom and jump around large canvases. Shows colored markers for groups, sticky notes, and tagged files; drag its edges to resize it. 4. **[Sequence Timeline](/preview/scene-timeline)** (top): assigns files to shots. 5. **[Production / Studio](/preview/shotlists-overview)** switcher: Studio is this canvas; Production is the management side, with three synced views (Shotlist, Storyboard, Kanban). 6. **Play** (upper right, beside Share): preview a sequence's shots back to back in a mini playback window. In the app sidebar, not the canvas surface itself: 7. **[Comments sidebar](/preview/comments)**: review discussion history. 8. **[History sidebar](/preview/history)**: every image ever created or imported, filterable by user. Drag one back onto canvas to restore it. ## Files view Every canvas has two faces: **Canvas view**, the surface itself, and **Files view**, a feed of everything ever generated or uploaded on that canvas. Switch between them from the tabs on the canvas pill in the top-left. Files view in Grid layout, with the view tabs on the canvas pill Use it to review a canvas's entire output in one place. Each canvas has its own Files view; for a project-wide history across every canvas, use the [History](/preview/history) sidebar instead. * **Place on canvas, or don't**: hover a file for its **Place on canvas** / **Remove from canvas** toggle, bottom-left of the tile. Placing shows a toast with a **Go to** button that jumps straight to the file on canvas; removing takes it off the canvas but keeps it here. * **Place on canvas by default**: one switch in **Generation settings** (top right), on out of the box. Turn it off and Files view becomes a staging area: generate freely, review the batch here, and place only what's worth keeping. * **List or Grid**: filter by **Type**, **Model**, **Resolution**, or **Aspect ratio** from the **Filters** control. * **List layout**: generations grouped by date, then prompt, with creator, timestamp, prompt text, and settings on each row. * **Grid layout**: a dense gallery with an adjustable tile size. ## Sticky notes Sticky notes are for quick, freeform notes that live on the canvas itself, separate from the threaded, timestamped discussion in Comments. Click the sticky note tool in the bottom-left toolbar (or press **N**) and click the canvas to place one; it enters edit mode and grows as you type. * **Format text**: select text inside a note for Bold, Italic, Strikethrough, and Bullet list. * **Change color or size**: open a note's **⋯** menu for six colors and three text sizes. * **Resize**: drag a corner handle; notes scale proportionally. Use the same **⋯** menu to duplicate a note, copy its link, or delete it. ## Comments Click the comment tool in the bottom-left toolbar to leave feedback directly on the canvas. See [Comments](/preview/comments) for the full drawing and threading toolkit. ## Work with collaborators Follow another person's cursor by clicking their avatar (upper right), or send a short live canvas message by typing `/`. ## Multiple canvases As a project grows, one canvas often isn't enough for every storyline, department, or exploration pass. Canvases belong to the project, not one sequence, so create or switch between them from the top-left canvas picker (its header reads **Bins**: the bins hold your canvases). Once you have several, group them into named sections: * **Create a section**: from the picker's **⋯** menu, choose **Create section**, or right-click a canvas and choose **Move to → Create section** to start one with that canvas included. * **Move a canvas into a section**: right-click it (or open its **⋯** menu) and choose **Move to**. No drag-and-drop for individual canvases; only sections drag-reorder. * **Rename or delete** a section from its own **⋯** menu. * **Select multiple canvases** with Shift-click or Cmd/Ctrl-click, then right-click for bulk **Move to** or **Delete**. * **Search** the picker by canvas or section name. * **Sort** canvases Alphabetical or Recently used, from the picker's **⋯** menu. Canvas picker with sections ## Next: turn what you've made into shots Continue to [Sequence Timeline](/preview/scene-timeline), which sits right at the top of this same canvas. # CLI/MCP Source: https://docs.preview.io/preview/cli Script against your projects from the command line, or connect AI apps like ChatGPT, Claude, and Cursor straight to Preview. Two ways to work with Preview from outside the app: the **CLI**, a JSON-first command-line client for scripting and coding agents, and the **Preview MCP**, which lets AI apps like ChatGPT, Claude, and Cursor browse, generate, and build in your projects directly. Both run as you, with the same project access and credits as the app. ## Install the CLI ```bash theme={null} curl -fsSL https://download.preview.io/cli/install | bash ``` Or through npm: ```bash theme={null} npm install -g @previewio/cli ``` Either way, the CLI keeps itself up to date: on startup it checks for a newer version, updates through whichever channel you installed with, and runs your command as usual. Opt out with `--no-update`. ## Log in Run `preview auth login`. It opens a browser to confirm a device code, then stores your credentials locally; every other command works once you're signed in. ## What the CLI is useful for * **Scripting your production data**: list, create, and update projects, stories, scenes, shots, and takes from the command line or a script, without opening the app. * **Uploading and managing media**: attach files to shots, manage library items (Characters, Locations, Props), and organize project assets. * **Connecting coding agents**: give Claude Code, Codex, or similar tools direct, structured access to a project so they can help plan and build it out. * **Serving the Preview MCP locally**: `preview mcp init` wires Claude Desktop, Claude Code, Cursor, and VS Code up to your projects, covered below. * **Batch operations**: run a list of operations from a single file instead of one command at a time. Every command supports `--json` for scripting; destructive commands require an extra `--yes` confirmation flag. ## Connect ChatGPT or claude.ai No install needed. Add a connector with this URL: ``` https://mcp.preview.io/mcp ``` Connecting opens a browser sign-in to Preview; approve it and you're done. ## Connect Claude Desktop, Claude Code, Cursor, or VS Code These run the MCP locally through the CLI. With the CLI installed and signed in: ```bash theme={null} preview mcp init ``` That configures all four clients in one go. Use `--target claude-desktop`, `--target claude-code`, `--target cursor`, or `--target vscode` for just one, or `--print` to see the config snippet without writing anything. ## What the MCP can do * **Browse and search projects**: project snapshots, canvases, takes, and context for any sequence, shot, or library item. * **Generate**: images and video on any model, singly or in batches, with cost estimates before running. * **Build structure**: create and update sequences and shots, assign takes to shots, and set statuses. * **Manage the library**: create Characters, Locations, and Props, attach images, and link them to shots. * **Write Scripts**: list, create, import, and edit a project's Scripts. In ChatGPT and Claude, a generation renders as an interactive card in the conversation: a hero image or video, a strip of every take, and live progress while it runs. Click a thumbnail to make it the hero and select it in Preview. Generating through MCP spends credits exactly like generating in the app, and every result lands in your project's Files view and History like any other take. # Comfy UI Plugin Source: https://docs.preview.io/preview/comfy-ui-plugin Connect Preview to ComfyUI to move images and videos in either direction. Preview integrates with ComfyUI: send ComfyUI generations to your Preview canvas, or send Preview files into a ComfyUI workflow. ## Connect Preview to ComfyUI In ComfyUI, open Extensions, search for `comfy-preview-nodes`, and install the latest version. Restart ComfyUI. Click the Preview icon in the ComfyUI sidebar, then **Sign In With WorkOS**. Enter the emailed code and confirm it matches the code in ComfyUI. ## Bring Preview files into ComfyUI Browse your projects in the ComfyUI sidebar. Click the insert button on an image or video, or drag it onto the ComfyUI canvas, to create a **Load Take** node usable like any other node. ## Send ComfyUI output into Preview With a canvas open in the target project, choose an existing Group (or create one) and select **Connect to Comfy** from its context menu, which copies an **Upload Image Take** node. Paste the node into your ComfyUI workflow, connect your image output to it, then run the workflow. The result lands automatically in that Group on your Preview canvas. Paste multiple Group nodes at once to send different outputs to different groups. # Command Palette Source: https://docs.preview.io/preview/command-palette Open the command palette to jump anywhere, search files, and run actions on your selection, all from the keyboard. Press **⌘/Ctrl + K** anywhere in a project (Studio or any Production view), or click the search icon at the top of the app, to open the command palette. It adapts to selection: nothing selected shows navigation and canvas tools; a file or group selected adds actions for it. Most also work as direct keyboard shortcuts once something's selected, no need to open the palette first. Command palette open ## Jump around | Action | Shortcut | Available in | | ------------------------------------------------- | --------- | ---------------- | | Jump to canvas | ⌘/Ctrl J | Everywhere | | Find take | — | Everywhere | | Go to shot | — | Production views | | Toggle sidebar | ⌘/Ctrl . | Everywhere | | Toggle Preview Agent | ⌘/Ctrl / | Everywhere | | Switch to Studio / Shotlist / Storyboard / Kanban | — | Everywhere | | Previous / next sequence | `[` / `]` | Studio | **Find take** searches by meaning, not exact text: type what you remember (a subject, color, style) and matching files surface even without the exact prompt. Typing a file's ID jumps straight to it. ## Canvas tools and view | Action | Shortcut | | ------------------------------------------ | ------------- | | Select / Hand / Comment / Sticky note tool | V / H / C / N | | Zoom in / out | ⌘/Ctrl + / − | | Zoom to 100% / fit | ⌘/Ctrl 0 / ⇧1 | | Undo / redo | ⌘/Ctrl Z / ⇧Z | ## With a file selected Select a file on canvas first, then open the palette. It adds a whole set of actions scoped to that file, on top of the usual navigation and canvas tools: | Action | Shortcut | | ---------------------------------- | -------- | | Fullscreen | F | | Zoom to take | ↵ | | Copy prompt | ⇧C | | Prompt info | ⇧P | | Add as reference | — | | Crop | C | | Download | D | | Add to Character / Location / Prop | — | | Duplicate | ⌘/Ctrl D | | Delete | ⌫ | ## With multiple files or a group selected | Action | Shortcut | | ---------------------------------- | -------- | | Group | ⌘/Ctrl G | | Download all | D | | Add to Character / Location / Prop | — | | Duplicate | ⌘/Ctrl D | | Delete | ⌫ | Delete runs immediately, with no confirmation step. Press ⌘/Ctrl Z to undo a mistake. # Comments Source: https://docs.preview.io/preview/comments Leave comments on the canvas or in file view so collaborators can review work in context. Use comments when feedback is about something specific, a file, a shot, or a spot on the canvas, and needs to stay attached to it instead of getting lost in a chat message or email. Internal collaborators can leave them right on the canvas; external clients can do the same from a [review link](/preview/sharing) without a Preview account. Either way, the comment lands in the same thread for everyone to see. ## Add comments on the canvas Open comments from the comment button in the lower-left toolbar. * **Place anywhere**: drop a comment on empty canvas or pin it to a specific file. * **Attach images**, **tag people**, and **add emoji**. * **Reply in threads**: keep discussion attached to the original comment. * **Draw on files**: use the **Draw**, **Arrow**, **Line**, or **Box** tool in 7 colors. Click the active tool again to switch back to selecting (then delete a stroke), or press ⌘/Ctrl Z to undo. Drawings are canvas-comment only, not in file view. Comments stay attached to a file wherever it moves on the canvas. Canvas comment with a drawing annotation ## Review comments in the sidebar Every comment also appears in the Comments sidebar, to review discussion history and jump back to a thread. Comments sidebar ## Add comments in file view Comments work in [File View](/preview/preview-window) too, for review focused on one file at a time instead of the whole canvas. Switch to its Comments tab and the cursor becomes a pin; click anywhere on the file to drop it and comment, with the same replies, reactions, and resolving as canvas comments. Pins stay in sync both ways: drop one in File view and it shows on canvas too, and vice versa. This only works for generated files, not references or library images, and pins can only be placed while the Comments tab is active. Commenting inside File view ## Add comments in the share window Clients and team members can comment on a file or shot via the Share link, and those comments show up back on the file for everyone, the same as any other comment. Use canvas comments for spatial feedback, and file-view comments for file-specific review. # Edit in Photoshop Source: https://docs.preview.io/preview/edit-in-photoshop Send an image to Photoshop, edit it there, and bring the result back to the canvas. For image editing and refinement, not video generation. ## Install the plugin One-time setup. [Download the plugin](https://download.preview.io/ps/Preview_0.0.1.zip) and unzip it. Open `io.preview.photoshop_PS`. Creative Cloud prompts you to install a non-marketplace plugin: click **Install**, then **OK**. Open a project in Photoshop, open the plugins panel, choose **Preview**, and click **Sign In**. Confirm the activation code in your browser matches the plugin's. Your Preview projects appear in the Photoshop plugin viewer. Open one and select an image to load. Installation issues? See [Adobe's plugin installation troubleshooting guide](https://helpx.adobe.com/creative-cloud/kb/solve-external-plugin-installation-issues.html). ## Send an image to Photoshop and back Open an image's three-dot menu on the canvas and click **Edit in Photoshop** to copy a link to your clipboard. In Photoshop, click **Load from Clipboard** in the Preview plugin window. Make your edits, then click **Sync Back** to send the result to the same Preview canvas. Save your image in Photoshop before syncing back. Once sent to Preview, it's no longer visible in Photoshop. It also won't appear on your canvas automatically: open the [History](/preview/history) sidebar and drag it onto the canvas yourself. ## When to use Photoshop editing Use Photoshop for: * Precise manual image changes * Cleaning up or compositing a frame before reusing it * Returning an edited image to the canvas for more generation ## Return the edited image to the canvas The result comes back directly into Preview and behaves like any other canvas image: use it as a reference, save it to the library, add it to a shot, or keep generating from it. The Photoshop plugin is a work in progress, so expect it to keep improving. # File Toolbar Source: https://docs.preview.io/preview/file-toolbar Use the file toolbar, its More menu, and video-specific controls to work with files on the canvas. ## The toolbar Click a file on the canvas to select it. A toolbar appears below it. Right-click a file for the same More menu, without opening the toolbar first. Left to right: * **Tools**: opens the [Quick Actions](/preview/quick-actions) menu. * **Enter changes...**: your direct line to [Preview Agent](/preview/agent) for this exact file. Type what you want changed, or just say it with the mic icon, and watch the edit happen right on the canvas. * **Inpaint**: edit part of the image while leaving the rest unchanged. See [Inpaint](/preview/inpainting). * **Target**: a quick reference whose label changes with context (**Add as Reference**, **Add as Ingredient**, **Set as Start Frame**, **Set as End Frame**), but it's always adding the file as a reference in some form. * **Reuse prompt**: places the file's prompt, model, and style or Camera Bag settings back into the prompt box. * **Prompt info**: a quick popover preview of the generation details; click **More info** inside it for the full [File View](/preview/preview-window). * **⋯**: everything else, in the More menu below. Take toolbar ## The More menu The toolbar surfaces the actions you reach for most; everything else lives one click deeper in the More menu. * **Add to...**: save the file into a Character, Location, or Prop. * Video files also add a **Playback** group, covered below. * **Duplicate** (⌘D), **View** (F, if fullscreen-capable), **Crop** (C), **Download** (D), and **Copy image** (image only) are self-explanatory. * **Compare with...** (image only): pick a second image via **Click to pick** or **Choose from library**, and both open in [File View](/preview/preview-window)'s compare mode. * **Edit in Photoshop** (image only): covered in [Edit in Photoshop](/preview/edit-in-photoshop). * **Tag**: add a color tag, covered in [Tags](/preview/tags). * **Copy prompt** (⇧C) and **Prompt info** (⇧P): Prompt info opens [File View](/preview/preview-window) for the full generation history. * **Delete**. Copy and paste (⌘C / ⌘V) work across sequences and canvases from the keyboard or the canvas right-click menu: copy a file or group in one place, paste into another, or paste an image copied from outside Preview. More menu on a video file ## Select multiple files Select 2+ files for a toolbar below the selection: * **Tidy up**: snap loosely arranged files into a compact grid. * **Group** (⌘G): group the selection. Same [Groups](/preview/groups) feature as creating one from an empty canvas. * **Enter changes...**: ask [Preview Agent](/preview/agent) to iterate on the whole selection. * **Compare** (with exactly two images selected): open both in [File View](/preview/preview-window)'s compare mode. Right-click the selection (or click its **⋯** button) for a menu: * **Add to...**: save into a Character, Location, or Prop. * **Add as reference**. * **Download**. * **Tag**. * **Copy (N)** and **Delete (N)**. Multi-select toolbar and menu ## Video-specific actions
Video playback row on a selected file
Selecting a video adds a **playback row** above the toolbar (play/pause, a scrubber, and the current time) and drops **Inpaint** from the action row, since video can't be inpainted. The **Tools** menu adds **Auto split** (tagged Multi-shot): it cuts a multi-shot video at its shot boundaries into separate single-shot files, which land on the canvas as their own takes, with placeholders showing while the split runs. Use it when one generation gave you several shots' worth of footage and you want to assign each piece to its own shot. The More menu gets an extra **Playback** section, video only: * **Extract frame**: Current frame, Start frame, End frame, or All frames. * **Trim**: replaces the whole toolbar with a dedicated trim row. Drag the handles across the full source timeline, then confirm (✓) or cancel (✗). * **Playback speed**.
More menu Playback section
# Generate World Source: https://docs.preview.io/preview/generate-world Create an explorable world from a reference image and capture new camera angles back onto the canvas. Generate World turns a single reference image into an explorable space, so you can find camera angles the original image didn't give you, then capture that new view back to canvas as a fresh image. ## Use Generate World Pick a reference image on canvas. Generates an explorable world from that image. Move through the world until you find your shot. Click **Capture Take** to save the shot back to canvas. ## What happens after capture The captured frame returns to canvas like a high-resolution image: * Use it as a new reference * Save it into the library * Add it to a shot * Continue iterating with more prompts Generate World works best with a clear environment image: no people or creatures. # Get started in Preview Source: https://docs.preview.io/preview/getting-started A quick tour of how a project comes together in Preview, from your first canvas to a fully organized shoot. Preview is a collaborative canvas for making and organizing AI video and image projects, start to finish. Here's the shape of a project, step by step. Select **New Project**. Your project is the top-level container for canvases, shot lists, collaborators, and saved files; it starts as "Untitled Project", renameable anytime from the project menu. Create a project in Preview An infinite, multiplayer workspace. Everyone on the project can see and generate here together, in real time. Your first canvas in Preview Two ways to make something: * **[Prompt box](/preview/prompt-box-overview)** (bottom of the canvas): write what you want, pick a model, and generate directly. Generating from the prompt box * **[Preview Agent](/preview/agent)**: describe what you want in chat and let it build it for you. Generating with Preview Agent The **[Sequence Timeline](/preview/scene-timeline)** sits at the top of your canvas. Assign a file to a shot (a slot for one piece of your story) and it lands there immediately, so your sequences (the scene groupings that make up a shot list) take shape as you generate. Assigning a file to a shot in the Sequence Timeline Click any file on canvas to bring up its **toolbar**: iterate on it with Quick Actions or Preview Agent, inpaint part of it, reuse its prompt, or add it as a reference, all without leaving the canvas. See [File Toolbar](/preview/file-toolbar#the-toolbar). The toolbar below a selected file ## Scale up: more canvases, more shot lists Two different ways to expand a project and stay organized: * **[Canvases](/preview/canvas-overview)**: from the picker in the top-left corner of Studio, create as many as you need. Canvases belong to the project, not any one sequence, so use one per part of the project, or a scratch space to experiment visually. Canvas picker showing multiple canvases * **[Shot lists](/preview/shotlists-overview)**: a project can hold multiple shot lists, each an independent set of sequences. You can use them to version sequences or track side ideas without touching your main cut. Shot list switcher showing multiple shot lists ## Stay consistent Before you're deep into managing shots, it's worth saving anything you'll reuse: a character's face, a location, a prop. Save it once and call it back into any prompt instead of re-describing it from scratch. * **Save it**: right-click an image on canvas or use its three-dot menu on the toolbar and choose **Add to...** to save it as a Character, Location, or Prop. Saving a file as a Character, Location, or Prop via Add to... * **Library**: everything you save collects here, all in one place, organized by Character, Location, and Prop. See [Project Library](/preview/project-library). The project library * **Reference it**: type `@` in any prompt to pull a saved Character, Location, or Prop back in, same face, same set, same object, every time. See [Referencing with @](/preview/at-references). Picking a saved Character with @ in the prompt box ## Manage it all in Production Once there's real structure to track, click **[Production](/preview/shotlists-overview)** at the top of the screen, beside Studio. * **Shotlist** and **Storyboard**: detailed metadata, shot-by-shot breakdown. * **Kanban**: where your team tracks status at a glance and moves work through pipelines. All three stay synced live, and so does the canvas. Change something in one place and it updates everywhere. Shotlists view switcher ## Always within reach * **[History](/preview/history)**: every file ever created or imported in the project, always browsable, filterable by who made it. Click the **History** icon in the left sidebar to open it. History sidebar * **[Files view](/preview/canvas-overview#files-view)**: flip any canvas into a live feed of everything generated on it, for reviewing a batch before deciding what's worth placing. Switch to it from the **Files view** tab on the canvas pill, top left. Files view grid ## Share your work When a project's ready for eyes outside your own, share it two ways from the **Share** button in the app's upper-right corner. Share menu * **[Invite a collaborator](/preview/sharing#collaborator-invites)**: add someone by email with a role (Can edit, Can comment, Can view). They'll need a Preview account and get real access, for people doing actual work in the project with you. * **[Send a review link](/preview/sharing#review-link)**: no account needed, just a link. Anyone who has it can browse the project and leave comments, perfect for clients and stakeholders who just need to see the work and weigh in. ## Export The last piece: take everything you've built and move it into an editing system, either by right-clicking a sequence and choosing **Export sequence** for just that one, or from the Project menu's hamburger icon, choosing **Export** for everything in your active shot list. Either way, you get an FCPXML timeline for Final Cut Pro or DaVinci Resolve, ready to keep working with outside Preview. Exporting a shotlist * **[Export](/preview/settings-menu#export)**: from the Project menu, exports every sequence in your active Shotlist as a ZIP with media and an FCPXML timeline. * **Export just one sequence**: right-click any sequence in the timeline and choose **Export sequence** for the same export, scoped to just that one. ## Vocabulary * **Shot list**: a full set of sequences and shots; a project can have multiple. * **Sequence**: how you organize shots within a shot list. * **Shot**: where you save your selects. * **Select/Take**: a file saved to a shot. * **File**: a single generation. ## Continue * [Studio](/preview/canvas-overview) for the full canvas layout, collaborators, and where new files appear. * [Prompt Box](/preview/prompt-box-overview) for generation and references in depth. * [Preview Agent](/preview/agent) for the chat-based path through all of this. # Groups Source: https://docs.preview.io/preview/groups Organize the infinite canvas and direct new generations into specific areas. ## When to use groups Use groups to separate explorations, keep references and outputs together, and stop the canvas from getting visually chaotic. A group on canvas Create groups before large prompt runs: they work best shaping the workflow early, not cleaning it up after the canvas is already crowded. ## Create a group * Right-click the canvas and choose **Create group**. * Select multiple files and press **⌘G** (or use **Group** in the selection menu). * Quick Actions that return multiple images group results automatically. ## Generate into a specific group Hover a group and click **Enter** next to its name. The canvas flips to [Files view](/preview/canvas-overview#files-view), scoped to just this group's session, with the prompt box ready; new generations land inside the group on canvas until you exit. Files view scoped to a group session Click the group chip in the prompt box to switch to a different group, or start a **New group** from the same menu.
Choosing the target group from the prompt box
## The group menu Click a group's name (or right-click the group) to open its menu: * **Rename** (or double-click the group's name directly). * **Set a color**. * **Set max columns**. * **Select all in group**. * **Organize**: arranges its files into a grid. * **Duplicate**. * **Copy link**. * **Export**. * **Copy ComfyUI ingest node**: see [Comfy UI Plugin](/preview/comfy-ui-plugin). * **Ungroup**: disbands the group; files stay on canvas individually. To delete a group and its contents, select it and press **Delete**; that option isn't in the menu. To save a group's contents to your library, select the files inside it (or **Select all in group**) and choose **Add to...**. There's no group-level "Add to..." shortcut, only on individual file selections. # History Source: https://docs.preview.io/preview/history Every file ever created or imported in the project, always browsable, filterable, and restorable to canvas. ## What it's for The History sidebar is a running record of every file in the project: every generation, every upload, every 3D world, whether or not it's currently placed on a canvas. It's in the app sidebar, not the canvas surface itself. History sidebar ## How it works * **Everything shows up here**: every file ever created or imported, across the whole project, not just the canvas you're currently on. This is also the only place that includes 3D worlds. * **Filter and search**: narrow the list by creator or by sequence (**All** / **Current**), or search past generations by prompt. * **Jump or restore**: click an item to zoom straight to it on canvas (switching canvas or sequence if needed), or drag it onto the canvas to bring it back if it isn't placed. ## Why it's valuable Nothing's ever really lost. Delete a file from a canvas and it stays in History; drag it back onto any canvas whenever you need it. That makes it safe to keep a canvas clean and uncluttered, since removing something from view is never the same as deleting it for good. ## When to use it * You deleted something from a canvas and want it back. * You're looking for a file made earlier in the project that isn't on the canvas you're currently viewing. * You need something from outside the current canvas. [Files view](/preview/canvas-overview#files-view) only shows what one canvas produced; History covers the whole project. # Inpaint Source: https://docs.preview.io/preview/inpainting Edit part of an image on canvas with Inpaint, using the inpaint model of your choice. ## Enter Inpaint mode Inpaint lets you change one part of an image, like a prop or an expression, without regenerating the whole shot and losing everything else that's already working. Select an image on canvas to reveal its toolbar, then click **Inpaint**. Inpaint button in the take toolbar This opens a limited prompt box and the inpainting toolbar: * **Brush**: start painting on the image. * **Eraser**: erase painted marks. * **Slider**: adjust brush size. * **Undo / redo**: step back or forward through brush and eraser actions. * **Trash**: clear all painting. * **X** button, or **Esc** key: exit Inpaint mode. The prompt box in Inpaint mode has its own model picker: **Seedream v5 Pro** (the default), **Nano Banana Pro**, or **GPT Image 2**. Your choice sticks for future inpaints. ## Inpaint an image Mask the part to change. Type it in the prompt box, e.g., "Change the dog to a cat." Press generate to fill the masked area. Painted mask with the requested change in the prompt box ## Inpaint with image references For a more specific change, add a reference image before painting, e.g., to change sunglasses' style: add the new sunglasses as a reference, paint out the existing ones, then describe the change. References work the same as normal generation, including **Click to pick** straight from the canvas; your mask and prompt survive the round trip. Inpainting with a reference image added Changing sequences or leaving the canvas view exits Inpaint mode. # Next Take Box Source: https://docs.preview.io/preview/next-take-box Drag the Next Take box anywhere on canvas to control exactly where your next generation lands. When the prompt box is open, Preview shows a **Next Take box** on canvas, a draggable target marking exactly where your next generation will land. Its shape matches your current aspect ratio and image/video settings, and its label updates live: "Next take," or "Next 3 takes" for a batch. Next Take box on canvas ## Move it * **Drag it** anywhere on canvas. Its position is remembered per canvas, so it stays put until you move it again. * **Right-click the canvas** and choose **Place next take here** for the same result without dragging. The box only settles somewhere with room for a full row at your current Grid columns width. If where you drop it can't fit that many takes side by side, it snaps to the nearest spot below that can. Both the box and the actual generated batch land there. While you're still dragging, a fainter outline shows you that real landing spot before you let go. ## Find it when it's off-screen A small compass icon points toward the box whenever it's off-screen: click it to jump straight there. Compass icon pointing to the off-screen Next Take box ## Preferences Click the box's **⋯** button to open **Preferences**: * **Camera follow**: automatically centers your view on new generations as they land. * **Grid columns**: how many columns a multi-take batch tiles into at the target (1–8), before wrapping to a new row. ## Generating into a group The box disappears while a [Group](/preview/groups) is your active generation target. The compass points at the group instead, and the group shows its own placeholder cells for where each take will land inside it. # File View Source: https://docs.preview.io/preview/preview-window A full-screen inspector for your files: generation details, prompt, provenance, and comments. File view opens any file (image or video) full screen with an inspector panel alongside it. It's the place to go for everything about a file in one view: how it was made, what it's based on, and what people are saying about it, instead of piecing that together from a hover here and a click there. Open it by double-clicking a file on canvas, choosing **Prompt info** from its toolbar or context menu, or pressing **⇧P** or **F** with a file selected. You can also click a file almost anywhere else in Preview (Production, library, chat, project uploads). File view overview ## What's in the panel Two tabs: **Info** and **Comments**. ### Info * **Shot information**: description, dialogue, status, and characters, if any. * **Take information** (labeled **File information** for uploads): creation date, author, resolution, and aspect ratio. [Preview Agent](/preview/agent) generations show as co-authored, with a link back to the chat that made them. * **Source**: where a web-imported file came from, if not generated in Preview. * **Prompt information**: prompt, model, resolution, Camera Bag settings, references, cost, and seed; only appears for generated files. Right-click any reference thumbnail to **Locate on canvas**, **Copy image**, or **Download**. * **Provenance**: collapsed by default. Expand for the full lineage graph: parent files, model used, and every reference that fed the generation. Click any node to jump to it, even across sequences. File view provenance graph ### Comments Switch to the Comments tab and the cursor becomes a pin over the file; click anywhere on it to drop the pin and comment. Same as canvas comments, including replies, reactions, and resolving. Pins here show on the canvas too, and vice versa. Only available for generated files, not references or library images, and only while the Comments tab is active. Commenting inside File view ## Move between files For files assigned to a shot (a select in a sequence); standalone generations don't have sibling versions to step between. The same navigation also works across a shot's reference files. * **Breadcrumbs** at the top: jump to a different sequence, shot, or file without closing the view. * **Arrow keys**: step between regenerations and alternates of the same shot. * **Thumbnail strip**: click any alternate directly. * **Canvas** button: jump back to the file's canvas position and close File view. ## Compare images Weigh two images against each other before deciding which one moves forward. Click **Compare** in the bottom bar (images only), then pick the second image via **Click to pick**, **Choose from library**, or a recently used file. * **Split**: both images overlaid, with a draggable divider to wipe between them. * **Fade**: blend between the two with a slider. * **Side by side**: both images in full, next to each other. Switch modes from the dropdown beside the Compare label, swap either side from the pill above it, and exit with the **X**. You can also start a comparison from the canvas: right-click a file and choose **Compare with...**, or select two files and click **Compare** in their toolbar. File View compare mode in Split view ## Act on a file * **Reuse**: loads the file's prompt, model, and settings into the prompt box. * **Copy prompt**: copies just the prompt text. * **Download**: downloads the file. * **Copy link**: copies a shareable link to this exact file. # Project Analytics Source: https://docs.preview.io/preview/project-analytics Track team credit usage, spend, and activity across a project through Preview analytics. ## Review broader usage analytics Hover the Analytics button (bottom left of sidebar) for a quick look at your organization's remaining credits. For the full picture, open **Usage Analytics** (from the dashboard, or from the [Project menu](/preview/settings-menu)'s hamburger icon). It's a dedicated page covering: * Member usage * AI model usage * Usage over time * Team usage * Generation types * Credit projection * Recent activity Everything your organization needs to track spend, tool usage, and activity in one place. Check analytics regularly on team projects to catch credit spikes and see where generation activity concentrates. # Project Library Source: https://docs.preview.io/preview/project-library Save and reuse characters, props, and locations, plus general files that don't fit a category. Save an image to the library once, then reference it with `@` by name in any later prompt. This is how Preview keeps consistency across a project. Project library You'll also run into the library from inside reference pickers elsewhere in the app: choosing a Start or End Frame in the prompt box, for example, offers **Choose from Library** alongside Click to Pick and Upload from Device. ## Library categories Each category lives in its own panel on the left sidebar. Click its icon to switch: A reusable person or creature A reusable object A reusable environment Uploads and other files not tied to a category
Library sidebar with panel-switcher icons
## Save to the library Right-click an image on canvas, use its three-dot menu, or open the Characters, Props, or Locations panel and create a new entry. Pick Character, Prop, or Location, then assign the image to an existing entry or create one with a name and description. Upload extra angles into the entry. More views usually improve later consistency.
Add to library dialog
## Characters A reusable person or creature you'll generate repeatedly. Saving one keeps their appearance consistent across every shot and sequence they show up in, and makes them referenceable by name anywhere in the project. A Character can also carry a **voice recording**: attach one and video generation uses it, so the character sounds the same across shots, not just looks the same. Use clear, single-character images on a blank or white background. Background elements can bleed into later outputs. Multi-angle sources usually give more consistent results than one narrow view. ## Locations A reusable environment or set. Saving one lets you return to the same place across multiple shots without re-describing it every time, and to generate new angles of it later. Save environment-first images with no characters, people, or creatures in frame. Include only elements you want to influence future generations. For important sets, save a range of views: wide establishing shots and specific angles both aid continuity. ## Props A reusable object (a weapon, vehicle, or piece of set dressing) that needs to look the same wherever it appears. Save the object isolated on a blank or white background. Background elements can bleed into later generations. Use several clean sources for important props so you can reference different angles later without inventing them. ## Variations Give a Character, Location, or Prop multiple looks (a different outfit, time of day, or state) without a separate library entry for each. Every entry starts with one default variation; add more as needed. * **Add a variation**: click **New variation** from the entry's sidebar panel or library page, or create one from the **Add to...** dialog when saving a canvas file. * **Add images to a variation**: each keeps its own image set. Use its **Add asset** control, or drag an image onto another variation to move it there. * **Rename or delete a variation**: from its **⋯** menu; the default variation can't be deleted. * **Reference a variation**: type `@` and pick the entry; with more than one variation, you'll choose which before picking images. Reserve variations for meaningful visual differences; add extra angles of the same look to a variation's existing set instead.
Library variations
## Importing files Bring anything from your computer, or from outside Preview, into the project: reference images, footage, or other material you want to use for any purpose, without needing a full library entry first. Import files by: * Dragging images from your desktop onto the canvas * Right-clicking the canvas and choosing an upload option * The **+** button in the canvas toolbar's bottom-left * Uploading into the **Uploads** panel from the sidebar * Uploading directly from the prompt box or from Preview Agent * Adding from Production via a shot's upload or library options Uploaded files join project history: drag them onto canvas, attach as prompt references, or reuse later by name. # Prompt Box Source: https://docs.preview.io/preview/prompt-box-overview Generate images and videos with your favorite models, using references and saved files, in the prompt box. Can't find the prompt box? It's hidden whenever [Preview Agent](/preview/agent)'s chat panel is open, since the two can't be open at the same time. Close the agent to bring it back. ## Generate Writing a prompt with a reference chip in the prompt box Write a prompt in the prompt box at the bottom of the canvas, then set: * Model * Resolution and aspect ratio * Duration and audio on/off (video) * Internet on/off * Seed * Number of outputs Hover the generate button to check credit cost before running a job. See [Project Analytics](/preview/project-analytics). ### Reading the model menu * The grey chips show each model's resolution range, plus a duration range for video models. * Video models show more settings that affect generation cost, so choose carefully. * Some models let you set Start and End Frame independently; others require a Start Frame before you can add an End Frame. Prompt box model menu ### Negative Prompt If supported, access Negative Prompt from the icon at the prompt box's lower right. ### Audio If supported, toggle Audio from the speaker icon at the prompt box's bottom right. ### Start and end frames (video) Set a start or end frame four ways: Click to Pick on the canvas, Choose from Library, Upload from Device, or the target icon on a canvas file. Start and end frame slots ## Add references Type `@` to open the reference menu: Recently used, Gen History, Uploads, and your library by category (Characters, Locations, Props, including specific variations). Pick something and it appears in the prompt box as a chip. See [Referencing with @](/preview/at-references) for the full menu. Each model has its own reference limit, shown beside the ref box in the prompt box's top bar. Some video models also accept video references, sourced the same way. Location references are interpreted literally; for a specific angle, generate that angle first and reference the new image. ## Next steps * [Quick styles and Camera Bag](/preview/quick-styles) for reusable visual treatments. * [Sequence Timeline](/preview/scene-timeline) to turn files into structured shots. * [File Toolbar](/preview/file-toolbar) for what you can do with a file on canvas. # Credits Source: https://docs.preview.io/preview/purchase-credits How credits work in Preview, and how to buy more. Preview runs on credits, not subscriptions: pay for what you generate, nothing more. 100 credits = \$1, and cost varies by model, resolution, duration, and output count. ## Check the cost before you generate Every generation shows its price up front: * **Prompt box**: hover the generate button for the credit cost of your current setup. It updates live as you change model, resolution, duration, or output count. * **Model picker**: every model in the list shows a credit chip with its typical cost or range, so you can compare before choosing. * **[Preview Agent](/preview/agent)**: in Ask mode (the default), every generation pauses in chat with its credit cost shown before it runs. * **[Upscaling](/preview/upscaling)**: each provider's panel shows the cost on its generate button, updating as you adjust settings. See [Project Analytics](/preview/project-analytics) for tracking what your team has spent across a project. ## Buy credits Hover the Analytics button in the sidebar's lower-left to see remaining credits and a Purchase Credits button. Click **Purchase Credits**. Click **Checkout** to reach a Stripe payment window with a choice of payment methods. Add Credits and Stripe checkout Also reach the Add credit window via **Billing** on your organization's home page. # Quick Actions Source: https://docs.preview.io/preview/quick-actions One-click tools to help you ideate fast and create with consistency in Preview. Quick Actions package a proven prompt and settings behind a single click, so you can explore ideas or repeat a common task without writing and tuning a prompt yourself. ## How to access Quick Actions Select a file on canvas and click **Tools** on its toolbar to open Quick Actions. Quick Actions menu ## What you can do in the Quick Actions menu Hover any Quick Action button for a description of what it does. Some Quick Actions return a single image; others create larger output sets, like a 9-image grid. ## Character sheets **Character creation** turns an image with a clear character into an 11-panel character sheet (faces, full body, profiles, expressions) via Nano Banana, a strong reference for consistent results elsewhere in Preview. Results vary; generate a few and pick your favorite. ## Upscaling Upscale a file from the same menu: **Topaz Upscale**, **Topaz Astra** (video), and **Magnific Upscale** each open a settings panel with live credit cost. See [Upscaling](/preview/upscaling) for the full model and control breakdown. ## More ways to ideate Quick Actions also cover several tools for generating story and shot ideas fast: * **Sequence coverage**: varied camera angles and shot sizes for a sequence. * **Story beats**: new narrative directions in new settings. * **B-roll coverage**: 9 supporting shots of the environment. * **Dialogue coverage**: masters, two-shots, over-the-shoulders, and close-ups for a conversation. * **Production design**: a grid of location variations with different props, dressing, and materials. **Character action**, **Time jump**, and **Sequence jump** round out the set; hover any of them for what they do. Plus [Generate world](/preview/generate-world): turn a reference image into an explorable world and capture new angles from it. ## Use Quick Actions intentionally Quick Actions work best when: * Exploring many directions quickly * Wanting a repeatable shortcut for a common task Continue to [Generate World](/preview/generate-world) for one of the most distinctive Quick Action workflows. # Quick Styles & Camera Bag Source: https://docs.preview.io/preview/quick-styles Apply reusable visual styles from the prompt box (quick presets or a detailed camera/film-stock combination) to speed up generation and keep results consistent. Both apply a saved visual treatment without rebuilding your styling instructions every prompt, which is useful for moving fast while keeping results consistent. Both require the Nano Banana Pro model; their controls won't appear in the prompt box with a different model selected. Only one can be active at a time: with one active, the other's panel is blocked until you remove it. ## When to use them Use either to repeat a look across files, speed up ideation, or keep a sequence coherent while testing prompt variations. ## Quick Styles A style selector in the prompt box: pick a saved style and it applies directly, no further setup. Quick Styles selector ## Camera Bag Combines Camera/Film Stock, Lens, aperture, and focal length into a custom look; each combination is distinct. Camera Bag panel ### Save camera presets Save a combination from the **Save** button at the top right of Camera Bag's **Custom** tab; saved setups appear under the **Saved** tab. Use saved presets when: * A project needs a consistent look * Testing subjects without changing the visual language * Multiple collaborators need to generate in the same style Save a preset as soon as you find a useful look; it's easier to maintain continuity than remembering the setup manually. ## How they fit into prompting Both work alongside your prompt text and references, not in place of them: prompt for subject and action, references for identity or composition, Quick Styles or Camera Bag for repeatable visual language. Camera Bag and Quick Styles can't be used at the same time. With one active, the other's panel is blocked until you click **Remove quick styles** or **Remove camera bag** inside it. # Sequence Timeline Source: https://docs.preview.io/preview/scene-timeline Use the sequence timeline to create sequences, assign files to shots, and organize your project's visual flow. Part of the canvas (see [Studio](/preview/canvas-overview)), the sequence timeline is your project's shot list, shown across the top: each sequence is a row of ordered shots. Assign a file to a shot and it appears in that row at once, turning canvas work into project structure. Sequence timeline Click the small handle at the top of the canvas (**Collapse timeline** / **Expand timeline**) to close or reopen the timeline, or drag it to resize how much space the timeline takes. ## When to use it Use the timeline for fast, in-canvas structuring: ordering shots and assigning files as you generate. Move to [Production](/preview/shotlists-overview) for metadata, status tracking, or bulk planning. ## Shotlists A project can hold multiple Shotlists: each a complete, independent set of sequences and shots. The timeline always shows whichever one is active, and so does [Production](/preview/shotlists-overview); switching one switches the other. * **Switch**: open the dropdown next to your project name, beside it on canvas or in any Production view. Same picker either way. * **Create**: click **New** in the popover. Starts with one empty sequence and one empty shot, same as a brand-new project. * **Duplicate**: from a Shotlist's **⋯** menu. Copies the sequences, shots, and their assigned takes. (Duplicating a single sequence, below, copies structure only.) * **Rename** or **Delete**: same **⋯** menu. Delete is disabled once you're down to your last Shotlist. Shotlist dropdown picker Every new project starts with one Shotlist. New ones are named sequentially: Shotlist A, Shotlist B, and so on. ## Add a sequence or shot * **Add a sequence**: click **New sequence** at the end of the timeline; this also creates its empty first shot. * **Add a shot to an existing sequence**: click the **+** at the end of that sequence's bar, then choose **Add shot** or **Add multiple shots**. ## Assign files to shots from the canvas The timeline needn't be open to assign a file: every canvas file has a **Select for** control floating above it. * Check the box on the file to assign or unassign it from the active shot. * Open **Select for** to search any project sequence; choose one to see its shots, then a shot to assign the file to. * Choose **New sequence** from that dropdown to create one with an empty first shot, then pick that shot to assign the file. * After choosing a sequence, choose **New shot** at the bottom of its shot list to create and assign one. This is the fastest way to build out shots without scrolling the timeline for the right sequence. Select for control ## Reorder and remove * **Reorder shots**: drag a shot to a new position in its sequence. * **Remove a take from its shot**: right-click the shot (or, with multiple takes, one in its hover popover) and choose **Remove Take**. The take stays on canvas, just unassigned. * **Delete a shot**: right-click it and choose **Delete Shot**. Takes become unassigned, not deleted; only the shot leaves the sequence. * **Open Shot Info**: hover the shot, click the **Info** icon in its takes popover, for a sidebar with Details, References, and Takes tabs. * **Find on canvas**: right-click a shot (or a take in its popover) and choose **Find on canvas** to jump straight to that file, switching canvas or sequence if needed. Double-clicking a take in the popover does the same. Shots can't be dragged between sequences. Instead, assign a shot's takes to a shot in the new sequence via Select for. ## Manage a sequence Right-click a sequence title to open sequence actions: * Expand / Collapse * Duplicate * Export sequence * View details (also where you rename the sequence) * Copy link * Collapse all / Expand all * Delete sequence ### Duplicate Keeps the shot count but not existing media. The new sequence starts with empty shots. ### Export The same export as the [Project menu](/preview/settings-menu)'s **Export shotlist**, scoped to just this sequence: a ZIP with this sequence's media and an FCPXML timeline for Final Cut Pro or DaVinci Resolve, with the same Alternates, Audio, Burn-in review video, and Frame rate settings. ## Next: manage this structure in more detail Continue to [Production](/preview/shotlists-overview) for metadata, status tracking, and bulk planning across the same sequences and shots. # Scripts Source: https://docs.preview.io/preview/scripts Write, import, and develop your project's screenplay in Script view, with your library and Preview Agent built in. Every project can hold multiple Scripts: block-based screenplays that live in the **Scripts** panel of the left sidebar. Click a script to preview it in the panel; double-click to open the full editor over the workspace. The Script editor: scene and dialogue blocks with library chips, the block add menu open, and the scene list ## Manage scripts * **Create**: click **New script** at the top of the panel. New scripts start as "Untitled script". * **Rename, Copy link, or Delete** from a script's row menu; search the list from the panel header. * **Switch scripts** without leaving the editor, from the script switcher in its header. ## Write with blocks A script is a stack of five block types: **Text**, **Scene**, **Dialogue**, **Parenthetical**, and **Transition**. * **Add a block**: type `/` on an empty line, or click the **Add block** button on a block's rail (Option-click adds it above instead of below). * **Reorder or convert**: drag a block's grip handle to move it; its menu also has **Turn into...**, **Duplicate**, **Copy link**, and **Delete**. * **Scene blocks** carry the slug line, with **INT.** / **EXT.** presets; **Transition blocks** offer the standard set (CUT TO:, FADE IN:, DISSOLVE TO:, and so on) plus any custom transitions you've typed before. * **Tab** keeps you in the flow: it moves through a block's parts and on to the next line, and on an empty line it starts a Dialogue for you. * **Format** selected text with Bold, Italic, Underline, and Strikethrough. The thin rail on the far left is the **scene outline**: one tick per scene, sized to its length. Hover it for the scene list, click a scene to jump straight there. ## Reference your library with @ Anything saved to your [Project Library](/preview/project-library) can be pulled into the script with `@`: Characters, Locations, and Props. A Dialogue block's character slot picks up Characters; a Scene block's slug line takes Locations. Chips point at the same library items the rest of the app uses, so the script and your canvas stay in sync. Name someone who isn't in the library yet and the **Unidentified elements** popover offers to **Create** them as a library item on the spot. ## Import a script Imports run through [Preview Agent](/preview/agent): attach a `.fountain`, `.fdx`, or `.txt` file in the chat and ask it to import. The agent and Script view format the result to match your original: scenes, dialogue, parentheticals, and transitions all land as proper blocks, and the script is named from its title page or filename. ## Script AI Select any text and the toolbar comes with AI built in: * **Enhance**, **Elaborate**, or **Continue** the selection with one click. * **Enter changes...**: describe the edit you want, or dictate it with the mic. * **Send to agent**: hand the selection and your prompt to the main chat instead. * Reach the same tools from any block's menu via **Ask AI**. Proposed edits appear in place for review: **Accept** (⌘Enter), **Discard**, or **Try again**, with a follow-up field to refine further. When the agent edits a script from chat, its changes stream in at a visible caret and collect in a **Suggested changes** bar, where you step through them one at a time or **Accept all** / **Reject all**. On an empty script, a first draft applies immediately with nothing to review. ## Scripts and the rest of your project Scripts don't link directly to sequences, shots, or generation — the bridge is [Preview Agent](/preview/agent), which has your script and the whole platform in the same conversation. Ask it to build a shot list from the script, storyboard a scene, break down what a sequence needs, or ideate new directions from what you've written. Your open script is automatically part of the agent's context, so "board out scene 3" just works. # Project menu Source: https://docs.preview.io/preview/settings-menu Open the project menu from the hamburger icon at the top of the left sidebar.
Project menu
## What's in the menu * **Back to projects**: back to your projects list. * **Project**: **Rename**, **Export** (covered below), **Settings**, and **Delete**. * **Workspace**: **Usage analytics**, your organization's usage view. See [Project Analytics](/preview/project-analytics). * **Help**: **Documentation** (these docs) and **Keyboard shortcuts**. * **Preferences**: toggle the **Minimap**. ## Export Export turns your shot list into a real editing timeline. It takes the take currently showing on each shot, across every sequence, and produces a ZIP: all the media, organized into a bin per sequence, plus an FCPXML timeline that Premiere Pro, DaVinci Resolve, and Final Cut Pro all understand. Import the XML and your shot list rebuilds itself in the editor: one video track laid out in shot order, every image and video in place, and trims carried over. A video trimmed in Preview arrives trimmed on the timeline. Alternates come in two flavors: * **Selected takes**: just what's visible in the shot list. One clean track, your current cut. * **Stacked tracks**: every other take saved inside each shot rides along too, stacked on higher video tracks and aligned to its shot's position. Those tracks are disabled by default, so playback stays your main cut with the alternates one click away. The export dialog also has settings for audio stems, a burn-in review video, and frame rate. Exports every sequence in the active Shotlist. For a single sequence, use **Export sequence** from that sequence's right-click menu. See [Sequence Timeline](/preview/scene-timeline). ## Delete project Deletes the project and everything in it: every Shotlist, sequence, shot, and file. Requires typing the project's exact name to confirm. # Sharing Source: https://docs.preview.io/preview/sharing Invite collaborators to a project or share a review link with outside clients. Share a project two ways: invite someone directly as a collaborator, or send a review link to people who don't need a Preview account at all. Both open from the **Share** button in the app's upper-right corner. Share menu ## Collaborator invites Add someone to the project by email. They'll need a Preview account, and they join with edit access; once they've joined, change their role to **Can comment** or **Can view** from the dropdown next to their name. This is for people doing actual work in the project with you. ## Review link A review link is for everyone else: clients, stakeholders, or anyone outside your team who just needs to see the work and weigh in. There's nothing for them to set up. No account, no login, no editing access to worry about. In the Share popover, scroll to the Review link section below your collaborator list. Click **Create link**. It turns into **Copy link** once the link is live. Toggle **Password** and set one if the project is sensitive. Turn the link off entirely from the permission dropdown beside it (shows **Can comment**), then choose **Turn off review link**. Anyone with the link can: * Browse the project in List, Grid, or Gallery view * Inspect files * Leave comments on shots and sequences External review link, Gallery view Use collaborator invites for people doing real work in the project. Use a review link for people who just need to look and comment. # Production Source: https://docs.preview.io/preview/shotlists-overview Manage sequences, shots, assignments, and metadata in Production: Shotlist, Storyboard, and Kanban views, plus filters. ## What Production is for The same sequences and shots you build in the [Sequence Timeline](/preview/scene-timeline), in a dedicated management view. Select **Production** near the top of the app to leave the canvas for the operational side of your project: assignments, status, metadata. Double-click any file to jump back to it on the canvas. Production has three synced views, switched from the icon tabs at the top (a change in one shows in the others), plus filters that apply across all. A project can have multiple Shotlists, each with its own sequences. These views show whichever is active; switch or manage them from [Sequence Timeline](/preview/scene-timeline). ## Storyboard View Options hide/show metadata and switch grid/row layouts. Each shot's three-dot menu: * **Open**: opens File view. * **Copy** and **Paste**. * **Duplicate**. * **Multi-Select**: opens a bottom toolbar for bulk actions (move, status, assignee, delete) across shots from any sequence. * **Move to...** * **Remove Take** and **Delete Shot**. Each shot tile also has: * **A drag handle** on the tile's image: drag it to reorder the shot within its sequence. * **File-cycling arrows** at the bottom of the tile: click them to step through the alternate files assigned to that shot. Storyboard view ## Shotlist view Structured-table view for detailed metadata edits. * **Show/hide columns** from View Options. * **Add a reference image** via the **+** in the references column, then call it with `@` in the canvas prompt box. * **Reorder sequences** from the Reorder sequences icon on the sequence bar: opens a dialog to drag-reorder and rename sequences inline. * **Add sequences or shots** from the **+** icons at the bottom-right or on a sequence column. Shotlist view ## Kanban Track production progress at a glance: group by status to see what's queued, in progress, and complete, and drag a shot into the next column as it moves through your pipeline. * **Drag shots between columns** to change their value for the field the category selector (upper right) groups by. * **Collapse a column** via the caret in its header. * **Switch categories**: group by status, priority, assignee, scene, character, or location, from the category selector. Kanban view ## Filters Click the filter icon to narrow any Production view by sequence, status, assignee, location, or other project metadata. Filter before bulk-editing metadata: it's easier to find and update the right shots in an already-narrowed view. # Tags Source: https://docs.preview.io/preview/tags Color-tag files on canvas and in Files view to keep large projects organized. Color-tag any file, on canvas or in [Files view](/preview/canvas-overview#files-view), to organize a project at a glance. Up to 10 tags per project, project-wide rather than per file. ## Add a tag * **Canvas**: click the Add Tag circle in a file's top-right corner, or open its three-dot menu → Tag, then click a tag to add it. Adding a tag to a file on canvas * **Files view**: the same colored dots appear in a tile's top-left corner; click one to add a tag the same way. Adding a tag to a file in Files view ## Edit a tag Click a tag's three-dot menu to rename, recolor, or delete it.
Tag menu with Edit and Delete Editing a tag's name and color
## Manage all tags Click **Manage tags** in the Tag menu for Tag Management under [Project menu](/preview/settings-menu) → Settings → Tags: drag to reorder, rename, recolor, delete, or reset to defaults. You can also create a tag on the spot by typing a name into the picker's **Search or create tags...** field. Tag management in Project settings # Upscaling Source: https://docs.preview.io/preview/upscaling Upscale an image or video with Topaz or Magnific from the take toolbar. Upscaling lives in Quick Actions on any file's toolbar, with three providers, each with its own settings panel and live credit cost. Topaz Upscale in the Quick Actions menu ## Providers * **Topaz Upscale**: the general-purpose choice for both images and video: 10 models (Standard V2, Redefine, Recovery, Recovery V2, Wonder, Text Refine, and others), 2× or 4× scale, optional face enhancement. Good default when you just need a cleaner, higher-resolution version of a file. * **Topaz Astra**: Topaz's dedicated video-upscale model, built for the highest-fidelity video results Topaz offers. It only appears when a video is selected. * **Magnific Upscale**: image and video, with Creativity, HDR, Resemblance, and Fractality controls for a more stylized, reimagined result than Topaz. Good when you want the upscale to add detail and character, not just resolution. A separate **Skin enhancer** action (Creative, Faithful, or Flexible mode) sits alongside it for portrait retouching, images only. ## Upscale a file Select a file on canvas and click **Tools** on its toolbar. Pick **Topaz Upscale**, **Magnific Upscale**, or (for videos) **Topaz Astra** from the menu. Adjust model, scale, and provider-specific controls; the panel updates output dimensions and credit cost live. Click **Upscale**. The result is added to canvas like any other generation. ## Topaz advanced settings Beyond model, scale, and face enhancement, Topaz exposes Creativity, Texture, and Detail sliders (model-dependent), an optional prompt field, Sharpen, Denoise, Fix compression, Subject detection (All, Foreground, Background), and output format (JPEG or PNG).