# Export Project

The available formats depend on the[ ](https://docs.datasaur.ai/data-studio-projects/creating-a-project)[task type](https://datasaurai.gitbook.io/datasaur/nlp-projects/nlp-task-types), as described in the table below. Click on any format to see a detailed explanation of the file structure Datasaur expects.

| **Task Type**                                   | **Export Formats**                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                       |
| ----------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Span Labeling**                               | [.csv](https://docs.datasaur.ai/compatibility-and-updates/supported-formats#csv), [.tsv](https://docs.datasaur.ai/compatibility-and-updates/supported-formats#tsv), [.json](https://docs.datasaur.ai/compatibility-and-updates/supported-formats#json), [.json\_advanced](https://docs.datasaur.ai/compatibility-and-updates/supported-formats#json_advanced), [.conll\_2003](https://docs.datasaur.ai/compatibility-and-updates/supported-formats#conll_2003), [.tsv\_non\_iob](https://docs.datasaur.ai/compatibility-and-updates/supported-formats#tsv_non_iob), [Datasaur Schema (.json)](https://datasaurai.gitbook.io/datasaur/compatibility-and-updates/supported-formats#datasaur-schema-format) |
| **Span Labeling with arrows**                   | [.json\_advanced](https://docs.datasaur.ai/compatibility-and-updates/supported-formats#json_advanced), [.conllu](https://docs.datasaur.ai/compatibility-and-updates/supported-formats#conll-u), [.tsv\_non\_iob](https://docs.datasaur.ai/compatibility-and-updates/supported-formats#tsv_non_iob), [Datasaur Schema (.json)](https://datasaurai.gitbook.io/datasaur/compatibility-and-updates/supported-formats#datasaur-schema-format)                                                                                                                                                                                                                                                                 |
| **Span Labeling with character-based labeling** | [.json\_advanced](https://docs.datasaur.ai/compatibility-and-updates/supported-formats#json_advanced), [Datasaur Schema (.json)](https://datasaurai.gitbook.io/datasaur/compatibility-and-updates/supported-formats#datasaur-schema-format)                                                                                                                                                                                                                                                                                                                                                                                                                                                              |
| **Row Labeling**                                | [.csv](https://docs.datasaur.ai/compatibility-and-updates/supported-formats#csv), [.tsv](https://docs.datasaur.ai/compatibility-and-updates/supported-formats#tsv), [.xlsx](https://docs.datasaur.ai/compatibility-and-updates/supported-formats#xlsx), [.json\_tabular](https://docs.datasaur.ai/compatibility-and-updates/supported-formats#json_tabular), [Datasaur Schema (.json)](https://datasaurai.gitbook.io/datasaur/compatibility-and-updates/supported-formats#datasaur-schema-format), [JSON Lines (.jsonl)](https://docs.datasaur.ai/compatibility-and-updates/supported-formats#jsonl-json-lines)                                                                                          |
| **Document Labeling**                           | [.csv](https://docs.datasaur.ai/compatibility-and-updates/supported-formats#csv), [.tsv](https://docs.datasaur.ai/compatibility-and-updates/supported-formats#tsv), [.xlsx](https://docs.datasaur.ai/compatibility-and-updates/supported-formats#xlsx), [Datasaur Schema (.json)](https://datasaurai.gitbook.io/datasaur/compatibility-and-updates/supported-formats#datasaur-schema-format)                                                                                                                                                                                                                                                                                                             |
| **Audio Labeling**                              | .json\_advanced, [Datasaur Schema (.json)](https://datasaurai.gitbook.io/datasaur/compatibility-and-updates/supported-formats#datasaur-schema-format), .tsv                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              |
| **Span + Document Labeling (Mixed Label Set)**  | [Datasaur Schema (.json)](https://datasaurai.gitbook.io/datasaur/compatibility-and-updates/supported-formats#datasaur-schema-format)                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                     |
| **Bounding Box Labeling**                       | [Datasaur Schema (.json)](https://datasaurai.gitbook.io/datasaur/compatibility-and-updates/supported-formats#datasaur-schema-format)                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                     |

## How to Export the Project

Both features are supported through API call. Click [here](https://docs.datasaur.ai/api/export-project) for more detailed explanation.

1. Click **File** menu when opening a project.
2. Select either **Export file...** or **Export all files...**

<figure><img src="https://448889121-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MbjY0HseEqu7LtYAt4d%2Fuploads%2Fgit-blob-0c99edcd16b4499693b2a0da169a50592cb5271b%2FProject%20-%20file%20menu%20-%20export.png?alt=media" alt=""><figcaption></figcaption></figure>

* **Export** **file** will only export that **one file** which is currently being opened. The export result will only contain the latest state of the project, not as complete as the one below.
* **Export all files** will export all the files in a project. For projects with multiple assignees, each of their labeled versions will be exported as separate files. The output is in a .zip folder that contains another three folders:
  * DOCUMENT-Labeler-name is a folder containing the version of the file as labeled by Labeler.
  * REVIEW is a folder containing the final copy of all labels, including Datasaur auto-accepted labels and Reviewer applied labels.
  * ROOT is a folder containing only the original raw text, no labels, no edit.

### Include Unresolved Labels / Answers in the Export Result

Users can now include unresolved label or answer inside the export result.

{% hint style="info" %}
It is available for Span, Row, and Document Labeling projects in both Datasaur Schema and Comma-separated values format.
{% endhint %}

#### Enabling the Option

When selecting the supported format, a checkbox option will appear. If it is checked, the result will include the unresolved labels or answers.

![](https://448889121-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MbjY0HseEqu7LtYAt4d%2Fuploads%2Fgit-blob-2d54c653d09c8b2031f2cfd8c9aab2077e7ecad0%2FProject%20-%20export%20all%20files%20dialog.png?alt=media)

#### Export Result

Several things are added when you selected include conflicted label or answers:

* **Comma-separated values (.csv)**
  * **New column: Label Status**

    This column will indicate whether the corresponding line is conflicted or resolved.
  * **New column: Line**

    This column will indicate the line number.
* **Datasaur Schema (.json)**
  * **New value:&#x20;**<mark style="color:red;">**`rowAnswers`**</mark>**,&#x20;**<mark style="color:red;">**`documentAnswers`**</mark>**,&#x20;**<mark style="color:red;">**`spanLabels`**</mark>**,&#x20;**<mark style="color:red;">**`arrowLabels`**</mark>

    The conflicted values will be added to <mark style="color:red;">`rowAnswers`</mark>, <mark style="color:red;">`documentAnswers`</mark>, <mark style="color:red;">`spanLabels`</mark>, or <mark style="color:red;">`arrowLabels`</mark>.

    You can differentiate between resolved and unresolved answer by looking at <mark style="color:red;">`labeledBy`</mark> attribute. Unresolved label should have **CONFLICT** as their <mark style="color:red;">`labeledBy`</mark> value.

The following section will give you some illustration on the result.

* **Span Labeling**
  * **Datasaur Schema (.json)**

    Conflicted labels will be added to <mark style="color:red;">`spanLabels`</mark> or <mark style="color:red;">`arrowLabels`</mark>.
  * **Comma-separated values (.csv)**

    This format is similar to the Amazon Comprehend CSV export format, but with an additional column titled <mark style="color:green;">"Label Status"</mark>.
* **Row and Document Labeling**
  * **Datasaur Schema (.json)**

    Unresolved answer will not be added to the answer set (<mark style="color:red;">`rowAnswerSets`</mark> for Row Labeling, while <mark style="color:red;">`documentAnswerSets`</mark> for Document Labeling)

    However, it will be added to <mark style="color:red;">`rowAnswers`</mark> for Row Labeling, while <mark style="color:red;">`documentAnswers`</mark> for Document Labeling, along with the resolved answers.
  * **Comma-separated values (.csv)**

    Adds <mark style="color:green;">"Label Status"</mark> and <mark style="color:green;">"Line"</mark> column.

    There may be a case where a single line contains both resolved and unresolved answers due to consensus. In such cases, the answers will be separated into two lines: the first for resolved answers, and the second line for unresolved ones.

## Export Methods

When exporting a file, there are multiple options you can choose. Again, all methods are also supported through our [API](https://datasaurai.gitbook.io/datasaur/api/apis-docs).

![](https://448889121-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MbjY0HseEqu7LtYAt4d%2Fuploads%2Fgit-blob-e93cf944562cfbafabd1759ac6bf2f62abbaa274%2FExport%20all%20files%20dialog%20-%20highlight%20export%20method.png?alt=media)

### **Download**

* The export result will uploaded to Datasaur's bucket and you will download it directly to your device through a link.
* Keep in mind that the time needed to generate the link will be directly proportional to the size of the project.

### **Email**

* Datasaur will generate a link which will be sent via email (the one that is currently logged in). The link then can be used to download the export result.
* *Note: the link will **expire in 6 hours**.*

### **Webhook**

* The export result will be sent as a payload of the webhook request.
* For full explanation about this method, please refer to this [page](https://docs.datasaur.ai/api/export-project/custom-webhook).
* *Note: the link will **expire in 6 hours**.*

### **External Object Storage**

* The export result will be directly uploaded to your bucket based on the External Object Storage that you choose.
* You can also add a prefix to the name which will be appended at the start of the export result. Please note that **there will be no trailing /** before appending the prefix with the name. So, if the `prefix` is test and the `fileName` is name.json, the export result will be testname.json.

## Export Multiple Projects from the Project Dashboard

You will be able to export multiple projects of the **same project setting** by clicking the corresponding checkboxes in the project list.

<figure><img src="https://448889121-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MbjY0HseEqu7LtYAt4d%2Fuploads%2Fgit-blob-cf5d6539c06d3fef07a1eb861771c73bdea23cf9%2FProjects%20-%20main%20page%20-%20bulk%20selection.png?alt=media" alt=""><figcaption></figcaption></figure>

By clicking the **Export** button, you can choose the desired project format and the method. The output will be in .zip format.

<figure><img src="https://448889121-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MbjY0HseEqu7LtYAt4d%2Fuploads%2Fgit-blob-2c684b44c9e61b9dcbdc7004d71286bd2fac3a3c%2FProjects%20-%20main%20page%20-%20bulk%20export%20dialog.png?alt=media" alt=""><figcaption></figcaption></figure>

💡 *We recommend you to export up to a maximum of 10 projects at once for performance reasons.*
