Troubleshoot CSV status updates

The file will not upload

What it means: The plugin does not impose a row limit, but the web host still controls maximum upload size, request size, storage, and PHP limits.

What to do:

1. Compare the CSV file size with the WordPress upload limit shown on the upload screen.
2. Split the file into smaller CSV files if it exceeds that limit.
3. Ask the host to raise the limit when splitting the file is not practical.

A background job is stuck

What it means: Background mode relies on WooCommerce Action Scheduler and WordPress cron. A stalled job usually means its next scheduled batch did not run.

What to do:

1. Select Resume on the progress screen.
2. If the job stops again, open WooCommerce → Status → Scheduled Actions and look for failed or overdue CSV processing actions.
3. Confirm that the site receives WordPress cron requests.
4. Use interactive mode for smaller files while cron is being repaired.

Unknown status

What it means: The value in the status column does not match a status registered on this store.

What to do: Download a fresh sample from the plugin screen and use one of its status slugs. Both completed and wc-completed formats are accepted when that status exists.

Invalid order ID

What it means: The order ID is not a positive whole number. Values such as 12abc, 12.0, negative numbers, empty cells, and numbers too large to be an order ID are skipped without changing an order.

What to do: Find the CSV row number in the result message, compare the entered value with the intended order’s internal ID, and correct the source file. The row number includes the header and blank rows. Run validation again before applying the corrected file. Invalid rows also appear in downloaded results, so a file containing only invalid IDs still provides a report.

Order not found

What it means: The value in the order ID column does not resolve to a WooCommerce order.

What to do: Open the intended order and compare its internal ID with the CSV. Do not use a formatted order number produced by another extension.

One row errored

What it means: That row failed, but the plugin continued processing the remaining rows. A payment, shipping, or custom-status integration may have rejected the transition.

What to do: Open the order linked from the results, inspect its notes, and try the same status manually. WooCommerce or the integration may then display a more specific validation message.

Customers received unexpected email

What it means: Status changes use normal WooCommerce email behavior. Moving an order into an email-enabled status can therefore notify the customer.

What to do: Enable Do not send customer emails before a corrective run. For future imports, review the emails attached to the target status in WooCommerce settings before processing the file.