Docs menu
On this page

Image Upload

The Image Upload node holds pictures you upload or pick from your Media Library, and sends all of them into your workflow. It only takes pictures. For videos and audio there are the Video Upload and Audio Upload nodes.

Inputs and outputs

  • No inputs. Image Upload is a source, so it can start a workflow on its own.
  • Images (output): every picture the node holds.

Adding pictures

  • Click the card or Add images to open the side panel. Under Upload, click the field to pick pictures from your computer, or drop them on it. Under Import from Media, click Import to pick them from your Media Library. You can also drop pictures onto the card.
  • Add as many as you like. The card shows the first one, with a badge that counts them ("5 images").
  • Below those, the side panel lists each picture with its name and a Remove button.
  • The node takes PNG, JPG, WebP and AVIF pictures up to 20 MB each. Any other file is named under the card and not added, for example: "clip.mp4" can't be added. This node takes PNG, JPG, WebP, AVIF images.
  • Pictures you upload are saved to your Media Library too.

Uploading

  • While pictures upload, the card shows how far along they are ("Uploading 42%", then "Finishing…"), or how many are on the way ("3 files uploading").
  • A picture that doesn't upload stays on the card in red, marked "Didn't upload", and is never sent to a run. Open the list to see why, remove it, and add it again.
  • Run waits for uploads: while a picture is still uploading, you're asked to wait for it to finish.

Where it connects

Image Upload connects to inputs that read pictures, such as Video Generation's Start Frame or Image Generation's Image ref, and to a Sequence, a Router or an Output.

Every picture goes out on every run, so the node only connects where none would be lost:

  • An input that takes one picture, like Start Frame, connects only while the node holds one picture. With more, the wire won't connect, and a note next to your pointer says why: "Start Frame takes one picture, but Image Upload holds 3."
  • Once it's wired to such an input, the node takes one picture. The note "Connected to Start Frame, which takes one picture." shows under the card, and the Upload field and the Import button in the side panel turn off once it holds one.

Tips

  • Keep only the pictures you want the run to use in the node.
  • To send different pictures to different places, connect the node to a Router.
PreviousMedia LibraryNextVideo Upload