Skip to content
  • There are no suggestions because the search field is empty.

Resolving "Index Out of Range" Error During Order Shipping in Webgility Desktop

This article helps Webgility Desktop users resolve the “index out of range” error that may occur during the shipping process in Webgility Desktop. It explains how incomplete order data or data inconsistencies can cause the issue and provides step-by-step guidance to fix the problem, along with best practices to prevent it from happening again.

Issue Summary

  • Error Message: Index out of range or List index out of range

  • When it Occurs: During order shipping or shipment creation

  • Impact: Blocks completion of the shipping process

Confirmed Resolution

The issue was resolved by re-downloading the affected order from the source platform (e.g., Shopify), which refreshed the data and resolved the internal mismatch causing the error.

Step-by-Step Resolution Process

1. Identify the Error

  • Observe the error message displayed during the Shipping workflow in Webgility.

  • You may also find the error in the Webgility application logs or on the screen when attempting to create a shipment.

2. Check for Application Updates

  • Always ensure you are using the latest version of Webgility Desktop.

  • To update:

    • Go to Help > Check for Updates within the application.

    • Follow the on-screen prompts to complete the update.

3. Re-download the Affected Order

  1. Open Webgility Desktop.

  2. Navigate to: Home > New Order Or Error 

  3. Locate the problematic order.

  4. Click the option to re-download the order directly from your connected eCommerce platform (e.g., Shopify).

✅ Re-downloading replaces corrupted or incomplete data fields with clean data from the source.

4. Retry the Shipping Workflow

  • Once the order is reloaded:

    • Reopen the order in the shipping interface.

    • Attempt to process the shipment again.

  • Confirm that the “index out of range” error no longer appears.

5. Run UnifyDBupgrade (If Needed)

If the error persists even after re-downloading the order:

  1. Close Webgility Desktop and the Webgility Scheduler.

  2. Refer to the guide: How to Run DB Upgrade & Utility for detailed instructions.