List Markers

Category: Pr Markers

Lists marker refs, optionally filtered by type and time overlap. types is an optional list of Comment, Chapter, Segmentation, WebLink, FLVCuePoint strings, ignoring case and surrounding whitespace; existing COMMENT/CHAPTER/WEBLINK/FLVCUEPOINT enum tokens work. FLVCuePoint and Segmentation are distinct types. Omitted or empty means all; unknown values fail. Combined with inclusive overlap. Returned refs retain full-list ordinals, not filtered positions; relist after marker insertion, deletion or reordering. Optional types evaluates to a list of Comment, Chapter, Segmentation, WebLink, FLVCuePoint strings, ignoring case and surrounding whitespace. Existing enum tokens COMMENT, CHAPTER, WEBLINK, FLVCUEPOINT work directly. Omitted or empty lists include all types; scalar strings, null, unknown names and non-string entries fail. Duplicates have no effect. Type filtering combines with the existing inclusive time-overlap filter. Results retain full-list indices, including positions skipped for invalid native entries; indices are never renumbered after filtering. Consume these refs immediately. Insertion, deletion or reordering (including moving a marker) can change full-list indices. Relist after structural changes; this is not durable marker identity. For a newly created marker, use prMarkerCreate.storeMarkerIn for immediate follow-up. The implementation reads the complete marker list and checks getType(); it does not rely on the repaired native getMarkers(filters) behavior or require a new 26.5-only capability. With no type filter it does not call getType(), preserving existing behavior and inclusion of future/unknown native types. Owner and returned-marker READ permissions remain unchanged. This expression neither commits grouped Actions nor mutates markers. Time overlap is checked before reading types. For in-range markers, missing getType() fails with an explicit capability error and native type-read failures propagate. Known native type spellings are normalized for case/whitespace only; unrelated native names are not guessed. The Adobe sample and existing create/type enum use FLVCUEPOINT; its native spelling is FLVCuePoint. The current API setter documentation also names Segmentation. Omen Windows Beta 27.0 probes confirmed both as distinct native types with separate GUID-matched filter results. Do not alias them. Live-verified on Windows Beta 27.0 for Sequence and clip owners; exact 26.5 and macOS remain unverified. Canonical expression: {"type":"prListMarkers","inputs":{"owner":{"var":"sequenceRef"},"types":["Comment","WebLink"],"fromSeconds":0,"toSeconds":60}}. If fromSeconds and/or toSeconds are provided, the block limits its work to that time range.

Inputs

Input	Required	Value Kind	Types	Enum Values
owner	yes	expression	reference, premiere-pathspec-string	—
fromSeconds	no	expression	number	—
toSeconds	no	expression	number	—
types	no	expression	array	—

Notes

• Optional types evaluates to a list of Comment, Chapter, Segmentation, WebLink, FLVCuePoint strings, ignoring case and surrounding whitespace. Existing enum tokens COMMENT, CHAPTER, WEBLINK, FLVCUEPOINT work directly. Omitted or empty lists include all types; scalar strings, null, unknown names and non-string entries fail. Duplicates have no effect.
• Type filtering combines with the existing inclusive time-overlap filter. Results retain full-list indices, including positions skipped for invalid native entries; indices are never renumbered after filtering.
• Consume these refs immediately. Insertion, deletion or reordering (including moving a marker) can change full-list indices. Relist after structural changes; this is not durable marker identity. For a newly created marker, use prMarkerCreate.storeMarkerIn for immediate follow-up.
• The implementation reads the complete marker list and checks getType(); it does not rely on the repaired native getMarkers(filters) behavior or require a new 26.5-only capability. With no type filter it does not call getType(), preserving existing behavior and inclusion of future/unknown native types.
• Owner and returned-marker READ permissions remain unchanged. This expression neither commits grouped Actions nor mutates markers. Time overlap is checked before reading types. For in-range markers, missing getType() fails with an explicit capability error and native type-read failures propagate. Known native type spellings are normalized for case/whitespace only; unrelated native names are not guessed.
• The Adobe sample and existing create/type enum use FLVCUEPOINT; its native spelling is FLVCuePoint. The current API setter documentation also names Segmentation. Omen Windows Beta 27.0 probes confirmed both as distinct native types with separate GUID-matched filter results. Do not alias them. Live-verified on Windows Beta 27.0 for Sequence and clip owners; exact 26.5 and macOS remain unverified.

Canonical expression: {"type":"prListMarkers","inputs":{"owner":{"var":"sequenceRef"},"types":["Comment","WebLink"],"fromSeconds":0,"toSeconds":60}}.

See Also

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

Examples

List Sequence Markers By Type

Choose a type and list matching sequence markers with start times, names and a count in the run log; no marker changes.

kind: Recipe · format: persisted-document · validation: Schema only

Topics: markers, marker types, read-only reporting

Source: recipes/ex-markers-list-sequence-by-type.json

Download JSON