Skip to main content

Sequence Create Subsequence

Category: Pr Sequences Sequence Create Subsequence block screenshot

Creates Premiere's native independent subsequence from the explicit clip Track Items in `items`. Premiere copies whole selected items; source Sequence in/out points do not trim items that cross those boundaries. The block temporarily replaces and then restores the source Sequence selection; it never falls back to ambient selection. `ignoreTrackTargeting` defaults to true. Naming, bin placement, collision handling, and identity outputs follow the same contract as prSequenceClone. Track Item refs are index-addressed snapshots; relist after later structural timeline mutations.

Inputs

InputRequiredValue KindTypesEnum Values
sequencenoexpression
itemsyesexpression
ignoreTrackTargetingnoexpression
nameyesexpression
targetBinnoexpression
onNameCollisionnoexpression
onErrornoexpressionenum-stringSTOP, CONTINUE, RETURN_FALSE
storeResultInnovariable-name
storeAppliedNameInnovariable-name
storeGuidInnovariable-name
storeProjectItemInnovariable-name

Notes

  • Creates Premiere's native independent subsequence from explicit clip Track Item refs.
  • Premiere copies each selected Track Item as a whole. Source Sequence in/out points do not trim items that cross those boundaries; isolate exact ranges before calling this block or use a native explicit-range capability when one is available.
  • items is required; the block never falls back to ambient selection.
  • All items must belong to sequence, which defaults to the active Sequence.
  • The block snapshots the source Sequence selection, temporarily selects exactly items, calls Premiere's native createSubsequence, and restores the prior source selection before returning.
  • If restoration of the prior selection fails after Premiere created the subsequence, the block deletes that new subsequence and reports failure. This intentionally preserves the promised source-UI-state contract rather than returning an output after incomplete cleanup.
  • ignoreTrackTargeting defaults to true so track-targeting UI state does not silently change the requested content.
  • name, targetBin, onNameCollision, and the four result variables use the same identity contract as prSequenceClone.
  • The returned Sequence is independent rather than a live nest. Its detailed transition, caption, marker, track-effect, automation, time-origin, and Undo behavior remains subject to the documented real-host support matrix.

See Also

  • Premiere Reference Paths: Explains Premiere reference path strings for project items, sequences, tracks, timeline items, markers, components, and parameters.