Sequence Create Matching Item

Category: Pr Sequences

Creates an empty sequence whose settings match `settingsSourceItem` and returns its sequence reference through `storeResultIn` when that variable is set. Use this when you will place clips into the sequence afterwards and want the new sequence to match a primary source clip or an existing Sequence. A clip source is used only to derive sequence settings and is removed from the new timeline before the block returns. A Sequence source copies writable Sequence settings into a new empty Sequence and does not create a nest. The stored value is a sequence ref string ending in `::SEQ`, not a boolean success flag. Premiere automatically makes the created Sequence active. `activate` defaults to true; false restores the previously active Sequence when one existed before creation. `settingsSourceItem` must resolve to a clip-capable project item or Sequence. Use `targetBin` when the created sequence should be placed into a specific bin. `onNameCollision` defaults to FAIL; SUFFIX chooses the first available numbered name for either settings-source path.

Inputs

Input	Required	Value Kind	Types	Enum Values
name	yes	expression	—	—
settingsSourceItem	yes	expression	—	—
targetBin	no	expression	—	—
activate	no	expression	—	—
onNameCollision	no	expression	—	—
onError	no	expression	enum-string	STOP, CONTINUE, RETURN_FALSE
storeResultIn	no	variable-name	—	—

Notes

• Creates an empty sequence whose settings match settingsSourceItem.
• Use this when the workflow creates a new sequence and will place clips into it afterwards.
• settingsSourceItem may resolve to a clip-capable project item or a Sequence.
• A clip source is used only to derive settings and is removed from the new timeline before the block returns. A Sequence source copies its writable SequenceSettings into a new empty Sequence; it does not create a nest or a live dependency.
• Premiere automatically activates the created Sequence. activate defaults to true to preserve that behavior. Set it to false to restore the previously active Sequence before the block returns; if the project had no active Sequence, there is no prior Sequence to restore and Premiere's newly created Sequence remains active.
• onNameCollision defaults to FAIL; use SUFFIX to choose the first available numbered name. The policy is applied for both clip and Sequence settings sources, with or without targetBin.
• storeResultIn stores the created sequence ref string (for example Project.prproj@<project-guid>\New Sequence::SEQ), not a boolean success flag.
• Prefer using that stored sequence ref directly in later blocks instead of relying only on the active-sequence side effect.

Examples

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

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