> 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/csv-export-for-tools.md).

# CSV Export for Tools

## Overview

The CSV Export for Tools plugin is an export plugin that downloads annotations, classifications, and relations from your project in a tabular CSV format.

Use this plugin when you need a flat spreadsheet-friendly export of labeling results, including tool names, schema IDs, object IDs, answers, and optional page-level information for video and multi-page assets.

<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">CSV Export for Tools</td><td data-object-fit="contain"><a href="/files/SgWsHzWMOLB1EjjrL4BD">/files/SgWsHzWMOLB1EjjrL4BD</a></td></tr></tbody></table>

## Plugin Functionality

The CSV Export for Tools plugin creates a ZIP file containing a CSV export of the selected tasks.

The export includes:

* Batch
* External ID
* Task ID
* Schema ID
* Object ID
* Type, such as tools, classifications, or relations
* Annotation type
* Tool tree
* Answer

For video and multi-page assets, the export also includes page and file-name columns when page information is available. For NER annotations, the export includes the start index, end index, and selected text.

### Supported Data Types

* Compatible with all data types supported by the included annotation tools.

### Supported Annotation Tools

* Bounding Box
* Rotated Bounding Box
* Polygon
* Segmentation
* Brush
* Polyline
* Spline
* Point
* PDF
* Entity
* Classifications
* Relations

## 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 whose tasks will be exported. 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
{
  "include_key_frames_only": true,
  "additional_attribute_name": null,
  "verbose": false,
  "verbose_frequency": 1000
}
```

* **"include\_key\_frames\_only":** Included in the default configuration for consistency with video export plugins. The CSV Export for Tools plugin exports the annotation data it receives from the selected export scope.
  * Example:
    * <kbd>"include\_key\_frames\_only": true</kbd>
    * <kbd>"include\_key\_frames\_only": false</kbd>

* **"additional\_attribute\_name":** Defines an optional nested classification name to include as an additional attribute column for tool annotations and relation rows.
  * Example:
    * <kbd>"additional\_attribute\_name": null</kbd>
    * <kbd>"additional\_attribute\_name": "Object ID"</kbd>

* **"verbose":** Enables progress logs while the export is running.
  * Example:
    * <kbd>"verbose": true</kbd>
    * <kbd>"verbose": false</kbd>

* **"verbose\_frequency":** Defines how frequently progress logs are displayed when verbose logging is enabled.
  * Example:
    * <kbd>"verbose\_frequency": 1000</kbd>