Skip to main content

Find Project Items

Category: Pr Bins & Project Items Find Project Items block screenshot

Searches project items and returns all matches. Use fields to choose where the search runs, for example NAME, MEDIA_PATH, or NAME_OR_MEDIA_PATH. Use match to switch between EXACT or CONTAINS matching. Set caseSensitive when upper/lower case should matter during matching. Use scopeBin to restrict project-item searches to one bin. 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.

Inputs

InputRequiredValue KindTypesEnum Values
queryyesexpressionstring
fieldsnoenumenum-stringNAME, MEDIA_PATH, NAME_OR_MEDIA_PATH
matchnoenumenum-stringEXACT, CONTAINS
caseSensitivenoexpressionboolean
scopeBinnoexpressionreference, string, null
includeSubbinsnoexpressionenum-string, booleanBIN_ONLY, BIN_AND_SUBBINS
typesnoarrayenum-stringTYPE_FOOTAGE, TYPE_SEQUENCE, TYPE_MULTICAM_SEQUENCE, TYPE_MERGED_CLIP, TYPE_BIN, TYPE_FILE

Notes

No additional notes are available yet.

See Also

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