Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.tryhoard.com/llms.txt

Use this file to discover all available pages before exploring further.

​
CSV Import Issues

​
”Unknown CSV format”

Hoard auto-detects whether your file is a TCGplayer inventory export or a Collectr portfolio export by looking at the column headers. If you’re seeing this error:
  • Make sure you’re uploading an inventory CSV, not an orders or sales export. Order CSVs go to a separate page at /import/orders.
  • Check that the file is a .csv file, not .xlsx or .txt.
  • If you opened the CSV in Excel and saved it, Excel may have changed the column headers. Try re-exporting from TCGplayer without opening it first.
TCGplayer inventory CSVs must have these columns: TCGplayer Id, Product Line, Product Name, Set Name, Condition, TCG Marketplace Price, Total Quantity. Collectr CSVs must have: Portfolio Name, Category, Variance.

​
”Wrong headers” when importing orders

You’re on the inventory import page but uploaded an orders CSV (or vice versa).
  • Inventory CSVs go to the import panel on the Cards tab, or drag onto the welcome flow
  • Orders CSVs go to /import/orders

​
No cards appear after upload

A few things to check:
  • Empty export? If you exported from TCGplayer with filters active, you might have gotten only a subset of your inventory, or an empty file. Try re-exporting without filters.
  • Wrong product line? If you exported only Pokemon but the dashboard is filtered to Magic, switch the product line dropdown to “All” to see everything.
  • File too large? Uploads are capped at 50 MB. A typical 15,000-card inventory is well under this. If your file is larger, try exporting one product line at a time.

​
Dashboard still shows old data after upload

The dashboard caches data between syncs. After a CSV upload, if the page looks the same:
  • Hard refresh your browser (Ctrl+Shift+R on Windows, Cmd+Shift+R on Mac)
  • If you see a stale page, the upload may not have processed yet. Wait 10 seconds and refresh.

​
Duplicate cards after uploading multiple CSVs

If you upload your Magic CSV and then your Pokemon CSV, Hoard merges them. Cards are identified by their TCGplayer ID, so duplicates are updated, not doubled. If you’re seeing duplicates, the issue is more likely two different conditions of the same card (NM and LP are separate listings on TCGplayer) or a foil and non-foil of the same card.

​
Import is slow or timing out

  • Files up to 50 MB are supported
  • A 10,000-card CSV typically processes in 5-10 seconds
  • If the page seems stuck, check your internet connection and try again
  • Very large files (30,000+ cards) may take up to 30 seconds

​
Historical data import (orders, feedback, sales)

The import controls on the Settings page are different from the CSV upload. They trigger the agent to pull historical data from TCGplayer between sync cycles. If the progress bar isn’t moving:
  • Make sure the agent is running
  • Check the agent log for errors (in Hoard Desktop, click the systray icon to see logs)
  • The agent processes one backfill chunk at a time, between regular sync cycles, so progress can be slow if syncs are frequent