Import a collection

Add owned cards to your collection from a plain text file or CSV export, with examples for supported fields.

Last updated September 15, 2026

Before you start

Use collection import when you want to add many owned cards at once in Archiving. Import is designed for inventory records, not deck sections.

Collection import accepts .csv and .txt files. CSV import reads the header row. A text import needs a text line format so Deckonomicon knows which part of each line is the quantity, name, set, collector number, finish, language, price, or condition.

Enable Set acquired date when cards without an acquired date should use the exact UTC date and time when the import runs. Dates supplied by the file are preserved, and existing collection items are not backfilled.

CSV format

For CSV files, set File format to CSV and upload a file with a header row. Required columns are quantity and name.

Header matching is case-insensitive. Spaces and underscores are equivalent, so collector_number and Collector Number both match the same field.

Accepted CSV columns
Column	Accepted headers	Accepted values
Quantity	`quantity` `count`	Positive integer. Required.
Name	`name`	Card name. Required.
Set code	`set` `edition`	Use Scryfall's `set` value for the printing, such as `m10`, `ltr`, or `ltc`. The importer accepts 2-8 letters or numbers, and matching is case-insensitive. Do not put the set display name here; use `set_name` for that.
Set name	`set_name` `set name`	Use Scryfall's exact `set_name` value for the printing, such as `Magic 2010`. Matching is case-insensitive, but the value should be the Scryfall set name, not a local nickname or abbreviation.
Collector number	`collector_number` `collector number`	Use Scryfall's exact `collector_number` value for the printing, such as `279`, `192p`, `U27`, or `51★`. Keep Scryfall suffixes, letters, stars, and hyphens. Do not add a leading `#`.
Language	`language`	Recognized language code or name, such as `en`, `it`, or `English`.
Foil	`foil`	`nonfoil`, `normal`, `false`, `foil`, `true`, `f`, `etched`, or `e`. Empty cells default to `nonfoil`.
Price	`price` `purchase price` `purchase_price`	Non-negative decimal number. `purchase price` may start with `$`, `€`, `£`, or `¥`; that symbol is converted into a currency automatically.
Price currency	`purchase_price_currency` `purchase price currency`	3-letter currency code. If a price has no currency in the file, the import dialog currency fallback is used.
Condition	`condition`	Any condition value or alias listed below. Empty cells default to `near_mint`.
Tradelist quantity	`tradelist` `tradelist count` `tradelist_count`	Non-negative integer. Empty cells default to `0`.
Signed	`signed`	`true`, `yes`, or `1` for true; `false`, `no`, `0`, or an empty cell for false.
Altered	`altered` `alter`	`true`, `yes`, or `1` for true. Any other value imports as false.
Notes	`notes`	Free text notes saved on the collection item.
Purchase price cents	`purchase_price_cents` `purchase price cents`	Non-negative integer purchase price in minor units. Do not use with `price` in the same file.
Acquired date	`acquired_at` `acquired at`	Date or date-time value for when the cards were acquired. Empty cells are allowed.

Accepted condition values
Condition	Accepted values
Mint	`mint`
Near mint	`near_mint` `near mint` `nm`
Slightly played	`slightly_played` `slightly played` `sp` `excellent` `ex`
Moderately played	`moderately_played` `moderately played` `mp` `light_played` `lp` `very_good` `good` `good (lightly played)` `gd`
Heavily played	`heavily_played` `heavily played` `hp` `played` `pl`
Damaged	`damaged` `dm` `d` `poor` `po`

Ignored headers

id, card_id, location_id, imported_at, tags, tag, last modified, and proxy are recognized and ignored.
Any other unknown CSV column is ignored by default.

CSV

quantity,name,set,collector_number,language,foil,price,purchase_price_currency,condition,tradelist,signed,altered,notes,acquired_at
1,Sol Ring,LTC,279,en,nonfoil,1.50,USD,near_mint,0,false,false,Commander binder,2026-05-18
2,Lightning Bolt,M10,146,en,foil,4.00,USD,slightly_played,1,true,true,Trade copy,

Text format

Use braces to mark the end of a token: ${quantity}x ${name} reads or writes 4x Lightning Bolt. Prefixes such as x${quantity} work too. Short aliases such as ${q} and legacy formats such as $q $n and optional $set? still work; $quantityx is an unknown token.

