# Exporting Annotations

Administrators and project managers can create and download an export of all annotations performed in a project on Ango Hub.

{% hint style="warning" %}
If the project you are attempting to obtain the export for contains individual videos with more than \~50k annotated frames, in order to obtain the export for that video, you must enable the *Only Key Frames* option to attempt to reduce the number of annotations that are exported.

Exporting videos with more than 50k frames, each with annotations, would require manual intervention from the dev team. Please contact us in case this is required.
{% endhint %}

## Getting your Export

### Whole Project / Selected Batches / Selected Stages

Enter your project's *Export* tab. The *Export* button at the bottom will allow you to download your annotations.

You may filter by certain stages or batches, and pick what fields you'd like to obtain in the export.

<figure><img src="https://3895963154-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FTcOUG6rfWxqGM0N4db2P%2Fuploads%2FDakJgcAmBPKigpFtEmkC%2Fimage.png?alt=media&#x26;token=14eb69d8-40c0-4b97-a670-68368fd3a773" alt=""><figcaption></figcaption></figure>

You will receive a notification within Ango Hub when the export is ready. You may navigate away from the page while the export is being prepared.

### Selected Tasks

From the Tasks tab, select the tasks you'd like to export. Then, from the *items* dropdown, select Export.

<figure><img src="https://3895963154-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FTcOUG6rfWxqGM0N4db2P%2Fuploads%2FIzCDuDTBxJuPNt5XvAj0%2Floreshot-20251118-103017%402x.png?alt=media&#x26;token=83cc42a6-035c-461c-aa2c-77100eaab4e0" alt="" width="563"><figcaption></figcaption></figure>

## Using Custom Private Buckets for Exports

By default, after Ango Hub has computed the export, it uploads it to iMerit's own private bucket, and presents it to you as a signed URL from which you will be able to download it. When you click on the link, you are downloading the export as it is found in iMerit's private bucket.

In case this is not an option for you for data security reasons, or if you'd like to automatically collect your exports in a private bucket of your choice, you may have Ango Hub send the export to a bucket of your choice instead of iMerit's. Here are the steps to accomplish this:

1. From your project's dashboard, navigate to the *Settings* tab, then enter the *General* section.
2. Enable the *Export Storage* toggle. The Export Storage details will appear:

<figure><img src="https://3895963154-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FTcOUG6rfWxqGM0N4db2P%2Fuploads%2Fe7JB1X50JZWxH37KPTUC%2Fimage.png?alt=media&#x26;token=f16c2045-e93f-4c0e-ade1-bbc9afd48777" alt="" width="375"><figcaption></figcaption></figure>

