Skip to main content

Sequence Remove Items

Category: Pr Tracks & Clips Sequence Remove Items block screenshot

Removes the explicit mixed Track Item selection from a Sequence. `mediaType` selects the alignment/time grid Premiere uses for ripple removal; it does not filter the supplied items to audio or video. `shiftOverlapping` exposes Premiere's low-level removal behavior and does not by itself guarantee exact sequence-wide gap closing. Relist affected tracks after removal instead of reusing pre-removal Track Item references.

Inputs​

InputRequiredValue KindTypesEnum Values
itemsyesexpression——
sequencenoexpression——
ripplenoexpression——
mediaTypenoexpression——
shiftOverlappingnoexpression——
onErrornoexpressionenum-stringSTOP, CONTINUE, RETURN_FALSE
storeResultInnovariable-name——

Notes​

  • items is the explicit mixed Track Item selection to remove.
  • mediaType does not filter that selection to audio or video. It selects the media alignment/time grid Premiere uses for its ripple action.
  • shiftOverlapping exposes Premiere's low-level removal behavior; it is not a guarantee that an arbitrary sequence-wide time gap will close cleanly.
  • Ordinal Track Item refs select current positions, not durable identities. If an earlier Premiere Action is still queued in the same atomic execution, ordinal removal fails before either operation commits because flushing that Action would change the state before the ref is resolved. Commit the earlier transaction, determine the intended target's current ordinal, and remove it in a later transaction.
  • Premiere transaction false and exceptions follow onError (default STOP). CONTINUE and RETURN_FALSE leave storeResultIn=false before the next statement; no previous true value survives a failed removal.
  • After removal, an old ordinal string may select a different item. Re-identify the target if later work must follow a particular clip.