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.

​
Partial sync (inventory uploaded but prices not imported)

The sync pipeline has multiple steps. Inventory upload is the critical step. Orders, sales reports, and price imports are non-fatal. If they fail, Hoard logs the error and continues. Check the terminal output for lines like: 
Order export failed (non-fatal): ...
Sales report download failed (non-fatal): ...
Import prices failed: ...
These usually resolve on the next sync cycle. After a failure, Hoard waits before retrying — 5 minutes after the first failure, 10 minutes after two in a row, and 30 minutes after three or more. You’ll see a “Cooling down” message in the terminal while it waits.

​
Per-product-line partial failures

If you sell across multiple product lines (e.g., Magic and Pokemon), a failure in one doesn’t block the others. For example, if Magic inventory uploads successfully but Pokemon fails, Hoard will skip Magic on the retry (since it already succeeded) and only retry the Pokemon upload. This means a problem with one game won’t hold up your entire sync.

​
Debug screenshots

When a sync step fails, Hoard automatically captures before and after screenshots of the browser and uploads them. These give our support team a clear picture of what happened (a changed page layout, a CAPTCHA, an unexpected error). You don’t need to do anything — it’s automatic.

​
”Upload failed” errors

Upload failed: API error 413: ...
The inventory CSV may be too large. This is rare but can happen with very large inventories (50,000+ items). Contact support@tryhoard.com if you hit this.

​
Sync takes too long

A normal sync takes 2-3 minutes. If it’s taking longer:
  1. First sync — The initial sync exports full order history back to 2020. This can take 5-10 minutes. Subsequent syncs only pull the last 90 days.
  2. Price imports — Uploading prices back to TCGplayer involves a multi-step process (validate, confirm, move to live). This can take 1-2 minutes.
  3. Slow internet — Large CSV exports need a stable connection.

​
Dashboard shows “Synced X ago” but data looks old

Check that:
  1. Hoard is still running (check terminal)
  2. Auto-sync is enabled in Settings
  3. The sync schedule hasn’t been set too infrequently

​
Sync lock stuck

If a sync crashes mid-run, the server may still think a sync is in progress. The lock auto-clears after 5 minutes. If it persists:
  1. Hoard will log “Waiting: in_progress”
  2. Wait 5 minutes for auto-clear
  3. If still stuck, contact support@tryhoard.com