---
title: "Progress Indicators"
description: "Jobs can now report user-defined progress indicators with a done-and-total model."
image: "https://tilebox.com/images/tilebox-docs-social-preview.png"
---

> Documentation Index
> Fetch the complete documentation index at: https://tilebox.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Progress Indicators

import { Frame } from "@docs/components/ui/frame";
import { CardGrid } from "@docs/components/ui/card-grid";
import { LinkCard } from "@docs/components/ui/link-card";

![Progress Indicators](/docs/assets/changelog/2025-09-progress-indicators.png)

Jobs can now report user-defined progress indicators using a `done` / `total` model. Track units that describe your workload, such as scenes processed or files uploaded, rather than using the number of completed tasks as a proxy.

Call `add()` to increase the total work and `done()` to increase the completed work. Updates are reported by individual tasks and summed across the job, so a parent can register the total and its subtasks can report completion:

```python
# In the parent task, before submitting one subtask per scene:
context.progress("scenes").add(len(scene_ids))

# In each subtask, after successfully processing its scene:
context.progress("scenes").done(1)
```

These are increments, not absolute counter values. Use the same indicator name in the parent and subtasks to aggregate their updates. Separate names, such as `"scenes"` and `"uploads"`, create independent indicators; `context.progress()` selects the default indicator.

    Track completed work and combine updates from multiple tasks.

Source: https://tilebox.com/docs/changelog/2025-09-03-progress-indicators/index.mdx