New Progress Type for Live Activities

Live Activities now support a second activity type: progress.

Use progress when the work is naturally continuous instead of step-based.

It fits EV charging, file transfers, data sync progress, imports, downloads, uploads, and any job where a percentage or numeric range is clearer than "step 2 of 4".

What’s new

• New progress type for Live Activities.
• Send either percentage or value with upper_limit.
• Keep using segmented_progress for step-based workflows.
• segmented_progress still supports dynamic number_of_steps during update and end calls.

Choose the right type

• segmented_progress: best for jobs tracked in steps.
• progress: best for jobs tracked as a percentage or numeric range.

Lifecycle

The lifecycle stays the same:

1. Start the activity.
2. Save the returned activity_id.
3. Update it as progress changes.
4. End it when the work is finished.

Start Live Activity

1
{
2
  "content_state": {
3
    "title": "EV Charging",
4
    "subtitle": "Added 30 mi range",
5
    "percentage": 15,
6
    "type": "progress",
7
    "color": "lime"
8
  }
9
}

Update Live Activity

1
{
2
  "content_state": {
3
    "title": "EV Charging",
4
    "subtitle": "Added 120 mi range",
5
    "percentage": 60
6
  }
7
}

End Live Activity

1
{
2
  "content_state": {
3
    "title": "EV Charging",
4
    "subtitle": "Added 200 mi range",
5
    "percentage": 100,
6
    "auto_dismiss_minutes": 2
7
  }
8
}

Numeric range example

1
{
2
  "content_state": {
3
    "title": "Data Sync",
4
    "subtitle": "241 of 360 records synced",
5
    "value": 241,
6
    "upper_limit": 360,
7
    "type": "progress",
8
    "color": "blue"
9
  }
10
}

Availability

Available now across the API, SDKs, CLI, GitHub Action, and ActivitySmith skill.

This feature is available in the ActivitySmith iOS app version 1.2.0 and newer.