Premiere Pro 26.5.2 UXP: Clarification of createInsertProjectItemAction, limitShift, and Audio-Only Insertion

Hello Adobe Premiere Pro UXP team,

We’re developing a carefully controlled editing workflow using Premiere Pro 26.5.2 and would appreciate clarification of the documented SequenceEditor.createInsertProjectItemAction() method.

The API reference specifies:

createInsertProjectItemAction(

projectItem,

time,

videoTrackIndex,

audioTrackIndex,

limitShift

)

However, several behavioral details are unclear.

We have constructed a small, disposable test project with the following configuration:

  • Premiere Pro 26.5.2
  • Sequence: 1920 × 1080, 50 fps, 48 kHz, stereo master
  • A1: One-second audio clip occupying 0–1 seconds
  • A2: Empty
  • Source ProjectItem: Two-second, 48 kHz mono PCM16 WAV
  • Proposed operation: Insert the source at exactly 1 second on A2, preserving the existing A1 clip and creating no additional tracks

Before implementing or executing the operation, we’d appreciate clarification of four questions.

1. What precisely does limitShift control?

For true and false, which tracks and timeline items can shift? Does either value limit ripple behavior to the destination track, or can other audio/video tracks be affected?

2. What is the correct video-track argument for audio-only media?

The method requires both video and audio track indices. For a WAV containing no video stream, should videoTrackIndex refer to an existing video track (such as index 0), or is there a documented value indicating that no video insertion is requested?

We want to avoid unsupported sentinel values and unintended track creation.

3. How are audio channels and source In/Out marks handled?

When inserting a mono WAV onto an existing audio track at index 1 (A2):

  • Should the operation create exactly one AudioClipTrackItem?
  • Does the destination track’s channel type affect that result?
  • Does Insert use the effective audio source marks returned by ClipProjectItem.getInPoint(mediaType) and ClipProjectItem.getOutPoint(mediaType)?
  • Is the resulting duration aligned to the sequence frame boundaries?

4. What failure guarantees does the operation provide?

When the Action is created within project.lockedAccess() and committed through project.executeTransaction(), does a failed transaction guarantee that no partial timeline changes occurred? Or must a plugin independently inspect the complete affected state?

Our objective is a predictable editing operation with explicit preconditions, observable results, and no unintended modifications.

We have not yet executed the Insert action. We’re establishing the supported contract before doing so.

We would particularly appreciate answers applicable to Premiere Pro 26.5.2, including any relevant limitations or known issues.

Thank you for your guidance.

Douglas Christian