CardVersePRO
📖 User Guide — Navigate
Photos & Images

Photos & Images

Attach photos to every card in your collection — upload directly, search eBay for a match, or batch-fetch images for your entire collection automatically.

Uploading a Photo

Open the Edit Card modal for any card. The right panel shows the current image (or a placeholder if none). To add or replace a photo:

  1. Click the image area or the Upload Photo button
  2. Select an image from your device (JPEG, PNG, WebP, HEIC supported)
  3. The image is automatically optimized and stored — three sizes are generated (full, medium, thumbnail)
  4. Click Save Card to confirm
â„šī¸Images are processed through a Sharp pipeline and converted to WebP format. Three sizes are stored: full (1600px), medium (800px), and thumbnail (200px). The thumbnail is used in the collection grid for fast loading.

Image Search

CardVersePro can search eBay and card databases to find a matching image for any card. In the Edit Card modal, click Search Imagesto open the image picker.

  • The search uses the card's player, year, manufacturer, set, and parallel to build a query
  • Results come from eBay listings (primary) with additional fallback sources
  • Results are cached for 24 hours — repeated searches for the same card are instant
  • Click any result to preview it full-size, then click Use This Image to attach it
💡If results don't look right, try editing the card's set or parallel fields first, then search again — the query builds from those values.

Batch Image Fetch

The Batch Image Fetch tool finds images for multiple cards in one pass — ideal for new collections or cards added via CSV import.

  1. In the Collection view, select cards using the checkbox column (or select all)
  2. Click Batch Images in the toolbar
  3. Choose Auto mode to automatically pick the best image per card, or Review mode to approve each one manually
  4. Cards without existing photos are processed first by default
âš ī¸eBay image search is limited to ~5,000 calls/day on the free API tier. For large collections, run batch fetches over multiple sessions or use Review mode to be selective.

Photo Lightbox

Click any photo thumbnail in the Collection grid to open the lightbox — a full-screen image viewer with zoom, pan, and navigation controls.

ControlAction
Click thumbnailOpen lightbox
Scroll / pinchZoom in / out
Click & dragPan when zoomed in
← / → arrow keysNavigate to previous / next card
EscClose lightbox
Double-clickReset zoom to fit
â„šī¸The lightbox supports a Compare mode — open two cards side-by-side to compare condition or variants. Click the Compare button in the lightbox toolbar.

Removing a Photo

Open the Edit Card modal and click the Remove Photobutton below the image. The photo is deleted from storage when you save.