3. Pick a storage from the first dropdown. If you have not yet set up a storage within Ango Hub, please follow [this guide](https://docs.imerit.net/data/storages/importing-private-cloud-assets-aws) for AWS S3 and [this guide](https://docs.imerit.net/data/storages/importing-private-cloud-assets-gcp) for Google Cloud Platform.
4. In the *Bucket* field, enter the name of the bucket where you'd like to receive your exports.
5. In the *Path* field, enter the folder where you'd like to receive your exports, followed by slashes and names of subfolders if any. Folders will be created if they do not exist.

{% hint style="info" %}
For example, to obtain your exports in a folder called `exports` located on the root of your bucket, simply write `exports`. To get them in a subfolder of `exports` called `2023`, write `exports/2023`.
{% endhint %}

6. Click on *Save* at the bottom of the page.

Now, when you obtain the export in this project, the export .zip file will be created directly within the bucket you specified, and when you click on the notification to download it, you will be downloading it directly from your own bucket. This also includes exports obtained from [export-type](https://docs.imerit.net/plugins/plugin-developer-documentation/export-plugins) plugins.

{% hint style="info" %}
For exports obtained with Export Plugins, Hub will save to the bucket both the original export in [Ango Export Format](https://docs.imerit.net/data/importing-and-exporting-annotations/exporting-annotations/ango-export-format) and the converted export.
{% endhint %}

## Export Options

### Export Format

You can download your export in the JSON, NDJSON, and NDJSON (Split) formats.

For more details on our export format, please consult the docs page on the [Ango Export Format](https://docs.imerit.net/data/importing-and-exporting-annotations/exporting-annotations/ango-export-format).

{% hint style="info" %}
If you need to download your export in more, different formats, we recommend you use our [Export Converter Plugins](https://docs.imerit.net/plugins/first-party-ango-plugins/ango-export-converter-plugins).

We have developed the JSON export format to be as easy to parse and convert to other formats as possible. If you need your annotations in a format that is not supported by our plugins and you are a paid customer, contact us and we will provide you a script to convert our JSON export to the format of your choice.
{% endhint %}

### Stage

By default, the export will contain only tasks in the *Complete* stage. From this field, however, you can pick the stages you wish to get the export for.

### Fields

<figure><img src="https://3895963154-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FTcOUG6rfWxqGM0N4db2P%2Fuploads%2FHlkkoomKekdOIrPRfFPr%2Fimage.png?alt=media&#x26;token=134ead6d-8f7b-4899-bb4d-4cbd550481eb" alt=""><figcaption></figcaption></figure>

Click on the checkboxes next to the desired fields to include them in the export. Details of each toggle are as follows:

<table data-full-width="true"><thead><tr><th width="168">Toggle</th><th width="246">Description</th><th>Format</th></tr></thead><tbody><tr><td>Annotation Metadata</td><td>Metadata regarding each individual annotation in the task.</td><td><pre class="language-json"><code class="lang-json">"metadata": {
  "createdAt": "2023-02-02T08:06:03.263Z",
  "createdBy": "Lorenzo Gravina",
  "updatedAt": "2023-02-02T08:06:07.276Z",
  "updatedBy": "Lorenzo Gravina"
}
</code></pre></td></tr><tr><td>Stage History</td><td>Object containing, for each task, its stage history, so which stages it has traveled through and for how long.</td><td><pre class="language-json"><code class="lang-json">"stageHistory": [
        {
          "_id": "64774fb6e58cac001554d9e0",
          "stageId": "Start",
          "duration": 0,
          "completedAt": "2023-05-31T13:46:30.942Z",
          "stageName": "Start"
        },
        {
          "_id": "64774fc8e58cac001554da05",
          "stageId": "bd112eb0-a8e4-418b-b1fb-fa728316e36e",
          "taskHistory": "64774fc8e58cac001554da03",
          "duration": 11893,
          "submittedBy": "example@ango.ai",
          "completedAt": "2023-05-31T13:46:48.358Z",
          "completedBy": "example@ango.ai",
          "consensusId": "d3292fa9-4b8c-4237-86f0-8e8a79adfb4b",
          "stageName": "Consensus_1"
        },
        {
          "_id": "64774fe2e58cac001554da5d",
          "stageId": "4758ed37-61c7-4a63-8362-fd36cf48e14f",
          "taskHistory": "64774fe2e58cac001554da5b",
          "duration": 18734,
          "submittedBy": "example@ango.ai",
          "completedAt": "2023-05-31T13:47:14.883Z",
          "completedBy": "example@ango.ai",
          "consensusId": "d3292fa9-4b8c-4237-86f0-8e8a79adfb4b",
          "stageName": "Consensus_2"
        }
      ]
</code></pre></td></tr><tr><td>Only Key Frames</td><td>When toggled, for video assets, only include key frames. Do not include interpolation frames.<br><br>In other words, the export will only include frames in which a tool or frame-specific classification has been edited or toggled on/off.</td><td></td></tr></tbody></table>

#### Send Link as an Email

When this is active, you will receive an email with a link to your export when it is ready.

## Export History

From the Export tab of a project, by clicking on the *Export History* section, you may access a history of the exports that have been obtained for that project before and redownload them.

<div data-with-frame="true"><figure><img src="https://3895963154-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FTcOUG6rfWxqGM0N4db2P%2Fuploads%2Fw0yT35iMfri7SUSnM5uN%2Fimage.png?alt=media&#x26;token=12d7e2eb-02c9-48bc-bdc6-838253c6afd3" alt=""><figcaption><p>Export History</p></figcaption></figure></div>

### Sample Export

{% file src="<https://3895963154-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FTcOUG6rfWxqGM0N4db2P%2Fuploads%2FCTnEKI6pQju5GQ84xwUu%2FComplete_Export-export-2023-09-01-13_11_48_GMT_v3.json?alt=media&token=86a12dfc-4635-485e-b779-248b2a7487a3>" %}