Sequence Clone

Category: Pr Sequences

Clones a sequence and returns the cloned sequence reference through `storeResultIn` when that variable is set. Optional `name` and `targetBin` are applied to the exact created Sequence before its refs are serialized. When `name` is supplied, `onNameCollision` defaults to FAIL; SUFFIX chooses the first available numbered name. The stored value is a sequence ref string ending in `::SEQ`, not a boolean success flag. Optional result variables expose the applied name, Sequence GUID, and Sequence Project Item ref.

Inputs

Input	Required	Value Kind	Types	Enum Values
sequence	no	expression	—	—
name	no	expression	—	—
targetBin	no	expression	—	—
onNameCollision	no	expression	—	—
onError	no	expression	enum-string	STOP, CONTINUE, RETURN_FALSE
storeResultIn	no	variable-name	—	—
storeAppliedNameIn	no	variable-name	—	—
storeGuidIn	no	variable-name	—	—
storeProjectItemIn	no	variable-name	—	—

Notes

• Clones a sequence and returns the cloned sequence ref.
• Optional name and targetBin are applied while the host still holds the exact created Sequence and Project Item.
• When name is supplied, onNameCollision defaults to FAIL. Use SUFFIX to choose the first available Name 2, Name 3, and so on. Omitting name preserves Premiere's existing clone-name behavior.
• storeResultIn stores the cloned sequence ref string, not a boolean success flag.
• storeAppliedNameIn, storeGuidIn, and storeProjectItemIn optionally capture the final visible name, Sequence GUID, and Project Item ref.

See Also

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