Skip to main content
In Labelbox, a “batch” is a group of data rows that you send from your Catalog to a project for labeling. Using batches gives you more control and flexibility over your labeling workflow.

​
How to send a batch to a labeling project

Follow these steps to send a group of data rows to a labeling project:
  1. Navigate to the Catalog and use the filters to select the data rows you want to include in your batch.
  2. Once you have selected the data rows, click the Manage selection dropdown menu and select Send to Annotate.
  3. In the Configure batch window, you will need to:
    1. Choose the project you want to send the batch to.
    2. Set a priority for the batch. A priority of 1 is the highest and 5 is the lowest. This will determine the order the data rows are placed in the labeling queue.
    3. Enable or disable Consensus for the batch. If you enable Consensus, you will need to set a % Coverage to indicate the percentage of data rows that will be queued for labeling by multiple labelers, and a # Labels value to indicate how many labels can be added to the data row.
    4. Click Submit. Any data rows that have already been submitted to the labeling project will be excluded from the batch.
LimitsSee this page to learn the limits for sending batches to a project.

​
How to create a batch by sampling

Sampling is a useful technique for creating a batch when you are working with a large amount of data. Instead of manually selecting data rows, you can use sampling to create a batch of a specific size.
  1. In the Catalog, use the filters to find the data rows you want to sample from.
  2. Click the Sample button in the top right corner.
  3. In the batch creation window, you can choose how many data rows to sample and the sampling method. Labelbox supports two sampling methods:
    • Random: This method will randomly select the specified number of data rows from your filtered results.
    • Ordered: This method will select the specified number of data rows based on the sorted order of the results. You can sort the results by the Created At timestamp in ascending or descending order.
      The sequence generated by ordered sampling does not influence the sequence of the data rows in the labeling queue.
  4. Fill out the project, batch name, and priority details.
  5. Click Submit batch.

​
How to send predictions as pre-labels

To speed up the labeling process, you can include model predictions as pre-labels in your batch.
  1. In the batch creation window, toggle the Include predictions option on.
  2. From the dropdown menu, select the model run and the specific predictions you want to include in the batch.
  3. Confirm that the model run is compatible with the labeling project. For the predictions to be compatible, the features in the model run ontology and the labeling project ontology must be the same. If the model run and the labeling project do not share any features, you will not be able to send the predictions as pre-labels.
  4. Click Submit batch.

​
Important considerations

  • Media type compatibility: You can only send a batch to a project that has the same media type. For example, you cannot send a batch of text data to a project that is set up for labeling images.
  • Appending to batches: Once a batch has been sent to a project, you cannot add more data rows to it.
  • Data rows in multiple batches: A data row cannot be in more than one batch in the same project at the same time.
  • Sharing batches: A batch cannot be shared between projects. However, you can create a new batch with the same data rows and send it to a different project.