Get Project Item Property

Category: Pr Bins & Project Items

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 or Sequence project item currently has transcript data. For sequence refs that represent project items, auto-coercion can resolve to the project item. The eleven `FOOTAGE_*` interpretation properties share the dedicated footage interpretation getter implementation and eligibility requirements. Unimplemented properties are excluded from new Blockly authoring. Imported unsupported/unknown identifiers remain visible, but semantic validation rejects their execution.

Inputs

Input	Required	Value Kind	Types	Enum Values
item	yes	expression	reference, premiere-pathspec-string	—
property	yes	string	enum-string	CAN_CHANGE_MEDIA_PATH, CAN_PROXY, COLOR_LABEL, CONTENT_TYPE, DURATION, 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, HAS_AUDIO, HAS_PROXY, HAS_TRANSCRIPT, HAS_VIDEO, HEIGHT, 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, PROXY_PATH, TREE_PATH, WIDTH

Notes

• Reads project item properties (name, media path, tree path, etc.).
• The eleven FOOTAGE_* interpretation properties delegate to prGetProjectItemFootageInterpretationProperty, with the same numeric/boolean values and clip/interpretation eligibility requirements.
• ASPECT_RATIO, AUDIO_USAGE, EXTENDED_TYPE, FRAME_ASPECT_RATIO, GOOD, HIDDEN, PIXEL_ASPECT_RATIO, RATING, TEAM_PROJECT_ASSET_ID, VIDEO_USAGE, and ZERO_POINT are not implemented by this general getter. They are hidden from new Blockly authoring. Existing identifiers remain visible on import but semantic validation rejects them; use explicit metadata/media/sequence APIs where their meaning is verified.
• Unknown property strings are retained for review rather than silently replaced by another dropdown choice. Structural schema acceptance does not establish execution support.
• 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.
• MEDIA_PATH, MEDIA_FILENAME, and MEDIA_FILENAME_WITHOUT_EXTENSION return an empty string for clip items whose media path is unavailable, including pathless or host-unreadable media. They still reject non-clip project items.
• HAS_VIDEO and HAS_AUDIO use native AUDIO/VIDEO component-chain availability. An object establishes a source/output channel, including a video chain with zero effects; a successful null establishes absence. For Sequence project items these flags describe video/audio output channels available when nesting the Sequence in another Sequence. Empty and audio-only Sequences can therefore return true for both flags. This does not mean that any track contains clips, visible picture or audible sound; inspect timeline items separately for those questions.
• WIDTH and HEIGHT return positive integer pixel dimensions from native Sequence.getFrameSize() for sequence-backed items, including the verified Multicam and AV-Merged fixtures, or complete Project Metadata Column.Intrinsic.VideoInfo for other visual clip items. Positively established no-video media returns 0.
• IS_STILL follows Premiere's media classification, not a filesystem file type: recognized localized StillImage values mean true, including Adjustment Layers; localized Movie/Video values mean false, including numbered image sequences. Visual non-Sequence items use complete Project Metadata Column.Intrinsic.MediaType. Ordinary Sequences, Multicam sources and positively established no-video items return false. Native isSequence=true also includes Merged Clips; for visual Merged Clips, still identity is currently unavailable rather than inferred from that predicate. Their independently known channels and dimensions remain readable.
• These five properties are independent of Project Panel columns. Native failures, missing/invalid required data and unrecognized still-classification tokens throw PROPERTY_DATA_UNAVAILABLE with property, item and source context. In particular, offline visual items can retain dimensions/channels while their original still identity is unavailable; an offline JPG must not silently return false. The exact StillImage/Movie/Video resource values extracted from Premiere 26.5.2 cover English, German, French, Spanish, Italian, Brazilian Portuguese, Japanese, Korean, Russian and Simplified Chinese. English/German are matched to live metadata evidence; the other eight locales are accepted from the same dictionary keys without a third-language live test. No UI-language lookup or installation-file access is required at runtime. Unknown tokens remain unavailable; this is a resource-based mapping, not a language-neutral native classifier.
• Placement uses the same native channel source through an internal query, including source-range placement without storePlacedItemsIn. It does not call the public convenience getter or require display columns. Unknown channel classification fails before placement/source-range mutation; earlier pending Actions may already be committed under the transaction policy. Existing placement error policies apply; expression reads in setVar do not acquire an onError policy. Guard optional reads with trySetVar and inspect storeSucceededIn / storeErrorIn; a fallback must not turn unknown media into an absent channel or a non-still. For required values, check all source items before starting mutations. The two Metadata Search sequence recipes do this before creation and report any later unavailable fitting dimensions without aborting the placement run.
• HAS_TRANSCRIPT reports whether a clip or Sequence 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.
• Choosing A Project Item Metadata Surface: Explains when to use typed project-item properties, the current Project Panel display, complete project-local metadata, or imported media XMP.

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