Skip to content

docs: Upate Export page supported formats #8684

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
wants to merge 3 commits into
base: develop
Choose a base branch
from
+34 −3
Open

docs: Upate Export page supported formats #8684

Changes from all commits
Commits
Show all changes
3 commits
Select commit Hold shift + click to select a range
2ae8c28
docs: Upate Export page supported formats
caitlinwheeless Oct 21, 2025
10e1486
add line break
caitlinwheeless Oct 21, 2025
743b72d
add link to note
caitlinwheeless Oct 21, 2025
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
37 changes: 34 additions & 3 deletions docs/source/guide/export.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -107,6 +107,33 @@ For a large labeling project with hundreds of thousands of tasks, do the followi

Label Studio supports many common and standard formats for exporting completed labeling tasks. If you don't see a format that works for you, you can contribute one. For more information, see the [GitHub repository for the Label Studio Converter tool](https://github.com/HumanSignal/label-studio-converter).


#### Text, audio, and video tags

| Export Format | Text | Audio | Labels | Choices | TextArea | TimeSeries | Video | Comments |
Copy link
Member

@makseq makseq Nov 7, 2025

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Let's group it by object and control tags

|---------------|------|-------|--------|---------|----------|------------|-------|----------|
| **ASR_MANIFEST** | ❌ | ✅ | ❌ | ❌ | ✅ | ❌ | ❌ | Audio + TextArea only |
| **CoNLL2003** | ✅ | ❌ | ✅ | ❌ | ❌ | ❌ | ❌ | Text + Labels only |
| **CSV** | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | All project types |
| **JSON** | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | All project types |
| **JSON_MIN** | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | All project types |
| **spaCy** | ✅ | ❌ | ✅ | ❌ | ❌ | ❌ | ❌ | Text + Labels (via CoNLL2003) |
| **TSV** | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | All project types |

#### Image segmentation tags

| Export Format | BrushLabels | RectangleLabels | KeyPointLabels | PolygonLabels | Comments |
|---------------|-------------|-----------------|----------------|---------------|----------|
| **NumPy** | ✅ | ❌ | ❌ | ❌ | |
| **COCO** | ✅ | ✅ | ✅ | ✅ | See [note](#kpl-note) on KeyPointLabels |
Copy link
Member

@makseq makseq Nov 7, 2025

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
| **COCO** | ✅ | ✅ | ✅ | ✅ | See [note](#kpl-note) on KeyPointLabels |
| **COCO** | ✅* | ✅ | ✅ | ✅ | See [note](#kpl-note) on KeyPointLabels |

Let's add a wildcard and a note after this table:

    • brush mask will be converted to polygons.
image

| **CSV** | ✅ | ✅ | ✅ | ✅ | All project types |
| **JSON** | ✅ | ✅ | ✅ | ✅ | All project types |
| **JSON_MIN** | ✅ | ✅ | ✅ | ✅ | All project types |
| **Pascal VOC XML** | ❌ | ✅ | ❌ | ❌ | RectangleLabels only |
| **TSV** | ✅ | ✅ | ✅ | ✅ | All project types |
| **YOLO** | ❌ | ✅ | ✅ | ✅ | See [note](#kpl-note) on KeyPointLabels |
Copy link
Member

@makseq makseq Nov 7, 2025

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

please check the text where this link points;
image



### ASR_MANIFEST

Export audio transcription labels for automatic speech recognition as the JSON manifest format expected by [NVIDIA NeMo models](https://docs.nvidia.com/deeplearning/nemo/user-guide/docs/en/stable/core/core.html). Supports audio transcription labeling projects that use the `Audio` tag with the `TextArea` tag.
Expand All @@ -115,16 +142,20 @@ Export audio transcription labels for automatic speech recognition as the JSON m
{“audio_filepath”: “/path/to/audio.wav”, “text”: “the transcription”, “offset”: 301.75, “duration”: 0.82, “utt”: “utterance_id”, “ctm_utt”: “en_4156”, “side”: “A”}
```

### Brush labels to NumPy and PNG
### BrushLabels to NumPy and PNG

Export your brush mask labels as NumPy 2d arrays and PNG images. Each label outputs as one image. Supports brush labeling image projects that use the `BrushLabels` tag.

### COCO

A popular machine learning format used by the [COCO dataset](http://cocodataset.org/#home) for object detection and image segmentation tasks. Supports bounding box and polygon image labeling projects that use the `BrushLabels`, `RectangleLabels`, `KeyPointLabels` (see note below), or `PolygonLabels` tags.

!!! note "BrushLabels"
For annotations with BrushLabels, the BrushLabels masks are automatically converted to polygons on export.

<br />

{% details <b>KeyPointLabels Export Support</b> %}
{% details <b id="kpl-note">KeyPointLabels Export Support</b> %}

If using `KeyPointLabels`, you will need to add the following to your labeling config:

Expand Down Expand Up @@ -326,7 +357,7 @@ Results are stored in a tab-separated tabular file with column names specified b

### YOLO

Export object detection annotations in the YOLOv3 and YOLOv4 format. Supports object detection labeling projects that use the `RectangleLabels` and `KeyPointLabels` tags.
Export object detection annotations in the YOLOv3 and YOLOv4 format. Supports object detection labeling projects that use the `RectangleLabels`, `PolygonLabels`, and `KeyPointLabels` tags.

!!! note
If using KeyPointLabels, see the note under [COCO](#COCO).
Expand Down
Loading