> For the complete documentation index, see [llms.txt](https://docs.imerit.net/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.imerit.net/plugins/first-party-ango-plugins/stage-export.md).

# Stage Export

## Overview

The Stage Export plugin is an export plugin that downloads workflow-stage activity and annotation-count information for your project.

Use this plugin when you need a CSV report showing which stages a task passed through, who labeled or reviewed it, how long work took, and how many labels were present at each stage.

<table data-card-size="large" data-view="cards"><thead><tr><th align="center"></th><th data-hidden data-card-cover data-type="image">Cover image</th></tr></thead><tbody><tr><td align="center">Stage Export</td><td data-object-fit="contain"><a href="/files/hhDBkC0Fd1zMsBEpSQn4">/files/hhDBkC0Fd1zMsBEpSQn4</a></td></tr></tbody></table>

## Plugin Functionality

The Stage Export plugin creates a ZIP file containing a CSV report for the selected tasks.

The export includes:

* Batch
* Stage
* External ID
* Task ID
* Labeler and reviewer names by stage
* Labeling and review dates, start times, end times, and durations
* Review task status by review stage
* Number of pages
* Counts of classifications, tools, tool classifications, and relations by stage
* Optional classification answer columns by stage

When both `gold_stage` and `evaluation_stage` are provided, the plugin also adds label comparison metrics between the two stages, including accepted labels, fixed labels, precision, recall, and accuracy.

## Plugin Configuration

From the **Stage Filter** field, pick the stages containing the tasks you'd like to export. Similarly, from the **Batch Filter** field, you may select one or more batches. By default, all tasks are exported from all batches.

If you wish to receive an email when the export is complete, toggle **Send Email** on.

You may vary a number of settings related to your export from the **Config JSON** field. Each option is detailed below:

```json
{
  "start_date": "2020-12-31",
  "end_date": null,
  "duration_unit": "sec",
  "gold_stage": null,
  "evaluation_stage": null,
  "ignored_schema_ids": [],
  "include_key_frames_only": true,
  "logging_frequency": 0
}
```

* **"start\_date":** Start date for filtering stage history included in the export (YYYY-MM-DD).
  * Example:
    * <kbd>"start\_date": "2020-12-31"</kbd>

* **"end\_date":** End date for filtering stage history included in the export (YYYY-MM-DD).
  * Example:
    * <kbd>"end\_date": "2021-12-31"</kbd>

* **"duration\_unit":** Unit used for duration columns.
  * Example:
    * <kbd>"duration\_unit": "sec"</kbd>

* **"gold\_stage":** Optional stage used as the reference stage for comparison metrics.
  * Example:
    * <kbd>"gold\_stage": "Review"</kbd>

* **"evaluation\_stage":** Optional stage evaluated against the gold stage.
  * Example:
    * <kbd>"evaluation\_stage": "Label"</kbd>

* **"ignored\_schema\_ids":** List of schema IDs to exclude from the stage comparison metrics.
  * Example:
    * <kbd>"ignored\_schema\_ids": \["12345", "12346"]</kbd>

* **"include\_key\_frames\_only":** Included in the default configuration for consistency with video export plugins. The Stage Export plugin exports stage and annotation-count data from the selected export scope.
  * Example:
    * <kbd>"include\_key\_frames\_only": true</kbd>&#x20;

* **"logging\_frequency":** Defines how frequently progress logs are displayed; setting this value to 0 disables progress-frequency logging.
  * Example:
    * <kbd>"logging\_frequency": 0</kbd>
    * <kbd>"logging\_frequency": 100</kbd>
