Skip to main content

Track Item Clone

Category: Pr Tracks & Clips Track Item Clone block screenshot

Duplicates a Track Item with a time offset and destination-track offsets, using an Insert or Overwrite edit. timeOffsetSeconds is a signed offset from the original Track Item position. The host converts this offset to the nearest native tick; alignToVideo remains a separate native editing option and can affect the actual cloned position. insert keeps its existing native Insert/Overwrite meaning; this conversion does not change track offsets or edit mode. Read the resulting Timeline state when precise edit points matter. Use onError to decide whether errors stop the script, continue, or return false when the block supports it. If storeResultIn is set, the block also writes a result variable back to your graph. Use the offset inputs to place the clone later in time or on different destination tracks. Set alignToVideo when linked audio should stay aligned to the cloned video placement. Set insert when cloning should ripple existing timeline contents instead of simply overwriting.

Inputs​

InputRequiredValue KindTypesEnum Values
itemyesexpression——
timeOffsetSecondsnoexpression——
videoTrackOffsetnoexpression——
audioTrackOffsetnoexpression——
alignToVideonoexpression——
insertnoexpression——
onErrornoexpressionenum-stringSTOP, CONTINUE, RETURN_FALSE
storeResultInnovariable-name——

Notes​

  • Duplicates a Track Item with a time offset and destination-track offsets, using an Insert or Overwrite edit.
  • timeOffsetSeconds is a signed offset from the original Track Item position. The host converts this offset to the nearest native tick; alignToVideo remains a separate native editing option and can affect the actual cloned position.
  • insert keeps its existing native Insert/Overwrite meaning; this conversion does not change track offsets or edit mode. Read the resulting Timeline state when precise edit points matter.

See Also​

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

Examples​

Mutate One Track Item On An Isolated Sequence

Creates a fresh sequence from one source item, renames, disables, moves, and clones the first clip, then verifies each observable mutation.

kind: Pattern · format: runtime-dsl · validation: MCP fixture

Topics: track items, timeline mutation

Source: patterns/ex-track-item-mutate-on-isolated-sequence.json

Download JSON