Migration guide: Export V1 to Export V2

General information about the Export V1 deprecation and the advantages of moving to Export V2.

Starting in April 2024, we will begin sunsetting Export V1 for UI and SDK for customers on a rolling basis. We encourage you to start transitioning your export workflows to using export(), an improved method and format for exporting your data from Labelbox. You need to update your internal workflows to use the new export() method. Please look out for email notifications regarding sunset dates for your tier.

Export V2 offers the following advantages:

  1. More granular control over your data exports across the Labelbox platform and SDK, more data fields to export, and better robustness and performance.
  2. Ability to export specific data rows using the filters in Catalog and Annotate. For example, you can select only the data rows that have received new labels, metadata, or issues updates within the last 24 hours.

For more details, see this google colab notebook.

Deprecated SDK methods

The following Export V1 methods are deprecated and will be sunsetted in 2024. Labelbox will notify you of your sunset date based on your tier (see dates above).

  • project.export_labels()
  • project.label_generator()
  • project.export_queued_data_rows()
  • project.video_label_generator()
  • dataset.export_data_rows()
  • batch.export_data_rows()
  • model_run.export_labels()

To learn which methods to use instead, visit this Google Colab notebook.

Fields and path mapping

To view a mapping of the Export v1 fields/paths to the equivalent fields/paths in export(), view this sheet.

Comparison

Export V1Export V2
StructureLabel-centricData row-centric
Export sourceAnnotate onlyCatalog, Model, Annotate
FiltersNoneModel run filters, Catalog filters, Data row tab filters, last_activity_at, label_created_at, data_row_ids
Customizable export payloadNot supportedSupported via filters
Naming conventionPascal caseSnake case

To see a more detailed comparison of Export V1 and Export V2, visit this Google Colab notebook. To learn more about the advantages of Export V2, see Export overview.

How to use export()

To learn how to export your data rows from a project via the UI, go to Export labels from project guide.

To learn how to export your data rows via the Python SDK, go to our Export overview developer guide.

Sample projects

Media typeProject exportModel run export
ImageSee sampleSee sample
VideoSee sampleSee sample
TextSee sampleSee sample
GeospatialSee sampleSee sample
DocumentsSee sampleSee sample
Conversational textSee sampleSee sample
AudioSee sampleNot supported
HTMLSee sampleSee sample
DICOMSee sampleNot supported
LLM human preferenceSee sampleNot supported

FAQ

What does this mean for projects that were created before export() was released?

This deprecation of exports v1 will not impact your existing projects.

What will happen on the sunset date? Will I be able to use Labelbox that day?

Yes. Labelbox will disable Export V1 on the specified dates for each tier. You can still use Labelbox on the dates we disable Export V1 for your tier.