Insert Mogrt From Path

Category: Pr Tracks & Clips

Places a local Motion Graphics Template into a sequence. The `path` input must resolve to a `.mogrt` file when the block runs. Use `audioTrackIndex = -1` for video-only templates and `videoTrackIndex = -1` for audio-only templates. When both track indices are provided, the runtime automatically retries the known Premiere null-track failure by omitting audio first and then video. After a successful insert, the runtime briefly waits for Premiere to expose the MOGRT Graphic Parameters component so the next block can inspect or set template parameters. Premiere's insertion API does not accept `.aegraphic` files or raw After Effects project exports for this block. In ABSCRIPT workflows, `embedded://<assetId>` authoring references are valid only after materialization resolves them to a local `.mogrt` file.

Inputs

Input	Required	Value Kind	Types	Enum Values
path	yes	expression	file-path-string	—
sequence	no	expression	reference, string, null	—
timeSeconds	yes	expression	number	—
videoTrackIndex	no	expression	number	—
audioTrackIndex	no	expression	number	—
onError	no	expression	enum-string	STOP, CONTINUE, RETURN_FALSE
storeResultIn	no	variable-name	variable-name	—

Notes

• Inserts a local Motion Graphics Template into a sequence.
• path must resolve to a .mogrt file when the host call executes.
• Use this path-based block for templates that come from Premiere's local Local Templates / My Templates area.
• A common discovery flow is: prGetInstalledMogrtPath -> listFilesInFolder -> choose the target .mogrt path -> prInsertMogrtFromPath.
• Track indices are 0-based (0 = first track / V1 / A1).
• .aegraphic files and raw After Effects project exports are not accepted by Premiere's insertMogrtFromPath API, even if they look like motion-graphics assets.
• Use audioTrackIndex = -1 for video-only templates and videoTrackIndex = -1 for audio-only templates.
• If both track indices are provided and Premiere hits the known null-track MOGRT bug, the runtime retries automatically by omitting audio first and then video.
• Some Premiere versions surface a low-level null error when a MOGRT is inserted onto a track type that the template does not actually produce.
• After a successful insert, the runtime briefly waits for Premiere to expose the MOGRT Graphic Parameters component before the block completes, so immediate component/parameter reads in the next block see the inserted template's editable parameters when Premiere materializes them in time.
• In ABSCRIPT workflows, embedded://<assetId> is allowed at authoring time, but it must resolve to a materialized .mogrt file before execution.

See Also

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

Examples

Insert Local MOGRT Into Active Sequence

Minimal API pattern for placing a local `.mogrt` file into the active sequence. This stays visible as the canonical local-path counterpart to the portable embedded-MOGRT ABSCRIPT example.

kind: Pattern · format: runtime-dsl · validation: Schema only

Topics: motion graphics templates, timeline placement

Source: patterns/ex-sequence-insert-local-mogrt.json

Download JSON

Insert Embedded MOGRT As ABSCRIPT Build Spec

Portable ABSCRIPT BUILD SPEC example that prompts for a `.mogrt` file, embeds it, and inserts it into the active sequence via `prInsertMogrtFromPath`. This is the portable counterpart to the visible local-path MOGRT pattern.

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

Topics: format selection, embedded assets, motion graphics templates

New to bundled files? Read Embedding Files.

Source: formats/ex-format-abscript-build-spec-prompt-mogrt-insert.json

Download JSON