Troubleshoot Batch Errors

Explains the two types of batch errors you might see and steps to take if you encounter them.

Review the sections below for possible solutions to errors you encounter when processing orders in a batch.

For a batch to process successfully, all orders in the batch must have their shipping parameters configured correctly. Otherwise, you may encounter errors attempting to create the labels for the batch.

Errors can occur when attempting to process a batch or after the batch has finished processing.

Errors When Processing a Batch

Error message:

The error message will vary depending on the shipment information. Errors when processing a batch prevent the indicated orders from processing successfully.

Why these errors occur:

Typically, these errors have to do with missing, required information like shipping service, package weight, dimensions, or address fields.


  1. Review the error message displayed in the Problem column in the Label Batch Status: Errors and Warning pop-up.

  2. Click the order number for the order you wish to update. This will open the Order Details screen for the order.

  3. Correct the issue indicated in the error message for the order.

    For example, for order number NH100, a valid weight needs to be entered for the shipment.

  4. Repeat steps 2 and 3 above for each order with an error in the batch.

Once all errors have been resolved, the Label Batch Status window will automatically advance to the next step in processing the batch.

Errors After the Batch Has Finished Processing

Error message:

The error message will vary depending upon the issue but typically relates to other shipping options or issues with your carrier account (like insufficient balance to purchase the postage for the entire batch).

When this error occurs:

After a batch is processed, the Label Batch Status screen will display a # Errors message, indicating that one or more labels failed to generate for the batch.



  1. Click the # Errors indicator to view the individual error messages. Each failed order number will be displayed along with a more detailed error message.

  2. Click on the order number to open the Order Details screen to correct any order or shipment related errors.

    Carrier Account Issue

    If the error indicates an issue with the carrier account being used to create the label, you will need to resolve the issue with the carrier account prior to processing the orders in the batch.

    For example, you may need to add postage to your carrier account balance.

  3. Click Retry All Failures to attempt to create the failed labels once all errors have been resolved.

Batch Errors Legacy Layout

To view errors in the Label Batch Status window in ShipStation's Legacy Layout, click the blue # label(s) to see which labels have failed and the error messages.

Label Batch Error Details pop-up, has Individual Order numbers, error details, & links to make adjustments.

See which of your batches contain errors at any time by going to Shipments > Batches. Any batch with an alert or error will display the number under the Errors column. Click the batch number to view the Label Batch Status window, then you can view the failed order and any other details.

Batch-Grid Error Pop-up. 4 Columns: Total, Errors, Progress, & Status. Errors in orange or Red, with count. Progress: Green = OK