Skip to main content
Participant
September 13, 2026
Question

Preserving video/audio link when moving a clip to a different track via UXP?

I'm shifting a linked VideoClipTrackItem one video track up (to make room for another clip below it) using SequenceEditor.createCloneTrackItemAction() + createRemoveItemsAction(), since there doesn't seem to be a track-level move command (createMoveAction only shifts the in-point in time, not the track). This clone+remove approach works fine positionally, but it breaks the link to the item's linked audio clip (even when I clone+remove the linked audio item too within the same transaction).

Is there any documented (or undocumented) way to preserve the video/audio link when moving a linked item to a different track via UXP? Or am I missing something obvious?

    4 replies

    CyrilG93
    Participant
    October 22, 2026

    Hello !
    Any news on this ?

    I am developing a Premiere Pro UXP plugin with several Timeline organization actions. These actions need to move, reorder, or distribute selected clips while preserving Premiere’s native video/audio link.

    At present, the documented UXP workflow for moving a Timeline item appears to be:

    1. Read the Timeline selection with sequence.getSelection().getTrackItems().
    2. Create a copy using SequenceEditor.createCloneTrackItemAction().
    3. Remove the original using SequenceEditor.createRemoveItemsAction().

    This works visually, but cloning and removing track items breaks the native Premiere link between a video clip and its linked audio clip. Cloning the video and audio separately in the same transaction keeps them synchronized in time, but does not preserve their link.

    This affects multiple Timeline actions in my plugin:

    • Move Video Clip Up / Down
      Moving a video clip to another video track creates a new, unlinked video clip.

    • Staircase Up / Down
      Distributing selected clips across video tracks breaks the original video/audio links.

    • Tower / Reverse Tower / Tower with Offset
      These actions can detect linked audio and move it together with the video.

    • Reverse Timeline Clip Order
      Reordering clips with clone/remove has the same issue.

    • Randomize Order Selection
      A shuffle action has the same requirement. 

     

    The alignToVideo parameter of createCloneTrackItemAction() does not appear to recreate or preserve the native Premiere video/audio link.

    Could Premiere UXP expose one of the following?

    • An action to move a linked video/audio group while preserving the native link.
    • An action to clone a linked video/audio group as a linked group.
    • An action to create or restore a native link between a VideoClipTrackItem and an AudioClipTrackItem.
    • A documented option on createCloneTrackItemAction() that preserves linked media.
    • Read access to a linked-group identifier, allowing plugins to reliably identify the complete linked group.

    This would make it possible to build safe Timeline tools for reordering clips, randomizing clip order, changing tracks, creating staircases, and stacking clips without damaging the editing relationships users rely on.

    Thank you.

    Translate
    bbb_999
    Community Manager
    Community Manager
    September 17, 2026

    Confirming: You want the corresponding trackItem to move with the one you’re moving, yes?

    Translate
    Participant
    September 19, 2026

    Not exactly. I want to move a videoClip up one track f.ex..
    However there is no function that is able to move the clip to a different track. Therefore I use SequenceEditor.createCloneTrackItemAction() + createRemoveItemsAction()
    to simulate a move of the clip.
    However when cloning the videoclip the link / connection to its corresponding audioclip gets lost. 
    This results in me having the videoclip exactly at the track i want it to however there is no link to its audio anymore, which is quite annoying.

    Translate
    Community Manager
    September 16, 2026

    Hi,

    Thanks for the post. I'll try to get a team member to respond. I appreciate your patience.


    Thanks,
    Kevin

    Translate