Asset Manager
Manage your project's characters, locations, props, and inspiration assets, and generate AI reference images for them.
Overview
The Asset Manager is the central hub for all visual elements in your production. Assets are the building blocks used across your project — characters appear in shots, locations set the scene, and props add detail. The Asset Manager lets you view, create, edit, and generate reference images for them.
Key Concepts
- Asset: A named visual element in your project (character, location, prop, or inspiration)
- Asset Types: Characters (cast members), Locations, Props, Costumes, Inspiration, Extras, Set Dressing, Makeup & Hair, Vehicles, Livestock, and Greenery
- Image Editor: A dedicated editor for viewing, uploading, and managing an asset's images
- Provenance Graph: A visual graph showing how an asset's images were generated and their relationships
- Breakdown: Your connected agent parses your screenplay and extracts all supported asset types — see Connect Your Agent
When to Use the Asset Manager
The Asset Manager is where you:
- Review all project assets in a sortable table with media, assignment, and budget status
- Add assets manually that aren't in the screenplay
- Edit asset details (name, description, type)
- Generate reference images for an asset
- Open the Image Editor to manage an asset's images
- Delete assets you no longer need
Accessing the Asset Manager
- Open your project to land on the Project Hub
- Open the Assets section — from the Project Sections list, or from the section-name dropdown in the breadcrumb at the top of any project page
The Asset Manager opens with the heading Asset Manager.
Populating Your Assets
Assets can come from two sources:
Automatic: Screenplay Breakdown
The primary way to populate assets is to have your connected agent break down your screenplay:
- Make sure your screenplay is saved in the Screenplay tab
- Connect Your Agent if you haven't already, then ask it to break down the screenplay
- Your agent parses the screenplay scene by scene and extracts assets across all supported types — cast members, locations, extras, props, costumes, set dressing, makeup & hair, vehicles, livestock, and greenery. See the Screenplay guide for the full breakdown details.
- Assets appear in the Asset Manager
Manual: Add Asset
To add an asset that isn't in your screenplay:
- Click the Add Asset button in the Asset Manager header
- Select the asset type from the dropdown menu:
- Cast Member — characters in your production
- Location — settings and environments
- Prop — objects and items
- Costume — wardrobe and clothing
- Inspiration — reference images and mood boards
- Extra — background characters
- Set Dressing — furniture and decor
- Makeup & Hair — looks and styling
- Vehicle — cars, ships, etc.
- Livestock — animals
- Greenery — plants and foliage
- Fill in the asset details:
- Name (required)
- Description (optional but recommended for image generation)
- Location Type (for location assets only)
- Click Create
Understanding the Interface
Header Actions
The Asset Manager header provides these actions:
| Button | Description |
|---|---|
| Add Asset | Opens a menu to create a new asset of any type |
Asset Table
Assets are displayed in a unified table that combines media status, assignments, and budget. The columns are:
| Column | Description |
|---|---|
| Image | Thumbnail preview of the asset's selected image (or a placeholder) |
| Name | The asset's display name, with a short description snippet beneath it |
| Type | Asset category shown as a chip (Cast, Location, Props, Inspiration, and so on) |
| Assignee | The team member assigned to the asset |
| Status | The asset's workflow status (for example, Not Started) |
| Media | A count of the asset's media by state (for example, "4 ✓ 1 ✗ 1 pending") |
| Budget | Spending against the asset's budget (for example, "$0.25 / ∞" — the ∞ symbol means no budget limit is set) |
| Actions | Row actions (see below) |
Sorting
Click a sortable column header to sort the table. Click again to reverse the sort order. Use the pagination controls at the bottom of the table to page through long asset lists; the Rows per page control defaults to 25.
Asset Actions
Open in Image Editor
Click any asset row to open it in the Image Editor. The Image Editor lets you:
- View all images associated with the asset
- Upload new reference images
- Generate new images with AI
- Select the primary image for the asset
Edit Asset
Click the Edit Asset action (pencil icon) to change the asset's details, such as its name, description, and type.
View Provenance Graph
Click the View Provenance Graph action to see a visual graph of how the asset's images were generated, including which models and prompts were used.
Comments
Click the Comments action to view and add comments on the asset — a place for your team to discuss it in context.
Delete Asset
- Click the Delete Asset action (trash icon) on the asset row
- Confirm the deletion in the dialog
Generating Reference Images
Reference images are generated per asset, in the Image Editor — open an asset and generate or upload its image there. You can also ask your connected agent to generate images for your cast, locations, and props; it shows an estimated cost and asks for confirmation before spending.
Empty State
When no assets exist yet, the table displays a helpful message pointing you to ask your connected agent to break down the screenplay, which extracts assets automatically.
Real-Time Updates
The Asset Manager updates automatically when:
- Screenplay sync creates or updates assets (a progress bar is shown)
- Image generation finishes for a specific asset (from the Image Editor or your agent)
You don't need to refresh the page — the table updates automatically.
Tips and Best Practices
- Break down your screenplay first before generating images — you need assets before you can generate images
- Add descriptions to your assets — image generation uses descriptions to produce better reference images
- Check the Image Editor for assets with multiple image variations to pick the best one
Common Questions
How do I get assets into the Asset Manager?
Ask your connected agent to break down your screenplay — see Connect Your Agent. This parses your screenplay scene by scene and extracts all supported asset types automatically — cast members, locations, extras, props, costumes, and more.
Can I manually upload reference images?
Yes. Click on any asset to open the Image Editor, where you can upload images from your computer.
How do I change an asset's type?
Open the asset in the Image Editor where you can modify its details including the asset type.
Next Steps
- Screenplay - Write and edit your screenplay, then ask your agent to extract assets
- Image Editor - Edit individual asset images
- Storyboard - See your assets in action across shots
- Keyframe Editor - Compose shots using your asset images as layers
