Export label format

Updated 1 day ago by Alex Cota

This page describes what is included in the JSON file when you export data from Labelbox.

JSON export format

{
    "ID": "label_id",
    "DataRow ID": "datarow_id",
    "Labeled Data": "url to labeled image",
    "Label": {
        "objects": [],
        "classifications": []
    },
    "Created By": "email of person to edit label",
    "Project Name": "project name",
    "Created At": "date time created",
    "Updated At": "date time updated",
    "Seconds to Label": time in seconds,
    "External ID": datarow external id,
    "Agreement": calculated consensus score,
    "Benchmark Agreement": calculated consensus score against benchmark,
    "Benchmark ID": benchmark label was scored against,
    "Benchmark Reference ID": points to benchmark,
    "Dataset Name": "datasest name",
    "Reviews": [],
    "View Label": "url to label view in interface"
}

Expanding the Label object

In our most recent version of the Image editor, we expanded the Label object to provide more information for each class (annotation). The key change is that, instead of each class name appearing as a key at the root of Label, objects and classifications are now the keys at the root and information for each class is distributed between the two properties.

Objects

The objects property contains the 2D annotation data for each feature on the image. Each feature created by the image segmentation, bounding box, line, and point tools may or may not have a class. Geometric features (bounding box, line, and point) will contain the geometry key in x-y coordinates. Features created by the image segmentation tool will contain an additional instanceURI property.

Classifications

The classifications property contains the image classification data for the image (these are the questions in the UI). The data type for the answer depends on how the image classification was entered: text input will be a string, radio input will be an object, and checkbox or dropdown input will be an array.

Old label format for a bounding box.

//label format for legacy image editor
{ 
    "bounding_box_class_one": [ 
        { 
            // instance one 
            geometry: [ 
                { 
                    x: 10, y: 10 
                }, 
                { 
                    x: 20, y: 10 
                }, 
                { 
                    x: 20, y: 20 
                },
                {
                    x:10, y: 20 
                } 
            ] 
        } 
    ], 
    "text_question": "the text questions answer"
}

New label format for a bounding box.

{ 
    "objects": [ 
        { 
            "featureId": "", 
            "title": "Bounding box class one", 
            "value": "bounding_box_class_one", 
            "featureSchemaId": "[Unique ID of the bbox_class_one class]",
            "bbox": { 
                "top": 10, 
                "left": 10, 
                "height": 10, 
                "width": 10 
            } 
        } 
    ], 
    "classifications": [ 
        { 
            "featureId": "[Unique ID of answer instance to question]",
            "title": "Text Question", 
            "value": "text_question",
            "featureSchemaId": "[Unique ID of the bbox_class_one class]",
            "answer": "the text questions answer"
        } 
    ]
}

Was this page helpful?