Track Item Move

Category: Pr Tracks & Clips

startSeconds is an absolute time in sequence coordinates, not a relative delta. The operation moves the track item without intentionally changing its source in/out range or duration. This is a non-ripple operation. Neighboring clips are not intentionally shifted. collisionMode=FAIL is the default. The host checks the target time range and rejects the move before mutation when another clip on the same track overlaps it. collisionMode=ALLOW_OVERLAP exposes Premiere's raw move behavior and may create overlapping clip time ranges on one track. Use it only when that overlap is intentional. Overwrite and ripple moves are not currently represented by this block. They require separate tested edit strategies rather than aliases for Premiere's raw move action. 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.

Inputs

Input	Required	Value Kind	Types	Enum Values
item	yes	expression	—	—
startSeconds	yes	expression	—	—
collisionMode	no	expression	—	—
onError	no	expression	enum-string	STOP, CONTINUE, RETURN_FALSE
storeResultIn	no	variable-name	—	—

Notes

• startSeconds is an absolute time in sequence coordinates, not a relative delta.
• The operation moves the track item without intentionally changing its source in/out range or duration.
• This is a non-ripple operation. Neighboring clips are not intentionally shifted.
• collisionMode=FAIL is the default. The host checks the target time range and rejects the move before mutation when another clip on the same track overlaps it.
• collisionMode=ALLOW_OVERLAP exposes Premiere's raw move behavior and may create overlapping clip time ranges on one track. Use it only when that overlap is intentional.
• Overwrite and ripple moves are not currently represented by this block. They require separate tested edit strategies rather than aliases for Premiere's raw move action.

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

Slip And Move A Track Item Without Affecting Neighbors

Creates three clips with gaps, slips and moves the middle clip, and verifies that both surrounding clips remain unchanged.

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

Topics: track items, slip edit, move edit, non-ripple editing, timeline invariants

Source: patterns/ex-track-item-slip-and-move-preserve-neighbors.json

Download JSON