Video Concat

Concatenate video clips into one MP4, in order. Wire an array of clips, or up to 6 discrete ports.

Try Video Concat in the playground

Last updated View as MarkdownAgent setup

Video Concat

Node type: utility:video_concat
Category: Data

Description

Video Concat joins 2 to 12 video clips into one MP4, in order: wire the clips into the node, run the workflow, and the Concatenated Video output holds the joined file. Use it to turn many generated shots back into a single video, such as the clips an iterator made one at a time. Long reels are re-encoded, which can take minutes, and the node waits until the file is finished. There are two ways to supply the clips:

  • Array (clips): wire an iterator's collected clips or a Media Splitter segments array into the clips port to stitch N clips in array order. This is the way to reassemble the output of a fan-out (e.g. one talking-avatar clip per script slice) back into a single video.
  • Discrete ports (video_1..video_6): wire 2 to 6 clips individually; unwired ports are skipped and the wired ones concatenate in port order.

When clips is wired it takes precedence and the discrete ports are ignored (no silent merge of the two). At least 2 clips are required, and at most 12: past the cap the node fails loud rather than truncating. The node fails loud in general: a failed concat returns an error, never a partial result.

The clips array accepts elements that are a bare URL string or a { url } / { video } / { videoUrl } object; each element is one clip. Each discrete port accepts the same shapes, or an array of them (the first resolvable element is used, since a discrete port expects one clip).

Canvas ports

These appear as port handles on the left side of the node.

ID Label Details
clips Clips (array) ARRAY. An ordered list of clips; overrides the ports below.
video_1 Video 1 VIDEO (required)
video_2 Video 2 VIDEO (required)
video_3 Video 3 VIDEO
video_4 Video 4 VIDEO
video_5 Video 5 VIDEO
video_6 Video 6 VIDEO

These render as form fields in the right-side config panel when the node is selected.

No sidebar config fields.

Outputs

ID Label Type
video Concatenated Video VIDEO

Notes

  • Between 2 and 12 clips. Fewer than 2 or more than 12 is an error, not a truncation.
  • clips (the array port) wins over video_1..video_6 when both are wired. They are never merged.
  • Matching clips are joined without re-encoding, up to 8 GB in total. Mixed clips use the first clip's display shape, capped at 720p, fitted with padding, up to 0.75 GB in total. Details below.

How big a join can be

Video Concat is built for long-form joins, a documentary rendered in parts included. Nothing is held in memory: the clips stream to disk, each one is deleted as soon as it has been stitched, and the result streams back out in parts.

Matching clips (same size, codec, frame rate and audio format, which is what one template or one model renders) are joined without re-encoding. That is fast and lossless, and takes up to 8 GB of clips in total, as long as the clips plus one more copy of the largest fit the stitcher's working space.

Mixed clips use the first clip's display shape, capped at 720p (at most 1280 pixels on the long edge and 720 on the short edge), at 30 fps. Each clip is fitted inside that canvas with padding before the join. Re-encoding is slower and lossy, so it takes up to 0.75 GB of clips in total. Export every clip with the same settings to get the fast path.

One run has about 11 minutes for the downloads, the join and the upload.

When a join is too big

The node refuses at the first clip that would not fit and names the limit it hit: the 8 GB total, the working space (with its real size), or the 0.75 GB re-encode cap. Nothing past that clip is downloaded. A join that runs out of time or space while stitching or uploading says that too. It never returns a partial or truncated video. Split a bigger job into several concats.


Auto-generated from the Wireflow node registry (this page hand-edited for the clips array port).

For AI agents: the full documentation index is at /llms.txt, and most docs pages are available as Markdown by adding .md to the URL.

© 2026 Wireflow. All rights reserved.