Put ? inside braces for an optional field, such as ${set?}. ${name}? instead adds a literal question mark. Use $$ for one literal dollar sign and $${name} for the literal text ${name}. Unknown names and malformed placeholders are rejected.

For imports, separate variable-length values with spaces or punctuation. Braces delimit the tokens in the format, not the values in the file. Quantity and name are required for imports; exports may select fewer fields. Neither quantity nor name can be optional when included.

For text files, set File format to Text and enter a text line format. The required tokens are ${q} for quantity and ${n} for card name.

Optional tokens include ${s} for set code, ${sn} for set name, ${cn} for collector number, ${l} for language, ${f} for foil status, ${p} or ${purchase_price} for purchase price, ${pc} for purchase price currency, ${c} for condition, ${t} for tradelist quantity, ${signed} for signed status, ${a} for altered status, ${notes} for notes, ${ppc} for purchase price cents, and ${acquired_at} for acquired date.

Text format tokens
Field	Supported tokens	Description
Quantity	`${q}` `${quantity}`	Positive integer quantity. Required in every text line format.
Name	`${n}` `${name}`	Card name to resolve. Required in every text line format.
Set code	`${s}` `${set}`	Scryfall's `set` value for the printing, such as `m10`, `ltr`, or `ltc`.
Set name	`${sn}` `${set_name}`	Scryfall's exact `set_name` value for the printing, such as `Magic 2010`.
Collector number	`${cn}` `${collector_number}`	Scryfall's exact `collector_number` value for the printing, without a leading `#`.
Language	`${l}` `${language}`	Recognized language code or name, such as `en`, `it`, or `English`.
Foil	`${f}` `${foil}`	`nonfoil`, `normal`, `false`, `foil`, `true`, `f`, `etched`, or `e`.
Price	`${p}` `${price}` `${purchase_price}`	Non-negative decimal purchase price.
Price currency	`${pc}` `${purchase_price_currency}`	3-letter currency code used with purchase price.
Condition	`${c}` `${condition}`	Condition value or alias from the accepted condition values table.
Tradelist quantity	`${t}` `${tradelist}`	Non-negative integer quantity marked for trade.
Signed	`${signed}`	`true`, `false`, `yes`, `no`, `1`, or `0`.
Altered	`${a}` `${altered}`	`true`, `false`, `yes`, `no`, `1`, or `0`.
Notes	`${notes}`	Free text notes saved on the collection item.
Purchase price cents	`${ppc}` `${purchase_price_cents}`	Non-negative integer purchase price in minor units. Do not use with `${p}`, `${price}`, or `${purchase_price}` in the same line format.
Acquired date	`${acquired_at}`	Date or date-time value for when the cards were acquired.
Ignored system fields	`${id}` `${item_id}` `${card_id}` `${location_id}` `${imported_at}`	Accepted for compatibility with collection exports, but ignored during collection import.

Simple text with text line format `${q} ${n}`

3 Dark Ritual
1 Sol Ring
4 Lightning Bolt

Detailed text with text line format `${q} | ${n} | ${s} | ${cn} | ${l} | ${f} | ${p} | ${pc} | ${c} | ${t} | ${signed} | ${a} | ${notes} | ${acquired_at?}`

1 | Sol Ring | LTC | 279 | en | nonfoil | 1.50 | USD | near_mint | 0 | false | false | Commander binder | 2026-05-18
2 | Lightning Bolt | M10 | 146 | en | foil | 4.00 | USD | slightly_played | 1 | true | true | Trade copy

Import the file

Use the collection import dialog from Archiving.

Open Archiving.
Select Import.
Choose CSV or Text.
Choose the collection file.
For Text, enter the matching text line format.
Optionally enable Set acquired date to timestamp imported cards that do not provide one.
Choose Stop and import nothing or Skip invalid lines.
Select Import.

Result

Deckonomicon imports the resolved cards into your collection. If you choose Stop and import nothing, the first invalid line prevents the import from saving. If you choose Skip invalid lines, valid lines are saved and invalid lines are reported.

FAQs

19 searchable answers

Frequently asked questions about using Deckonomicon.

Read the FAQs