Markers

Composition markers for navigation, chapters, and scripting.

Schema

Property	Type	Required	Description
time	number	yes	Time in seconds
comment	string	no	Marker text/label
duration	number	no	Duration for range markers
chapter	string	no	Chapter name
url	string	no	URL link
label	int	no	Color label (0-16)

Basic usage

compositions:
  - name: My Video
    duration: 60
    markers:
      - time: 0
        comment: "Intro"
      - time: 10
        comment: "Section 1"
      - time: 30
        comment: "Section 2"
      - time: 50
        comment: "Outro"

Duration markers

Create range markers with duration:

markers:
  - time: 5
    comment: "Main Content"
    duration: 20  # Marker spans from 5s to 25s

Chapters

Mark chapters for video exports:

markers:
  - time: 0
    comment: "Introduction"
    chapter: "Intro"
  - time: 60
    comment: "Main Topic"
    chapter: "Main"
  - time: 180
    comment: "Conclusion"
    chapter: "End"

URLs

Attach links to markers:

markers:
  - time: 30
    comment: "Learn more"
    url: "https://example.com/more-info"

Color labels

Set marker colors (0-16, matching AE's label colors):

markers:
  - time: 0
    comment: "Start"
    label: 1   # Red
  - time: 10
    comment: "Action"
    label: 9   # Green
  - time: 20
    comment: "End"
    label: 2   # Yellow

Complete example

compositions:
  - name: Tutorial Video
    width: 1920
    height: 1080
    duration: 300
    markers:
      - time: 0
        comment: "Title Card"
        chapter: "Intro"
        label: 1

      - time: 5
        comment: "Welcome"
        duration: 10

      - time: 20
        comment: "Step 1: Setup"
        chapter: "Setup"
        label: 9

      - time: 60
        comment: "Step 2: Configuration"
        chapter: "Config"
        label: 9

      - time: 120
        comment: "Step 3: Usage"
        chapter: "Usage"
        label: 9

      - time: 240
        comment: "Summary"
        chapter: "Summary"
        label: 2

      - time: 280
        comment: "Subscribe link"
        url: "https://youtube.com/@channel"

    layers:
      - name: content
        type: solid
        color: 1a1a2e

Use cases

Video chapters

Export to platforms that support chapters (YouTube, Vimeo):

markers:
  - time: 0
    chapter: "Introduction"
  - time: 60
    chapter: "Main Content"
  - time: 180
    chapter: "Conclusion"

Script sync points

Mark timing for synchronized elements:

markers:
  - time: 2.5
    comment: "Logo appears"
  - time: 5
    comment: "Title animates in"
  - time: 8
    comment: "Transition"

Render regions

Define sections for rendering:

markers:
  - time: 0
    comment: "Scene 1"
    duration: 30
  - time: 30
    comment: "Scene 2"
    duration: 30