Command · Add Clip Marker

source.addMarker

Adds a clip marker to a media item, in media time.

• v1
• Capability EditProject
• Tool source_addMarker

Request

{
  "command": "source.addMarker",
  "params": {
    "media": 3,
    "name": "Good take",
    "time": "00:00:02:00"
  }
}

Parameters

colorIndexinteger (0..15)

Marker colour index (Premiere's colours are 0-7).

commentstring

Marker comment.

durationinteger | string | null

Length for a range marker. Default 0. Ticks, or a timecode in the media's frame rate ("00:00:02:10").

highlightobject | null

C.15: a highlight finder's verdict on the marked moment (the Highlights panel reads it). null removes it.

mediainteger | string (1..)Required

The media. A media id or exact name.

namestring

Marker name.

sequenceinteger (1..)

Sequence id; only needed when the project has several.

targetstring

Web link frame target.

timeinteger | string | nullRequired

Where the marker starts, in media time. Ticks, or a timecode in the media's frame rate ("00:00:02:10").

type`comment` | `chapter` | `segmentation` | `webLink`

Premiere's marker type. Default comment.

urlstring

Web link URL (http or https).

Discussion

Run it with wabcut-cli cmd <project> --json, from an MCP client as source_addMarker, or from an extension. See Edit commands for requests, references and results.