Field settings
Options
Section titled “Options”Upload volume Which Craft volume stores transcoded video files and poster thumbnails.
Subfolder
Optional Twig path template evaluated per element, e.g. videos/{section.handle}. Same syntax as Craft’s built-in Assets field.
Presets
Which global presets this field produces. All selected presets run automatically on upload — content authors don’t choose at upload time. A “Hero Video” field might use only hero-h264-720p; a “Modal Video” field might use modal-h264-540p and modal-vp9-540p.
Keep source
Also upload the original untranscoded file as a Craft Asset (off by default). Access it in Twig via video.source.url.
CP field behaviour
Section titled “CP field behaviour”Empty state
Section titled “Empty state”Shows a drag-and-drop zone. Any common video format can be dropped: H.264, H.265, AV1, ProRes, VP9, and more.
During transcoding
Section titled “During transcoding”The drop zone disables so editors can’t start a second job mid-flight. Each preset shows a live progress bar.
After upload
Section titled “After upload”The drop zone is replaced by a thumbnail card with Replace and Remove buttons.
- Replace — opens the file picker. A new file resets all variants and retranscodes from scratch.
- Remove — clears the field. The Craft Assets stay in the volume but are unlinked from the entry. Save to persist the cleared state.
Live Preview
Section titled “Live Preview”The field initialises correctly in Craft’s Live Preview editor pane. If a video is already saved, the thumbnail card shows without re-transcoding.