Place Item In Sequence

Category: Pr Tracks & Clips

Places one project item into a sequence at a given time using `INSERT` or `OVERWRITE` mode. Without `sourceInSeconds` / `sourceOutSeconds`, the block keeps the legacy Premiere behavior and uses the project item's current source range. When `sourceInSeconds` and/or `sourceOutSeconds` are provided, the runtime temporarily overrides the project item's source in/out for this placement only and restores the original project-item state afterward. If only `sourceInSeconds` is provided, placement runs from that time to media end. If only `sourceOutSeconds` is provided, placement runs from media start to that time.

Inputs

Input	Required	Value Kind	Types	Enum Values
item	yes	expression	reference, string	—
sequence	no	expression	reference, string, null	—
mode	yes	expression	enum-string	INSERT, OVERWRITE
timeSeconds	yes	expression	number	—
sourceInSeconds	no	expression	number	—
sourceOutSeconds	no	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	—

Replaces Older Blocks

• prSequenceInsertItem
• prSequenceOverwriteItem

Notes

• Unified single-item timeline placement block.
• Set mode to:
  • INSERT to insert at timeSeconds (uses limitShift when provided).
  • OVERWRITE to overwrite at timeSeconds (ignores limitShift).
• Without sourceInSeconds / sourceOutSeconds, the block preserves Premiere's legacy behavior and places the project item's current source range.
• In the tested untouched-default case, that legacy behavior inserted the full clip.
• If the project item's source in/out were explicitly set before placement, the legacy no-range form places exactly that configured source range.
• sourceInSeconds and sourceOutSeconds override that legacy stateful behavior for this placement only.
• If only sourceInSeconds is set, placement runs from that time to media end.
• If only sourceOutSeconds is set, placement runs from media start to that time.
• When explicit source-range inputs are used, the runtime temporarily sets project-item source in/out, performs the placement, and restores the original project-item state afterward. This requires write permission for the source project item as well as the target sequence.
• Supports explicit videoTrackIndex / audioTrackIndex.
• Track indices are 0-based (0 = first track / V1 / A1).
• Preferred block for new scripts.

See Also

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

Examples

Place Multiple Source Ranges From One Clip

Creates an empty sequence, then fills it with three explicit source ranges from one clip while verifying the original project-item in/out gets restored afterward.

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

Topics: timeline placement, source range placement, sequence creation

Source: patterns/ex-sequence-place-multiple-source-ranges-from-one-clip.json

Download JSON

Set Project Item In/Out Then Place It

Sets a clip project item's source in/out, places it into a new sequence without explicit source-range overrides, then verifies that placement used the current project-item range.

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

Topics: timeline placement, project item properties, source range placement

Source: patterns/ex-sequence-set-project-item-in-out-and-place.json

Download JSON

Create Empty Sequence Matching Selected Item And Place It

Creates an empty sequence whose settings match the first selected project item, stores the returned sequence ref, then places the item explicitly into that sequence.

kind: Pattern · format: runtime-dsl · validation: Manual workspace

Topics: sequence creation, project inspection, timeline placement, matched sequence settings

Source: patterns/ex-sequence-create-matching-item-and-place.json

Download JSON