Import Files

Category: Pr Bins & Project Items

Imports one or many filesystem paths into the current Adobe Premiere project. Use this for normal importable media/files, not for Motion Graphics Templates. Do not use prImportFiles for .mogrt or .aegraphic assets. .mogrt insertion requires the dedicated prInsertMogrtFromPath / prInsertMogrtFromLibrary workflow. .aegraphic files are not importable through Premiere's normal file-import path. storeResultIn stores host-level success flag (boolean). storeImportedItemsIn stores:; newly imported project item refs (default behavior); resolved project item refs in request order when avoidDuplicates=true (reused existing + newly imported). avoidDuplicates (default: false) reuses an existing item in the target bin when both match:; same MEDIA_PATH; same project item name. Import quality controls:; failOnZeroImport (default: true); failOnPartialImport (default: false); expectedImportedCount (exact count assertion). When avoidDuplicates=true, import quality/count checks use resolved item count, not only newly imported item count. Partial imports can occur (some files import, some do not). Do not infer counts from storeResultIn alone. Use onError to decide whether errors stop the script, continue, or return false when the block supports it. If storeResultIn is set, the block also writes a result variable back to your graph. If targetBin is provided, the created sequence or imported items are placed there. When it points into another open project, the operation runs in that target project's context. Set asNumberedStills when numbered image sequences should be treated as still sequences during sync.

Inputs

Input	Required	Value Kind	Types	Enum Values
paths	yes	expression	file-path-string, array	—
targetBin	no	expression	reference, string, null	—
suppressUI	no	expression	boolean	—
asNumberedStills	no	expression	boolean	—
avoidDuplicates	no	expression	boolean	—
expectedImportedCount	no	expression	number	—
failOnPartialImport	no	expression	boolean	—
failOnZeroImport	no	expression	boolean	—
onError	no	expression	enum-string	STOP, CONTINUE, RETURN_FALSE
storeResultIn	no	variable-name	variable-name	—
storeImportedItemsIn	no	variable-name	variable-name	—

Notes

• Imports one or many filesystem paths into project (optionally into targetBin).
• Use this for normal importable media/files, not for Motion Graphics Templates.
• Do not use prImportFiles for .mogrt or .aegraphic assets.
• .mogrt insertion requires the dedicated prInsertMogrtFromPath / prInsertMogrtFromLibrary workflow.
• .aegraphic files are not importable through Premiere's normal file-import path.
• storeResultIn stores host-level success flag (boolean).
• storeImportedItemsIn stores:
  • newly imported project item refs (default behavior)
  • resolved project item refs in request order when avoidDuplicates=true (reused existing + newly imported)
• avoidDuplicates (default: false) reuses an existing item in the target bin when both match:
  • same MEDIA_PATH
  • same project item name
• Import quality controls:
  • failOnZeroImport (default: true)
  • failOnPartialImport (default: false)
  • expectedImportedCount (exact count assertion)
• When avoidDuplicates=true, import quality/count checks use resolved item count, not only newly imported item count.
• Partial imports can occur (some files import, some do not). Do not infer counts from storeResultIn alone.

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

Import Embedded Media As ABSCRIPT Build Spec

Portable ABSCRIPT BUILD SPEC example with a `PROMPT_FILE` asset source and an `embedded://...` import. This is the portable counterpart to the visible local-path media-import pattern.

kind: Format · format: abscript-build-spec · validation: Schema only

Topics: format selection, embedded assets

New to bundled files? Read Embedding Files.

Source: formats/ex-format-abscript-build-spec-prompt-file-import.json

Download JSON