DocumentationRecipesReferenceGraphQLChangelog
Log In

Exporting project data

There are two ways to export your labeled project:

  • From the project Queue page, click on the ellipsis icon (…) and then select “Export all labels”.
  • From the project Queue page, select assets whose labels you want to export and then click on the export button in the bottom-right corner of the page.

From the "Export data" popup window, you can customize these export parameters:

Exported label formats

  • Kili API format (zipped JSON file): For details, refer to Exported data format.
  • Simple Kili format (zipped JSON file): Reduced-size format for better readability on simple projects.
  • YOLO formats.

📘

  • If you exported labels from this project before, you will have the option to select from previous. When you select a previous export, all settings and file name will stay the same as before; no need to customize your export again.
  • Each exported zip archive contains an additional file called README.kili.txt with the following data:
    • Project name
    • Project identifier
    • Project description
    • Export date
    • Exported format
    • Scope of exported labels

YOLO formats

YOLOv4 format only works with image or frame asset type projects containing bounding box annotations. Exporting other annotation types to YOLOv4 will fail.

YOLOv5 format only works with image asset type projects containing bounding box annotations. Exporting other annotation types to YOLOv5 will fail.

File named classes.txt (YOLOv4) or data.yaml (YOLOv5) contains IDs and names of all labeling classes used in a job.

The images folder contains all the images (or a list of links to images) from the dataset being exported.

The labels folder contains a list of text files:

  • Each text file contains the list of annotations for the specific image.
  • Each annotation is a line in the text file; it contains the annotation class ID and the coordinates of the bounding box.

Splitting labels per labeling jobs

You can select whether or not you want your labeled assets to be placed in separate folders representing each labeling job.

Here's an example of an exported YOLOv4 file, with One label per asset for each job option selected:

export.zip
|--README.kili.txt
|--images
|--JOB_0
    |--classes.txt
    |--labels

Here's an example of an exported YOLOv4 file, with One label per asset grouping all jobs option selected:

export.zip
|--README.kili.txt
|--classes.txt
|--images
|--labels

Scope of exported labels

  • Latest label (for each asset): a reduced-size format containing the latest label for each asset.
    • The latest label is the most recent label you can trust for your model.
    • The exported file will not contain the whole list of asset labels; just information about the latest label.
  • Latest labels from each author (for each asset): a reduced-size format containing the latest label for each user.

Did this page help you?