Uploading Cards
Learn how to upload card images individually using drag-and-drop, the file browser, or your phone camera.
Overview
Uploading cards is the first step in the RocketVault workflow. Once uploaded, RocketAI automatically identifies each card, extracts all metadata, and assigns pricing — typically in under 30 seconds.
The Upload page (Inventory → Upload Cards) is a three-pane Terminal layout on desktop:
- Left — drop zone for files/ZIPs and a list of recent batches.
- Middle — pair/batch preview with pipeline stages and metrics.
- Right — live event log streaming as cards process.
On mobile, the page swaps in the camera-first MultiCardCapture experience and hides the desktop drop zone.
Before You Upload
Best Results
For the most accurate identification, photograph both the front and back of each card. Use good lighting and a contrasting background (dark cards on a light surface, light cards on a dark surface).
Image Pairing Convention
RocketVault automatically pairs front and back images using filename suffixes that you define under Settings → Naming:
- Front suffix — defaults to
_F(e.g.,card001_F.jpg) - Back suffix — defaults to
_B(e.g.,card001_B.jpg) - Separator — the character that separates the base name from the suffix
You can change these conventions at any time. A live filename preview on the Settings page shows what your settings will match. If your files don't follow any naming convention, you can manually pair images after upload.
Uploading on Desktop
Step 01
Go to the Upload Page
Click Inventory → Upload Cards in the left sidebar, or use the UPLOAD button in the Dashboard's actions queue.
Step 02
Drag and Drop
Drag your card image files (or a ZIP) directly into the drop zone on the left pane. You can drop multiple files at once.
Alternatively: Click the upload zone to open your file browser and select images manually.
Step 03
Watch Processing
After uploading, the middle pane shows a per-batch metrics panel (Uploaded / Run / Queued / New / Merged / Failed) and a progress bar split between done, errored, and currently running cards. The right pane streams live events as RocketAI extracts:
- Player name
- Card year and set
- Card number
- Parallel/variant information
- Team
- And more
You can navigate away — processing continues in the background.
Step 04
Review Results
Once processing completes, cards appear in your Available tab inside Inventory → Cards. Cards that RocketAI couldn't fully identify show an attention chip on the row — click it to fix the flagged fields in Quick Edit. See AI Card Identification for the full attention triage flow.
Uploading on Mobile
On mobile, the Upload page shows three modes to add cards:
- Single Card — capture one card's front and back photos
- Multi-Card Scan — batch capture up to 50 cards (100 photos) in a single session (recommended for 2+ cards)
- Files — choose images from your photo gallery
Single Card Mode
Step 01
Tap Single Card
On the Upload page, tap Single Card to enter camera capture mode for a single card.
Step 02
Capture Front & Back
Point your camera at the card front and tap to capture. The app auto-advances to the back. Capture the back side.
Step 03
Review & Upload
Preview your photos, swap or retake if needed, then tap Upload to send for processing.
Multi-Card Scan Mode
For scanning multiple cards at once, use Multi-Card Scan. This is the fastest way to digitize your collection on mobile.
Step 01
Tap Multi-Card Scan
On the Upload page, tap Multi-Card Scan to enter batch capture mode.
Step 02
Capture All Cards
Take photos in order: Card 1 Front, Card 1 Back, Card 2 Front, Card 2 Back, and so on. A thumbnail strip at the bottom shows your captured photos. You can capture up to 100 photos (50 cards) per batch.
Step 03
Review & Pair
Tap Review & Pair when done. The app automatically pairs photos as front/back by capture order. Review the pairs — tap any card to swap front/back, retake a photo, or remove it.
Step 04
Process All
Tap Process to upload all cards at once. RocketAI identifies each card and adds them to your inventory.
Pro Tip: Multi-Card Scan
For best results, lay out your cards in a row. Photograph each card's front, then flip them all and photograph each back in the same order. This ensures accurate auto-pairing.
Supported File Formats
| Format | Supported |
|---|---|
| JPEG (.jpg, .jpeg) | Yes |
| PNG (.png) | Yes |
| WebP (.webp) | Yes |
| HEIC (.heic) | Yes (iPhone photos) |
| GIF | No |
| No |
Common Mistakes
Avoid These
- Blurry photos — RocketAI needs to read the text on the card. Hold steady or use a flat surface.
- Glare/reflections — Avoid direct overhead lighting on glossy cards. Angle slightly to reduce glare.
- Multiple cards in one photo — Upload one card per image (front and back separately).
- Very low resolution — Use at least 800×600 pixels for best results.
Troubleshooting
Card shows as "Processing" Processing typically takes 10–30 seconds. If a card is stuck, check the right pane's event log for an error. The middle pane has retry/resume/stop controls so you can re-run a stuck batch.
Wrong card identification If RocketAI misidentified a card, click the attention chip on the row to fix it in Quick Edit, or open the card detail page and click Edit for the full form. You can also click Reprocess to re-run the AI identification.
Missing back image You can add a back image at any time from the card detail page by clicking Swap/Add Image.
Failed images in a batch Open the batch on the Upload page and click Failed Images to see why each one didn't process. Click Reprocess Failed to retry only the unsuccessful cards.
Bulk Uploading (ZIP Files)
Upload hundreds of cards at once using ZIP files. Ideal for dealers and high-volume sellers.
Multi-Card Capture
Batch scan multiple cards from your phone camera. Take all your photos, then review and process them in one go.
AI Card Identification
How RocketAI automatically identifies your cards, extracts metadata, and detects parallels and variants.
Inventory Management
Browse, filter, sort, and manage your card inventory. Tabbed pipeline view, bulk operations, attention chips, and per-card detail.