Getting Started
Overview
TCG Pile is a spreadsheet-style app built specifically for Magic: The Gathering players. It helps you track your collection, manage trades, build decks, and keep up with live card prices — all in one place.
Think of it as a smarter version of a Google Sheet: it autocompletes card names, pulls live market prices, tracks price changes over time, and lets you share your sell list with a public link.
It works on desktop and mobile, and you can start using it for free — no credit card required.
Creating an Account
Head to the Sign up page and create an account with your email and a password. After verifying your email, you're ready to go.
Once signed in, you'll land on your Collection page — an empty spreadsheet waiting for your first cards.
Adding Your First Cards
There are three ways to add cards:
- Type a name — Click an empty cell in the Name column, start typing, and pick a card from the autocomplete dropdown. The app uses Scryfall to find exact printings with set, collector number, and current price.
- Paste a list — Copy a decklist or spreadsheet rows from anywhere (Google Sheets, Moxfield, Archidekt, a text file) and paste directly into the grid. The app detects the format automatically and resolves each card name.
- Add button — On mobile, tap the + button to open the card search sheet with autocomplete.
Inventory
Overview
The Collection is the core of TCG Pile. It's a spreadsheet grid powered by AG Grid where each row is a card in your collection. Every card tracks:
- Quantity, condition, language, finish (foil, etched, nonfoil)
- Whether it's signed or altered
- Live market price (updated daily from Scryfall)
- Price paid Pro
- Custom notes
A summary bar at the bottom shows your total card count and market value for the active sheet.
Adding Cards
Click an empty row's Name cell and start typing. An autocomplete dropdown appears showing matching cards from Scryfall, grouped by printing. Each result shows the set name, collector number, and current market price.
Select a result and the row fills in automatically — name, set, prices, and image. You can then adjust quantity, condition, language, and finish as needed.
To add multiple rows at once, right-click and choose Insert row above or Insert row below.
Editing Cards
Double-click any editable cell to modify it. Most columns support inline editing:
- Quantity — type a number
- Condition — dropdown: Mint, Near Mint, Excellent, Good, Light Play, Played, Poor
- Language — dropdown with 10+ supported languages
- Finish — dropdown: Nonfoil, Foil, Etched
- Signed / Altered — checkbox toggle
- Edition — click to switch printings (same card, different set)
- Notes — free text field
To delete rows, select them and press Delete or right-click and choose Delete. You can undo any change with Ctrl+Z (or Cmd+Z on Mac).
Paste Import
Copy cards from any source — a decklist, Google Sheets, Excel, a forum post — and paste them directly into the grid with Ctrl+V (or Cmd+V on Mac). TCG Pile auto-detects the format.
Decklist Format
Paste a standard decklist. Quantity, card name, and optionally set code and collector number. Section headers like Deck, Sideboard, or Commander are automatically ignored.
4 Lightning Bolt 2x Counterspell (MH2) 267 1 Ragavan, Nimble Pilferer 3 Fatal Push (2XM) 93
Spreadsheet Format
Copy rows from Google Sheets, Excel, or any spreadsheet. Columns are auto-mapped: the integer column becomes quantity, the text column becomes the card name, and an optional third column is the set code.
| Qty | Name | Set |
|---|---|---|
| 4 | Lightning Bolt | 2XM |
| 2 | Counterspell | MH2 |
| 1 | Fatal Push |
Full Grid Paste
Copy multiple columns from another grid or spreadsheet with headers matching your column names. Supported fields: name, quantity, wanted_qty, price_paid, condition, language, finish, notes.
| Name | Quantity | Condition | Language | Notes |
|---|---|---|---|---|
| Lightning Bolt | 4 | NM | EN | |
| Counterspell | 2 | LP | JP | Signed |
| Fatal Push | 1 | NM | EN | Promo |
How It Works
- Each card name is resolved against Scryfall's database.
- If a set code and collector number are included, the exact printing is matched.
- Otherwise, the most recent printing is used.
- Double-faced cards are matched automatically — paste
Delver of Secretsand it finds the full card.
If something goes wrong, Ctrl+Z (or Cmd+Z) undoes the entire paste operation instantly.
Sheets
Sheets let you organize your collection into separate tabs — for example, by format, binder, storage box, or however you like.
- The free tier includes 1 sheet. Pro unlocks unlimited sheets.
- Click the + button in the tab bar to create a new sheet.
- Double-click a tab to rename it. Right-click for more options: rename, change color, copy column layout from another sheet, or delete.
- Drag rows between sheets by grabbing a row and hovering over a different sheet tab.
- The All tab (far right) shows a combined read-only view of all sheets.
Sheets work the same way in the Collection, Buy List, and Sell List.
Grid Columns
Every grid comes with a rich set of columns. You can show, hide, reorder, and resize them to fit your workflow.
Click the Columns icon in the toolbar to toggle column visibility. Drag column headers to reorder them. Double-click a column border to auto-size it.
Your column layout is saved automatically. You can choose between per-sheet layouts (each sheet remembers its own columns) or a shared layout (all sheets use the same columns) in Settings.
Common columns in the Collection grid:
| Column | Description |
|---|---|
| Name | Card name with autocomplete and image hover |
| Qty | Number of copies owned |
| Edition | Set name — click to switch printings |
| Collector # | Set collector number |
| Condition | MT / NM / EX / GD / LP / PL / PO |
| Language | Card language |
| Finish | Nonfoil, Foil, or Etched |
| Market Price | Live price from TCGPlayer (USD) or Cardmarket (EUR) |
| Subtotal | Qty × Market Price |
| 1d / 7d / 30d | Price change over time |
| Price Paid | What you paid (Pro) |
| Signed / Altered | Checkbox flags |
| Notes | Free text |
Filtering & Sorting
Click a column header to sort ascending/descending. Hold Shift and click another header for multi-column sorting.
Hover over a column header to reveal the filter icon. Click it to open the column filter — text search, number range, or value selection depending on the column type.
On mobile, tap the filter button in the toolbar to open a full-screen filter sheet. Active filters appear as chips below the toolbar for quick removal.
Exporting
Pro users can export their grid data to CSV using the download button in the toolbar. The export includes all visible columns in the currently active sheet.
Live Pricing
How Prices Work
TCG Pile pulls card prices daily from Scryfall, which aggregates data from TCGPlayer (USD) and Cardmarket (EUR).
When you add a card, its market price appears automatically. Prices update once per day via a background sync. The price shown depends on the card's finish — foil and etched cards use their respective foil prices.
All price data is always free — it's not a Pro-only feature. Everyone gets live market prices.
Currency Settings
Go to Settings → Preferences and choose your preferred currency: USD (TCGPlayer) or EUR (Cardmarket).
Not every card has prices in both currencies. When a price is missing in your chosen currency, the app can show a converted estimate from the other currency. You can enable this in Settings under "Show converted prices when native unavailable."
You can also control whether converted prices are included in sheet totals and collection totals separately.
Price Change Tracking
The grid includes optional 1d, 7d, 30d, and 365d price change columns. These show how much a card's market price has moved over that period, in both absolute value and percentage.
Price changes are color-coded: green for increases, red for decreases. This helps you spot trending cards at a glance.
Buy List
Overview
The Buy List is your shopping list for cards you want to acquire. It uses the same spreadsheet grid as the Collection — autocomplete, paste import, filtering, sorting, sheets, and column customization all work the same way.
You can share your buy list with a public link, just like the sell list.
Binder Matching
When you visit someone else's public sell list while logged in, cards that match your buy list are automatically highlighted with a shopping cart icon. This makes it easy to spot what you need in someone else's binder.
In Settings → Preferences, you can choose the matching mode:
- Loose — matches by card name only
- Strict — matches by name + condition + language + finish
Missing Cards
The Missing Cards view is auto-generated. It compares your Collection with your Buy List and shows cards where the quantity you want is greater than the quantity you own.
You don't need to add anything here manually — it updates automatically when you change your collection or buy list. It's a read-only view that helps you see what you still need at a glance.
Sell List
Overview
The Sell List is where you list cards you're willing to sell or trade. Like the Collection, it's a spreadsheet grid with all the same features — plus a few extras:
- Asking Price — set your own price per card
- Status — mark cards as Sold or Reserved (partial quantities supported)
- Public sharing — generate a link others can browse
- Contact info — attach your contact details to the shared page
Sold & Reserved
Right-click a card and choose Mark as Sold or Mark as Reserved.
If you have multiple copies (e.g., 3x Lightning Bolt), a quantity picker appears so you can mark exactly how many are sold or reserved — for example, "2 of 3 Sold."
Sold cards appear with a strikethrough on the name and a red status badge. Partially sold cards show an amber name and a badge like "2/3 Sold." The same visual indicators appear on your public share page.
To clear a status, right-click and choose Clear Status.
On mobile, open the card detail sheet (tap a row) and use the sold/reserved steppers at the bottom.
Contact Information
You can attach contact details to your shared trade binder: email, phone number, and/or WhatsApp number (with country prefix). These appear on the public page so interested traders can reach you.
You can also add notes visible only on the public page — useful for things like "Based in Madrid, meet-ups OK" or "Ships within EU only."
Order Sheets
Overview
When a buyer contacts you after seeing your Sell List — via WhatsApp, Discord, or any other channel — you can create an Order Sheet to organize the sale. Order Sheets let you:
- Pick specific cards from your Sell List for a particular buyer
- Reserve those cards automatically (locks inventory)
- Generate a shareable link with an invoice-like view of the order
- Store the buyer's name and WhatsApp for quick contact
Access Order Sheets from the Orders tab in your Sell List.
Creating an Order
Click Create Order in the Orders tab. A new order is created in Draft status. You can then:
- Edit the order name and buyer details (name + WhatsApp) using the pencil icon
- Click Add Cards to open the card picker — it shows all your available Sell List items with a search bar and quantity stepper
- Cards added to an order are automatically marked as Reserved in your Sell List
If the seller has Round Up Prices enabled in Sell List share settings, market prices in orders are rounded up to the nearest whole number.
Free accounts can have up to 3 active order sheets. Pro users get unlimited orders.
Sharing with Buyers
Each order has its own unique share link. Click the copy icon on any order to copy the link to your clipboard.
To make the link accessible to the buyer, click Share to move the order from Draft to Active status. Draft orders are not visible on the public page.
The public page shows an invoice-like view with your profile, card thumbnails, set symbols, condition/language/finish badges, quantities, prices, and a grand total. Your contact information (from Sell List share settings) is displayed at the bottom.
If you need to invalidate a link, use Refresh Link to generate a new token — the old link will stop working.
Status & Completion
Orders follow this status flow:
- Draft — the order is being prepared; not yet visible on the public link
- Active — shared with the buyer; cards remain reserved
- Completed — the sale is done; reserved quantities move to sold
- Cancelled — the order is cancelled; reserved quantities are released back to available
Completing or cancelling an order is permanent — you'll be asked to confirm. You can delete an order at any time (reserved quantities are released).
Set Collection
Overview
Set Collection lets you track your progress toward completing MTG sets or building custom card collections. Each collection is displayed in the same spreadsheet grid used across the app, with completion stats shown at the bottom.
You can create multiple collections using sheet tabs at the bottom of the page — one per set or custom goal.
Set vs Custom
There are two types of collections:
- Track a Set — pick any physical MTG set from a searchable list. The grid is automatically populated with every card in that set, sorted by collector number. No manual entry needed.
- Custom Collection — start with an empty grid and add cards manually. Useful for goals like "all Lightning Bolt printings" or "every Eldrazi creature."
Ownership Tracking
When creating a set-based collection, you choose how ownership is tracked:
- Auto-sync — cards you own in your main Collection are automatically marked as owned. No manual work required; it updates every time the page loads.
- Manual — check off cards yourself using the owned checkbox. Useful if you want to track a separate copy of a set (e.g., a sealed collection).
Custom collections always use manual tracking.
Progress & Stats
A stats bar at the bottom of the grid shows your completion progress:
- Progress bar — visual indicator with owned count, total, and percentage
- Owned Value — total market value of cards you own
- Remaining Cost — estimated cost to complete the collection
Deck Builder
Overview
The Deck Builder lets you create, edit, and manage MTG decks. Each deck has a name, format tag, archetype tag, and sections for Mainboard, Sideboard, and Commander.
Free users can create up to 3 decks. Pro unlocks up to 50 decks.
The deck list page shows all your decks with their card count, total cost, and last modified date.
Building a Deck
Open a deck and use the search bar to find cards. Type a name, select a result, and it gets added to the appropriate section. Use the + and - buttons to adjust quantities.
The deck editor tracks your collection ownership:
- Green — you own enough copies
- Amber — you own some but not enough
- Red — you don't own any copies
Pro users can send all missing cards directly to the Buy List with one click.
List & Visual Views
Toggle between two views:
- List View — compact text list grouped by card type, with a mana curve chart
- Visual View — card images arranged in a grid, showing artwork
Import & Export
Import — paste a decklist (e.g., from Arena, MTGO, or any deckbuilding site) into the import dialog. The app resolves card names and adds them to the deck.
Export — copy the decklist to your clipboard as text, or download it as a .txt file. The export format is compatible with Arena, MTGO, and other tools.
Sharing Decks
Each deck has a public/private toggle. Public decks get a share link that anyone can view. The public page shows the full card list, total cost, mana curve, and card images.
Analytics
The Analytics dashboard is a Pro feature that gives you insights into your collection's value over time.Pro
It includes value trend charts, portfolio composition breakdowns, and price change analysis. Access it from the sidebar under "Analytics."
Profiles & Friends
Your Profile
Set a username in Settings → Account to get a public profile at tcgpile.com/u/your-username. Your profile shows:
- Display name
- Collection card count (if sharing is enabled)
- Links to your public sell list, buy list, and decks
Friends
Add friends by searching their username. Once both users have accepted the friend request, you can view each other's shared collections (if sharing is enabled).
Browsing Collections
In Settings → Account, you control what friends can see:
- None — friends can't see your collection
- All sheets — friends see everything
- Specific sheets — choose which sheets are visible
- Search only — friends can search by card name but can't browse freely
When browsing a friend's collection, you can see their cards but not edit anything.
Lending
Overview
The Lending system lets you borrow and lend cards between friends. It's a Pro feature for both parties.Pro
You can send requests, approve or decline incoming requests, track what's out on loan, and mark cards as returned.
Requesting Cards
When viewing a friend's collection, you can click a card to send a lending request. Specify how many copies you need and optionally add a message. The request goes to the card owner for approval.
You can also send requests from the Deck Builder — when you see missing cards that a friend owns, you can request to borrow them.
Managing Requests
The Lending page has two tabs:
- Received — requests others have sent to you. Approve, decline, or counteroffer with a different quantity.
- Sent — requests you've made. Track their status (pending, approved, declined).
Approved loans appear as active until the borrower marks them as returned. You get notifications for new requests, approvals, and returns.
Settings
Preferences
- Language — English or Spanish
- Theme — Pile (default), Light, Dark, System, plus 5 exclusive Pro themes
- Currency — USD (TCGPlayer) or EUR (Cardmarket)
- Default condition & language — pre-fill new cards with your preferred defaults
- Converted prices — show estimated prices when your currency is unavailable, and control whether they're included in totals
- Card images on hover — show card artwork when hovering over the name or set columns
- Column layout mode — per-sheet (each sheet has its own column layout) or shared (all sheets use the same layout)
- Buy list matching — loose (name only) or strict (name + condition + language + finish)
Account
- Display name — shown on your profile and shared pages
- Username — your unique URL identifier (
tcgpile.com/u/username) - Email — update your email (requires verification)
- Password — change your password
- Friend sharing — control what friends can see in your collection
- Delete account — permanently remove your account and all data
Themes
TCG Pile comes with 3 base themes available to everyone:
- Pile — the default dark theme
- Light — clean light mode
- Dark — pure dark mode
Pro subscribers unlock 5 additional themes: Plum, Jade, Crimson, Neon, and Aurora. You can also choose System to match your OS light/dark preference.
Browser Extension
Overview
The TCGPile Companion is a free Chrome extension that connects your tcgpile collection to the sites you already use: Cardmarket, TCGPlayer, MTGStocks, MTGGoldfish, mtgdecks.net, and tcdecks.net.
It shows which cards you own while you browse, lets you import decks with one click, bulk-add cards from Cardmarket purchases, and highlights Reserved List cards across all supported sites.
To get started, install the extension from the Chrome Web Store and visit tcgpile.com while logged in. The extension picks up your session automatically — no separate login needed.
Owned Badges
When you visit a card page on Cardmarket, TCGPlayer, or MTGStocks, the extension shows a badge below the card name telling you how many copies you own, which printings you have, and whether the card is in your trade binder or want list.
On deck pages (MTGGoldfish, mtgdecks.net, tcdecks.net), each card in the decklist gets a colored badge:
| Green | You own enough copies |
| Gold | You own some but not enough |
| Gray | You don't own any copies |
Quick-add buttons (+ Collection and + Buylist) let you add cards to your collection or buy list directly from any supported card page, with sheet selection.
Deck Import
On deck pages across MTGGoldfish, mtgdecks.net, and tcdecks.net, a floating Import to tcgpile button appears in the bottom-right corner.
One click imports the full deck (mainboard + sideboard) into your My Decks on tcgpile. The format, source URL, and all card quantities are preserved. After import, the button turns green and links directly to your new deck.
Order Import (Cardmarket)
After receiving a Cardmarket order, visit the order page and the extension shows an Import to tcgpile button. Clicking it opens a modal where you can review every card in the order before importing.
The modal shows quantity, name, set, collector number, condition, language, foil status, and price paid — all pre-filled from the order page. You can select which sheet each card goes to, edit any field, and uncheck cards you don't want to import.
Cards are imported in batches with a progress bar showing real-time status. Each row turns green as it completes. The price you paid is saved to your collection for profit/loss tracking.
Reserved List Badges
On Cardmarket, TCGPlayer, MTGStocks, and mtgdecks.net, cards on the Reserved List are tagged with a golden RL badge. The extension carries a built-in database of all ~800 Reserved List cards for instant O(1) lookups — no API calls needed.
Extension Settings
Click the extension icon to open the popup with three tabs:
| TCGPile | Collection value dashboard with 24h delta, card count, and top movers |
| Filters | Save and apply Cardmarket filter presets (country, language, condition, seller type) |
| Settings | Toggle individual features on/off: owned badges, deck import, order import, Reserved List, and more |
Your settings sync across browsers via your tcgpile account.
Free & Pro
Free Tier
The free tier is generous and fully functional:
| Collection | Up to 1,000 cards, 1 sheet |
| Buy List | Up to 300 cards, 1 sheet |
| Sell List | Up to 300 cards, 1 sheet |
| Decks | Up to 3 decks |
| Prices | Full live pricing in USD and EUR |
| Sharing | Public links for binder, buy list, and decks |
There are no ads, and price data is never paywalled. You can use the app indefinitely on the free tier.
Pro Features
Pro costs €2.99/month or €29.99/year (save 16%). It includes everything in Free, plus:
| Higher limits | 5,000 cards per section, unlimited sheets, 50 decks |
| CSV export | Download your data anytime |
| Price paid tracking | Track what you paid and see profit/loss |
| Analytics | Collection value charts and insights |
| Lending | Borrow and lend cards between friends |
| Share stats | Visitor analytics on your shared pages |
| Secondary currency | See totals in both USD and EUR |
| All-sheets stats | Combined totals across all sheets |
| 5 exclusive themes | Plum, Jade, Crimson, Neon, Aurora |
| Browser extension | See your collection on Cardmarket, TCGPlayer, MTGGoldfish & more |
If you cancel Pro, your data stays — you just lose access to Pro features and fall back to free-tier limits.
Tips & Shortcuts
Keyboard Shortcuts
| Ctrl+Z | Undo last action |
| Ctrl+V | Paste cards from clipboard |
| Delete | Delete selected rows |
| Enter | Start editing a cell / confirm edit |
| Escape | Cancel editing |
| Tab | Move to next cell |
| Shift + click header | Multi-column sort |
Tips
- Hover over the card name to see a large card image preview (enable in Settings → "Show card image on name hover").
- Right-click any row for a context menu with copy, paste, delete, duplicate, insert above/below, and (in Sell List) sold/reserved options.
- Drag rows to other sheet tabs to move cards between sheets — you'll see a visual flash when the move completes.
- Double-click a column border in the header to auto-size that column to fit its content.
- Install as a PWA — on mobile, use your browser's "Add to Home Screen" option for a native app-like experience.
- Paste from anywhere — decklist text, Google Sheets rows, Moxfield exports. The app figures out the format automatically.
No credit card required.