Troubleshoot Batch Errors

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

For a batch to process successfully, all orders in the batch must have their shipping parameters (weight, shipping service, package type, customs, and other options) configured correctly or you may encounter errors when attempting to create the labels for the batch.

You may receive an error when attempting to process a batch or after the batch has finished processing.

Errors When Processing a Batch

This type of error varies depending on the shipment information, and it will prevent the indicated orders from processing in the batch.

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

Process Error pop-up has order number & problem: weight greater than 150 lbs and no weight specified

To resolve the errors, click on the blue order number and you’ll be taken to the order's Details screen. Once you’ve edited the details to resolve the error, click Close. This will bring you back to the batch and once the errors clear, you’ll be able to process the batch to create the labels.

Errors After the Batch Has Finished Processing

ShipStation Legacy Layout Only

The information in this section only applies when using ShipStation's Legacy Layout.

If you have processed a label batch and it displays the message # label(s) have failed, it means that one or more labels failed to generate for the batch. These types of errors typically relate to other shipping options or issues with your carrier account (like insufficient balance to purchase the postage for the entire batch).

Batch Complete pop-up: has batch number & order details, any errors, & number of failed labels or shipments. Links to error details & retry

To see more information for the failed orders and correct any problems, click on the # label(s) text. Each failed order will be displayed along with an error message. In most cases, the order number can be clicked on to open the details of the order.

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

Once the order has been updated to fix any problems, you can click Retry Failed Shipments to attempt to regenerate the failed labels.

See which of your batches contain errors at anytime 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