Insert Item In Sequence
Legacy-compatible insert block kept mainly for compatibility with older scripts. videoTrackIndex and audioTrackIndex are 0-based (0 = first track / V1 / A1). Legacy-compatible single-item timeline insert block. Track indices are 0-based (0 = first track / V1 / A1). New scripts should prefer prSequencePlaceItem. If sequence is omitted, the block uses the active sequence when supported. 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. If limitShift is set, insert mode is only allowed to ripple other items up to that limit.
Inputs
| Input | Required | Value Kind | Types | Enum Values |
|---|---|---|---|---|
item | yes | expression | reference, string | — |
sequence | no | expression | reference, string, null | — |
timeSeconds | yes | expression | number | — |
videoTrackIndex | no | expression | number | — |
audioTrackIndex | no | expression | number | — |
limitShift | no | expression | boolean | — |
onError | no | expression | enum-string | STOP, CONTINUE, RETURN_FALSE |
storeResultIn | no | variable-name | variable-name | — |
Preferred Alternative
Use prSequencePlaceItem for new scripts when possible.
Notes
- Legacy-compatible single-item timeline insert block.
- Track indices are 0-based (
0= first track / V1 / A1). - New scripts should prefer
prSequencePlaceItem.
See Also
- Premiere Reference Paths: Explains Premiere reference path strings for project items, sequences, tracks, timeline items, markers, components, and parameters.