Skip to main content

Get Project Item Property

Category: Pr Bins & Project Items Get Project Item Property block screenshot

Reads one property from a Premiere project item. The `NAME` property means the item name inside the Premiere project; it is not necessarily the underlying media file name. Use `MEDIA_FILENAME` or `MEDIA_FILENAME_WITHOUT_EXTENSION` when you need values derived from `MEDIA_PATH` instead of the Premiere item name. The `HAS_TRANSCRIPT` property reports whether a clip project item currently has transcript data. For sequence refs that represent project items, auto-coercion can resolve to the project item.

Inputs​

InputRequiredValue KindTypesEnum Values
itemyesexpressionreference, premiere-pathspec-string—
propertyyesstringenum-stringASPECT_RATIO, AUDIO_USAGE, CAN_CHANGE_MEDIA_PATH, CAN_PROXY, COLOR_LABEL, CONTENT_TYPE, DURATION, EXTENDED_TYPE, INPUT_LUT_ID, FOOTAGE_ALPHA_USAGE, FOOTAGE_FIELD_TYPE, FOOTAGE_FRAMERATE, FOOTAGE_IGNORE_ALPHA, FOOTAGE_INVERT_ALPHA, FOOTAGE_PIXEL_ASPECT_RATIO, FOOTAGE_REMOVE_PULLDOWN, FOOTAGE_VR_CONFORM_PROJECTION_TYPE, FOOTAGE_VR_HORIZONTAL_VIEW, FOOTAGE_VR_LAYOUT_TYPE, FOOTAGE_VR_VERTICAL_VIEW, FRAME_ASPECT_RATIO, GOOD, HAS_AUDIO, HAS_PROXY, HAS_TRANSCRIPT, HAS_VIDEO, HEIGHT, HIDDEN, IN_POINT, IS_OFFLINE, IS_MERGED_CLIP, IS_MULTICAM_CLIP, IS_SEQUENCE, IS_STILL, MEDIA_FILENAME, MEDIA_FILENAME_WITHOUT_EXTENSION, MEDIA_PATH, EMBEDDED_LUT_ID, NAME, NODE_ID, ITEM_TYPE, OUT_POINT, PARENT_BIN, PIXEL_ASPECT_RATIO, PROXY_PATH, RATING, TEAM_PROJECT_ASSET_ID, TREE_PATH, VIDEO_USAGE, WIDTH, ZERO_POINT

Notes​

  • Reads project item properties (name, media path, tree path, etc.).
  • NAME means the item's name inside the Premiere project, not necessarily the media file name from disk.
  • Use MEDIA_FILENAME or MEDIA_FILENAME_WITHOUT_EXTENSION when you want values derived from MEDIA_PATH.
  • HAS_TRANSCRIPT reports whether a clip project item currently has transcript data.
  • HAS_TRANSCRIPT is only an existence signal. It does not guarantee that the transcript is already fully populated with final words/segments.
  • For sequence refs that represent project items, auto-coercion can resolve to the project item.

See Also​

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

Examples​

Import Local Media File Into Project

Imports a fixed local media file into the current Premiere project with `avoidDuplicates=true`. This stays visible as the canonical local-path counterpart to the portable embedded-media ABSCRIPT example.

kind: Pattern · format: runtime-dsl · validation: MCP fixture

Topics: project import, embedded assets, runtime validation

Source: patterns/ex-project-import-local-media-file.json

Download JSON

Mutate And Restore One Project Item

Renames and relabels the source project item, then restores both properties so the fixture remains clean.

kind: Pattern · format: runtime-dsl · validation: MCP fixture

Topics: project items, metadata mutation

Source: patterns/ex-project-item-mutate-and-restore.json

Download JSON

Set Project Item In/Out Then Place It

Sets a clip project item's source in/out, places it into a new sequence without explicit source-range overrides, then verifies that placement used the current project-item range.

kind: Pattern · format: runtime-dsl · validation: MCP fixture

Topics: timeline placement, project item properties, source range placement

Source: patterns/ex-sequence-set-project-item-in-out-and-place.json

Download JSON