For All Items In Bin

Category: Pr Bins & Project Items

Iterates over Project Items from a Bin or the current Project Panel selection, optionally expanding selected Bins recursively. With onlySelected=false, an omitted/null bin means the root bin. With onlySelected=true, selected Project Panel items are traversal roots; BIN_AND_SUBBINS recursively expands selected bins even when TYPE_BIN is not requested, then types filters iterated items. Selected bins themselves require TYPE_BIN. Overlapping roots are deduplicated at first occurrence. An explicit bin scopes selected roots to that subtree; omitting bin uses the whole selection. Uses the same Bin and Project Panel selection traversal and the same types contract as prListProjectItems, then iterates the resulting Project Items. The block editor shows types as checkboxes. An imported unknown entry has no checkbox; the editor keeps it unchanged on export and shows a warning on the block, so the document stays openable while validation rejects it. Selecting a supported type checkbox removes the preserved entries and the warning (undoable). If Premiere returns a Bin child list containing a null item, the block rereads that list up to three times. A list that remains incomplete aborts the operation instead of silently omitting a Project Item; iteration does not begin from a partial listing. Use includeSubbins to search only the current bin or also its children, for example BIN_ONLY or BIN_AND_SUBBINS. Use types to filter by item kinds such as TYPE_FOOTAGE, TYPE_SEQUENCE, TYPE_MULTICAM_SEQUENCE, TYPE_MERGED_CLIP, TYPE_BIN, or TYPE_FILE. Set onlySelected to return only currently selected project items.

Inputs

Input	Required	Value Kind	Types	Enum Values
itemVar	yes	string	variable-name	—
bin	no	expression	reference, string, null	—
onlySelected	no	expression	boolean	—
includeSubbins	no	expression	enum-string, boolean	BIN_ONLY, BIN_AND_SUBBINS
types	no	array	enum-string	TYPE_FOOTAGE, TYPE_SEQUENCE, TYPE_MULTICAM_SEQUENCE, TYPE_MERGED_CLIP, TYPE_BIN, TYPE_FILE

Notes

• Iterates over Project Items from a Bin or the current Project Panel selection, optionally expanding selected Bins recursively.
• Uses the same Bin and Project Panel selection traversal and the same types contract as prListProjectItems, then iterates the resulting Project Items.
• The block editor shows types as checkboxes. An imported unknown entry has no checkbox; the editor keeps it unchanged on export and shows a warning on the block, so the document stays openable while validation rejects it. Selecting a supported type checkbox removes the preserved entries and the warning (undoable).
• If Premiere returns a Bin child list containing a null item, the block rereads that list up to three times. A list that remains incomplete aborts the operation instead of silently omitting a Project Item; iteration does not begin from a partial listing.

See Also

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

Examples

Transcribe Selected Clips

Transcribe explicitly selected clip project items, distinguish existing transcripts, and export JSON for content review.

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

Topics: transcript, selection

Source: patterns/ex-transcribe-selected-clips.json

Download JSON