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 the first or primary source clip. Unlike `prSequenceCreateFromItems`, the source item is only used to derive sequence settings and is removed from the new timeline before the block returns. The stored value is a sequence ref string ending in `::SEQ`, not a boolean success flag. The newly created sequence becomes the active sequence in Premiere, but later blocks should prefer the stored sequence ref for deterministic follow-up work. `settingsSourceItem` must resolve to a clip-capable project item. Use `targetBin` when the created sequence should be placed into a specific bin.

Inputs

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

Notes

• Creates an empty sequence whose settings match settingsSourceItem and makes it the active sequence in Premiere.
• Use this when the workflow creates a new sequence and will place clips into it afterwards.
• settingsSourceItem must resolve to one clip-capable project item; it is used only to derive sequence settings, not left in the timeline.
• storeResultIn stores the created sequence ref string (for example Project.prproj\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