Troubleshooting Import Issues

Most import issues fall into a few categories. Try the matching section below before contacting support.

Many Unmatched Items#

If a lot of your comics show "unmatched" after processing:

1. Add more identifying data — include publisher, volume number, or start_year to distinguish between series with similar names
2. Use IDs when possible — a vdb_id or cv_id column produces exact matches
3. Check series names — VerseDB may use different naming. "ASM" won't match "The Amazing Spider-Man"
4. Manual matching — on the review page, search for series and issues to match items by hand

File Won't Upload#

Headers Not Detected#

• Make sure the first row contains headers, not data
• Remove any blank rows above the headers
• Use simple header names without special characters
• Save as CSV with UTF-8 encoding

Import Stuck on "Processing"#

Small files (under 100 rows) process in a few minutes. Larger files can take longer at peak hours — processing runs in the background, so you can close the tab and come back. You'll also get an email when it finishes.

If it's stuck for more than 30 minutes, cancel and re-upload.

Conflicts During Update#

This is normal when "Update" is selected as the duplicate handling mode and matching items already exist. For each conflict you can keep existing, use new, or skip all.

Wrong Data Imported#

• Wrong import type — delete the import and start over with the correct type (Collection, Wishlist, etc.)
• Wrong field mapping — double-check that "Purchase Price" maps to price_paid, not notes, etc.
• Date format — VerseDB expects YYYY-MM-DD for date fields

Special Characters Show As Mojibake#

If names or notes show é instead of é, your file isn't UTF-8 encoded.

1. Open the CSV in a text editor (not Excel)
2. Save As with encoding set to UTF-8
3. Re-upload

Still Stuck?#

Contact support and attach your file — we'll import it for you. Let us know the import type (Collection, Wishlist, etc.) and the source it came from.