There are three ways to bring your cards into Gradely:
Create a Google Sheet or Excel workbook with these columns in order:
count | name | set | number | finishing | condition | treatment | tags | price | date
In Google Sheets: File > Download > Tab-separated values (.tsv). Then change the delimiter to | before exporting, or use File > Download > Comma-separated values and let Gradely detect commas automatically.
In Excel: Save As > CSV UTF-8. Gradely accepts comma or tab delimiters.
A spreadsheet with pipe-separated columns is already valid GXF.
Paste or upload a Gradely Exchange Format file directly. GXF gives you the most control over set codes, finishings, conditions, and tags.
Copy-paste any comma- or tab-separated export with a header row. Gradely maps these column headers automatically (case-insensitive):
| Column header | Mapped to |
|---|---|
game, tcg, game name | game (must match the game you picked; either the code such as mtg or the full name) |
count, quantity, qty, tradelist count | quantity |
name, card, card name | name |
set, edition, set code, expansion | setCode |
number, card number, collector number, cn | cardNumber |
foil, finish, finishing | finishing |
condition, cond | condition |
treatment, frame, variant | treatment |
tags | tags (semicolon-split), merged with any @tags directive |
purchase price, price, paid, acquired price | what you paid (a value of 0 is treated as unset) |
purchase price currency, currency | currency for the price; if absent, your preferred currency is used |
acquired date, purchase date, date acquired | date acquired (YYYY-MM-DD) |
Exports from Moxfield and ManaBox carry their purchase price across automatically. Price and date only apply when importing into your collection.
TCG requirement: every import must target one TCG. Files containing cards from multiple TCGs will get an error at parse time.
Yes. Sealed products (booster boxes, bundles, precons and the like) go in the same file as your singles: start a @kind sealed block, then list them quantity first, the same way you list cards. This is also how you bring in their full acquisition and disposal history, purchase price, condition, sales, gifts, trades and more. See the sealed products reference for the full syntax.
No. A spreadsheet is one game. A Game column that disagrees with the game you picked is rejected rather than silently mismatched, so nothing lands in your collection under the wrong game. Import one game at a time, or use the formula above to paste GXF instead.
We never pick for you. Every card shows a gallery of every printing that matches your entry. You choose the exact one you own, including foil, showcase, extended art, borderless, and any other treatment.
Bulk helpers let you resolve many cards at once:
If a card has 200+ reprints, the gallery supports infinite scroll and filtering so you can always find the exact one.
Looking up your card lines against our database is the expensive part of an import (we cross-reference set, name, collector number, treatment, etc. across millions of printings). To keep the platform fast for everyone, each plan gets a rolling 24-hour lookup budget:
| Plan | Lookups per 24h |
|---|---|
| Free | 500 |
| Premium | 5,000 |
| Pro | 25,000 |
We count lines, not card quantities. A line like 4 Lightning Bolt counts as 1 lookup, regardless of how many copies the line includes. Four separate 1 Lightning Bolt lines would count as 4. A sealed product line counts exactly the same way, one lookup, the same as a card.
Lookups are spent at resolve time, not import time. Once we've looked a line up, it's paid for, even if you later choose to skip it or fail to commit. Importing the resolved cards into your collection is free.
On the Free plan and hitting the cap? Upgrade your account for a higher limit.
The card scanner lets you add cards to your collection just by pointing your phone or webcam at them. Gradely recognises each card as you go and drops it into a batch tray, so you can scan a whole stack in one sitting and review everything before it lands in your collection.
Yes, completely. Card recognition runs entirely on your own device, inside your browser. The live camera feed and the frames it captures are processed locally and are never uploaded, stored, or sent to Gradely or any third party. No photos or video ever leave your phone or computer. The only thing saved is the final card you confirm, recorded as a normal collection entry, exactly as if you had added it by hand.
Hold a card within the on-screen guide and Gradely matches what it sees against our catalogue, adding the best match to the tray automatically. Cards with look-alike printings are flagged so you can pick the exact one, and you can adjust quantity, finishing, condition, and price for each card before adding the whole batch in one go.
Scanning works across the games in our catalogue: Magic: The Gathering, Pokemon, One Piece TCG, Flesh and Blood, Sorcery, Riftbound and Lorcana. We'll keep working to improve overall quality as our catalogue grows.