Supported Import Headers

This article lists all supported CSV column headers for importing your comic collection into VerseDB.


Collection Import

When importing your collection, you need at least one matching field to identify the issue, plus any data fields you want to track.


Matching Fields

These fields help VerseDB identify which issue you're adding.

Tip
Using `vdb_id` or `cv_id` provides the most accurate matching.
vdb_id
Recommended
VerseDB Issue ID (most accurate). Example: 12345
cv_id
Recommended
ComicVine Issue ID. Example: 67890
series
Optional
Series name. Example: Amazing Spider-Man
issue_number
Optional
Issue number. Example: 300
publisher
Optional
Publisher name. Example: Marvel
volume
Optional
Volume number. Example: 1
start_year
Optional
Series start year. Example: 2022
release_date
Optional
Release date (YYYY-MM-DD). Example: 2022-05-04

Data Fields

These fields store information about your specific copy.

purchased_at
Optional
Purchase date (YYYY-MM-DD). Example: 2023-06-15
price_paid
Optional
Purchase price. Example: 4.99
condition
Optional
Condition. Example: Near Mint
graded
Optional
Is graded (true/false). Example: true
grade_score
Optional
Grade score. Example: 9.8
grading_company
Optional
Grading company. Example: CGC
storage_location
Optional
Where it's stored. Example: Long Box 3
is_signed
Optional
Signed copy (true/false). Example: false
is_variant
Optional
Variant cover (true/false). Example: true
variant_description
Optional
Variant cover details. Example: 1:25 Artgerm variant
notes
Optional
Personal notes. Example: First appearance of Venom