Media Library

The Media Library node holds a set of your own uploaded or imported media (images, videos, or audio) and feeds it into your workflow as a source.

This page covers the node as it appears on the canvas. Your account-wide media library, where all your files live, is covered separately.

Inputs and outputs

• No inputs, Media Library is a source-only node and cannot receive a connection from anything else.
• Media (output): the single output handle that feeds the rest of your workflow.

On-card preview

• Images and videos tile inside a 9:16 frame: one item fills it, two stack top and bottom, and three or more tile in a grid with a "+N" badge for anything beyond four.
• Audio items appear as small cards below the visual frame, showing track art and name, also capped at four visible with a "+N" badge.

Settings

Click the card or "Add media" to open the panel:

• Upload media: opens a file picker that accepts images, videos, and audio, and lets you select multiple files at once. Once the node is connected, it only takes the files those connections can use (see below).
• Add from: pull items in from your account-wide Library without re-uploading, or import from Google Drive or Dropbox (both show whether they're connected).
• Each item in the list shows a thumbnail, an editable name, its type, and a Remove button.

Uploading

• Uploaded files are saved to your account-wide Media Library and added to the node. Videos can be up to 1 GB, images up to 20 MB, and audio up to 50 MB. A file over the limit, or in a format the library doesn't take, is named in the panel and not added.
• Files upload three at a time. Each one shows its progress ("Uploading 42%"), then "Finishing…" while it's saved. If you add a lot of files at once and hit the upload limit, a file shows "Waiting" and carries on by itself a minute later.
• You can keep working while files upload, even close the panel or open another node.
• A file that doesn't upload stays in the node in red, marked "Didn't upload", with the reason in the panel (for example "The connection dropped."). It's never sent to a run. Remove it and add it again.
• If you copy and paste the node while a file is uploading, the copy gets the file too once it's done.
• Leaving the editor while files are uploading asks first. If you move to another page in the app, they finish and go to your Media Library, but not into the node. Closing the tab or leaving the site stops them.
• Trim override (video items only): a per-item toggle that reveals a start/end timeline so you can trim just that clip's usable range for this workflow. This only applies inside the workflow, it never changes your original file.

How it feeds your workflow

Every item in the Media Library flows into the workflow on every run. Whatever the node feeds (a generation node, Sequence, Router, or Compose's Sequence or B-Roll input), all of its items are sent each time, so what you see in the node is exactly what the run works with.

Where it can connect

Because every file goes out on every run, the node only connects where none of its files would be lost:

• An input that takes one picture, like Video Generation's 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 Media Library holds 3."
• An input that reads one kind of file (pictures, videos or audio) connects only while every file in the node is that kind.
• A Sequence plays a node's pictures and videos, or its audio, never both from the same node. Put them in two Media Library nodes. Once it's connected to a Sequence, the first file you add decides which.

Once it's connected, the panel only adds files the connected inputs can use. Wired to a Start Frame, it takes one picture: the note "Connected to Start Frame, which takes one picture." shows above Upload media, and the upload and Add from buttons turn off once it holds that picture. A file that doesn't fit is named under the buttons, never left out quietly.

A workflow that already has such a connection (an older one, or one you pasted or imported) stops before it runs, with a message naming the input and the node. Run also waits for uploads: if a file is still uploading, you're asked to wait for it to finish, and a file that didn't upload has to be removed and added again first.

Tips

• Keep only the items you want the run to use in the node; remove anything that shouldn't flow downstream.
• Use Sequence, or Compose's Sequence or B-Roll input, to stitch several clips together in order.
• For files of one kind, the Image Upload, Video Upload and Audio Upload nodes do the same job with a simpler card: upload or pick from your library, and each takes only its own kind.