# Session-specific progress

**URL:** <https://support.prodi.gy/t/session-specific-progress/7656>\
**Category:** Uncategorized\
**Tags:** usage, progress\
**Created:** [March 16, 2026, 7:02pm UTC](https://support.prodi.gy/t/session-specific-progress/7656 "2026-03-16T19:02:34Z")\
**Posts on this page:** 3\
**Page:** 1

<div class="post-metadata">

**Author:** ![laurejt](https://avatars.discourse-cdn.com/v4/letter/l/b19c9b/32.png) [@laurejt](https://support.prodi.gy/u/laurejt)\
**Post date:** [March 16, 2026, 7:02pm UTC](https://support.prodi.gy/t/session-specific-progress/7656/1 "2026-03-16T19:02:34Z")

</div>

I’m hoping to understand a bit more about customizing the progress reporting within the web app.

In my scenario, I’m using custom task routing to ensure that examples are assigned to multiple annotators from a specific sub-pool of annotators (based on example metadata). This means that each annotator (i.e., session) can be assigned wildly different number of annotations (due to the imbalance of the input data). So, I was hoping I could customize the progress reporting so that it would better reflect each annotator’s actual progress.

It looks like the controller’s `get_progress` function reports the specific progress for a given `session_id`, but it doesn’t look like the customizable `progress`callback has access to this `session_id`, so I’m at a loss on how session-specific progress could be reported. Is there something I’m missing about how progress reporting within the web app works?

---

<div class="post-metadata">

**Author:** ![laurejt](https://avatars.discourse-cdn.com/v4/letter/l/b19c9b/32.png) [@laurejt](https://support.prodi.gy/u/laurejt)\
**Post date:** [March 17, 2026, 6:16pm UTC](https://support.prodi.gy/t/session-specific-progress/7656/2 "2026-03-17T18:16:04Z")

</div>

I believe I may have figured it out by looking at the source code. It looks like the signature for the progress function has been updated so that it takes four inputs rather than two with the second input being the session in question.

---

<div class="post-metadata">

**Author:** ![magdaaniol](https://sea2.discourse-cdn.com/flex020/user_avatar/support.prodi.gy/magdaaniol/32/2787_2.png) [@magdaaniol](https://support.prodi.gy/u/magdaaniol)\
**Post date:** [March 17, 2026, 6:54pm UTC](https://support.prodi.gy/t/session-specific-progress/7656/3 "2026-03-17T18:54:06Z")

</div>

Hi @laurejt,

You're totally right! I was about to say that the progress callback actually supports an extended signature that gives you access to the current session. This was added as part of an internal refactor to make progress tracking work correctly in multi-session setups, but we hadn't documented it yet — the original 2-argument signature still works and covers the common case. Since you're using custom task routing, you're exactly the kind of user who needs it.

You have already seen it, but for completeness in case other users come across this post: if your progress function accepts four arguments instead of two, Prodigy will pass the current `Session` object and the list of answers that were just received:

```python
  def progress(ctrl, session, answers, update_return_value):
      target = get_target_for_session(session.id)
      return session.total_annotated / target

```

The session object gives:

- `session.id` — the current annotator's session ID
- `session.total_annotated` — total annotations for this session
- `session.session_annotated` — annotations in the current server run

Prodigy auto-detects which signature you're using — no extra configuration needed. Under the hood, the old 2-argument signature is wrapped to match the new one (see `_translate_old_progress_protocol` in the source), so the session is always there; the old signature just doesn't expose it.

We've now added this to the docs as well — see the [extended progress signature](https://prodi.gy/docs/custom-recipes#progress-extended).
