Work Items

Everything you generate in 1stUnit belongs to a work item. A work item is one piece of the production: a shot in a scene, a base design for a character, a costume variant, or a concept image for an entire scene. Each work item has its own card on the pipeline board, its own folder on disk, and its own status that tracks where it is in your workflow.

There are four kinds of work items, called work types. Picking the right type matters because each one has its own card label, its own folder location, and shows up in the sidebar in a different way.

Type What it represents Card title Folder location
Shot A single shot in a scene. The thing that ends up in your edit. S001 / Shot 001 — Canyon Approach Scenes/Scene 001/Shot 001/
Scene prototype A concept or reference image for an entire scene. Optional but useful for setting a look. A scene can have several variations. S001 / Prototype — Fight Alley
S001 / Prototype 002 — Night Market
Scenes/Scene 001/Prototype/
Scenes/Scene 001/Prototype 002/
Character prototype The base design of a character. Generated once, then reused as a reference for that character. Hank / Prototype Characters/Hank/Prototype/
Outfit A costume variant for a character. One character can have many outfits. Hank / Outfit 001 — Hiking Gears Characters/Hank/Outfit 001/

Every card title includes the name you give the item (for example "Canyon Approach" or "Hiking Gears"), except for character prototypes, whose title is the character's name. Folder names use only the type and number, never the name. This means you can rename an item later without breaking any file references.

The first variation of a scene prototype uses the Prototype folder. Each further variation gets its own folder (Prototype 002, Prototype 003, and so on), so their files never mix.

Click + Add item in the top bar of the pipeline board. A form opens. Pick a work type with the buttons at the top. A line under the buttons explains what that type is for, and the fields adapt to the type you chose:

  • Shot. Scene # and Shot #, a shot name or slug line, shot size, camera movement, and a description.
  • Scene prototype. Scene # and Variation #, a scene name, and a description.
  • Char prototype. The character's name and a description.
  • Outfit. The character's name, Outfit #, an outfit name, and a description.

The name fields and the description are optional.

The Add work item form for a shot: Scene 5, Shot 3 with the hint Next available number in this scene, the name Garden Gate, shot size, description, and a preview of the card, sidebar entry, and output folder.

Numbers

Scene #, Shot #, Variation #, and Outfit # have up and down arrows, so you can step through numbers or type one. Shot #, Variation #, and Outfit # start with the next free number: the next shot in that scene, or the next outfit for that character. You can change it to any number from 1 to 999 that is not taken yet, for example to follow your script's numbering. If you pick a number that already exists, the form tells you and suggests the next free one. When you change Scene # or the character, the form fills in the next free number for that scene or character.

After you add a shot, the next time you open the form it starts on the same Scene #, with a green note saying it was remembered from the last shot. This makes it quick to enter a scene's shots one after another. The form forgets the scene when you close the project.

Character names

The character name is required for character prototypes and outfits. Capital letters do not matter: if Hank already exists, typing "hank" for a new outfit adds it to Hank, with Hank's spelling. The Outfit form suggests the characters you already have. Because the name becomes part of a folder name, it cannot contain any of these characters: \ / : * ? " < > |.

Each character can have only one character prototype. If you try to add a second one, the form explains that the character already exists and suggests adding an outfit instead. A character that so far only has outfits can still get its prototype.

The preview

At the bottom of the form, "What it looks like on the board" shows the card exactly as it will appear on the pipeline board, the sidebar entry it will add or join, and the folder its generated files will go to.

A line under the number fields reminds you that the numbers (and the character name) are part of the folder name, so they cannot be changed after the item is added. Click Add item to save. The card appears in the Asset Prep column. From there, click it to open the shot workspace and start generating.

You can reuse work items from another project, for example a character and its outfits, or a scene prototype. Click Add from another project… at the bottom left of the Add work item form.

The first step is choosing what to bring:

  • Source project. Pick the project to copy from. It starts on the project you opened most recently. Archived projects are hidden unless you tick Include archived projects.
  • Filter and search. Show all items, or only characters, scenes, or shots, and search by name.
  • Pick items. Tick the items you want, or tick a character or scene to take everything in it.
  • Pick files. Click an item to see its files on the right. Untick any file you do not want to bring along. Rejected files start unticked.
Add from another project: a source project is selected, Hank / Outfit 001 and a scene prototype are ticked on the left, and the outfit's five files are previewed on the right.

Click Next: placement. For each item, check the character name or scene number it will have in this project, and its name. Numbers are given the next free number automatically, and the output folder for new runs is shown under each item. Then click Add.

The placement step: Hank / Outfit 001 becomes Hank / Outfit 003 and the Motorcycle scene prototype keeps Scene 1, each with its output folder.

What gets copied, and what does not:

  • Files are linked, never copied. They stay where they are, exactly like the workspace's Import button. Nothing is moved or renamed.
  • Which files are offered. Files that were imported or added to the item, and takes that were exported. Takes that were never exported still live in their Temp folder and are not offered.
  • What stays behind. Prompts, runs, and the history of takes stay in the source project.
  • Where they land. Items that bring files arrive in the Delivered column. Items without files start in Asset Prep.

Open the work item, then click Edit in the top bar of the shot workspace. You can change the description, the name, the shot size, the duration, and the camera movement. The scene and item numbers, the character name, and the folder are shown but cannot be changed: they define where the item lives in the folder structure.

The Delete button only appears when a work item has no runs and no artifacts attached. Once any content exists, the item is permanent. This is to protect the lineage of every artifact you produced from it: deleting the work item later would orphan results that may still be referenced by other shots.

If you want to retire a shot that has runs, leave it in place. Rejected and exported takes can sit on it indefinitely without affecting anything else.

Work types are not just labels. They determine how 1stUnit groups items in the sidebar and how it handles their references:

  • Scenes are derived from the scene numbers on your shots. You do not need a scene prototype for a scene to appear in the sidebar. The sidebar simply lists every distinct scene number across your shots.
  • Characters are derived from the character names on character prototypes and outfits. A character appears in the sidebar as soon as you create its prototype or its first outfit.
  • Outfits belong to a character through the character name field. Clicking the character in the sidebar shows its outfits too.
  • Shots belong to a character when their generation referenced that character's artifacts. A shot that has never been generated will not appear under any character filter yet. It will start showing up once you do a run that uses a character or outfit artifact as input.

If you already have reference images or footage you want to bring in, you can attach them to any work item. Open the work item and click Import, next to + New run, to pick images or videos from disk. Imported files are linked where they are: 1stUnit records their location and never copies, moves, or renames them, so keep them in place. They count as accepted, and the work item moves to the Delivered column. The Reviewing candidates page explains the verdict and export flow in more detail.