Text and data

How to Understand eBay Bulk Upload Results and Retry Failed Records

A failed bulk upload can produce many messages for the same underlying issue. Use eBay Bulk Upload Error Analyser to consolidate your Seller Hub results CSV before changing your submission.

Results CSV grouped by code and matched to original failed records for review
Group errors, inspect messages, match source records and review a candidate retry.

Start with the processed results

Keep the original submission unchanged and download the results associated with that exact upload. A listings export is not a results report. Export Excel files as CSV and preserve identifiers as text so leading zeros survive. The analyser expects a header row with status and error fields; unsupported formats need a fresh export.

Investigate one code at a time

Prioritise groups affecting the most failed records. Read each original message because the same code can name different fields or category requirements. The tool links documented codes to the eBay reference and leaves unknown codes for manual review. Warnings and partial outcomes are shown separately and should not automatically be resubmitted. Account restrictions and service failures may need action outside your CSV.

Review candidate retries before uploading

Supply the exact original CSV to match failed records using unique identifiers, or reported line numbers when no shared identifier column exists. Line matching assumes the header is record 1. Duplicate identifiers and conflicting outcomes are excluded. Variation or grouped submissions require parent and context records, so retry export is disabled for recognised group templates.

A candidate retry contains original values, including formulas. It is a working file rather than a repaired upload. Correct the underlying problems, review actions and identifiers, and confirm the listing outcome in Seller Hub before submitting. Keep both the original and the results report for reconciliation.

References

Use the linked specifications and product documentation to check behavior in your own environment.

Continue troubleshooting

Related tools

Frequently asked questions

Can I upload an Excel workbook?

Export the results and original submission as CSV first, preserving identifiers as text.

Are retry files automatically repaired?

No. Review original messages and correct the candidate file before submitting it to eBay.

Why are group counts larger than failed record counts?

One failed record may contain multiple numeric error codes. It appears in each relevant group, but only once in the failed record total.

Need help with a tool or found a bug?

Report an issue directly to engineering. No accounts required — all client data remains private on your device.

Report an Issue →