Skip to content
INVENTORY · GUIDE

Bulk Uploading Images & ZIP Files

Upload paired card images in batches or upload a ZIP for background processing in RocketVault web.

ZIP upload to Vault demonstration

Processed ZIP and file uploads go straight to your Vault.

ZIP Upload Availability

ZIP upload is available in the RocketVault web app

ZIP upload is included for every account in the current RocketVault web app. Installed mobile apps use camera and image uploads; ZIP upload is a web-only workflow.

Preparing Your Images or ZIP

Step 01

Organize Your Images

Place the front and back image files for your cards in one folder. For best results, use the naming convention:

  • cardname_F.jpg for front images
  • cardname_B.jpg for back images

RocketVault automatically pairs fronts and backs based on matching names (before the _F or _B suffix). Every card needs both sides. Before processing begins, RocketVault checks the ZIP and reports any front-only or back-only filenames; it never creates an unprocessable card record for an unmatched image.

Scanner filenames may restart in a later image batch. RocketVault isolates each submitted batch, so reusing names such as card-001_F.jpg and card-001_B.jpg does not overwrite an older card or carry its identification into the new scan.

Scanning with running numbers instead? If your files are numbered 001.jpg, 002.jpg, 003.jpg… set the Pairing Mode to By number (even/odd). RocketVault sorts by number and pairs each two in a row into a card — you pick whether even or odd numbers are the fronts. Keep the sequence gap-free so pairs don't shift.

Your saved Pairing Mode applies to both image batches and ZIP contents. Choose By filename suffix for files such as card_F.jpg / card_B.jpg; choose By number (even/odd) only for consecutive numbered scans.

Step 02

Choose Image Batch or ZIP

You can select image files directly in the upload picker or drag them into the drop zone. You can also compress paired images into one .zip file and drop that ZIP into the same RocketVault web-app screen.

Pro Tip

Keep filenames simple and consistent. Avoid special characters or very long names. A pattern like 20250227-001_F.jpg works well for batch scans.

Uploading a Batch or ZIP

Step 01

Open Vault → Upload

Open Vault → Upload in the RocketVault web app.

Step 02

Add Image Files or a ZIP

Drag front-and-back image files into the drop zone, or drag in a .zip file containing those images. RocketVault pairs matching images and starts background processing after the upload completes.

Keep the page open while your ZIP uploads. If the connection drops, RocketVault tries to continue the upload before starting to read the cards. If it cannot finish, the uploader shows an error so you can try again. A partly uploaded ZIP does not count as a completed upload.

Before starting the upload, optionally enter a Storage location such as A1. RocketVault applies it to every card in that image batch or ZIP. You can search the code later, change it on an individual card, or replace it for a selection with Bulk Edit.

If a ZIP is marked Partial, expand the batch to see what needs attention. RocketVault keeps the existing photos when a matching filename belongs to a listed or sold card, or to a scan that was merged into another card. The other cards in the ZIP can still process. If the skipped photos show a different card, give both sides a new matching name and upload just those photos.

If one or more filename groups were missing a front or back, the complete pairs can still process. Expand the batch to see the unmatched names, fix only those files, and upload the corrected pairs. If RocketVault says No complete front/back pairs found, rename every pair with a shared base name such as card-001_F.jpg and card-001_B.jpg before trying again.

Step 03

Monitor Progress

The middle pane shows the per-batch metrics panel:

  • Uploaded / Run / Queued / New / Merged / Failed tiles
  • A progress bar split between done, errored, and currently running cards
  • An expandable Pipeline section that shows each processing step and how long it took

The right pane streams a live event log as cards process. You can navigate away from the page after the upload completes — processing continues in the background.

Step 04

Review Results

Once complete, your recent batches stay in the left pane. Choose a batch to see its totals and processing steps. Retry one failed card through Failed Images, or choose Reprocess Failed for the whole batch.

Processed cards appear directly in Vault → All Cards as each card finishes. New ZIP and file uploads do not wait for a separate batch approval. Select Cards in upload history to open your inventory, including cards with identification warnings. Use their attention chips, Quick Edit, or Card Detail to correct uncertain information before publishing.

A batch can finish saving your cards while suggested prices are still being checked. Open a card in Vault to see its price or find out what needs review. If RocketVault needs more details to make a match, correct the card details and refresh the suggested price from the card.

Failed images remain in upload history for a targeted retry. Duplicate capture outcomes remain in the Merged count rather than creating another card row. Possible duplicate identities still require a deliberate decision before publishing or consolidation; uploading never authorizes a new listing.

Replacing a legacy upload's photos reruns identification on its existing card record. The completed result includes the new name and set without increasing that card's quantity. Retrying the same upload reuses its completed result. Team cards use their identified team name when there is no individual player. Cards that still need identification keep their attention notes in Vault.

A completed ZIP keeps its saved cards even if an additional parallel check cannot finish. Use Quick Edit or Card Detail in Vault to review uncertain information. Uploading the same ZIP again is not needed for that check.

Older uploads may still show Review if they were staged under the previous workflow. Their prior approvals and rejections remain recorded. A recovery can move completed non-duplicate cards into Vault without rerunning identification or changing quantities, while preserving rejected and uncertain duplicate rows.

Upload Limits

Every account includes image batches and ZIP upload.

AccessMax Cards / BatchMax ZIP Size (Web)
Every account ($0)Unlimited2 GB

For the quickest feedback, split very large collections into manageable batches and wait for the current batch to finish before starting another. If a ZIP is larger than 2 GB, split the image folder into more than one ZIP.

Mobile Apps

Use Single Card, Multi-Card Scan, or Files in the installed mobile apps. ZIP upload is available in the RocketVault web app, not the installed mobile apps.

Reprocessing Failed Cards

If some cards fail during batch processing:

  1. Go to Vault → Upload
  2. Find the batch in the recent batches list (left pane) and expand it
  3. Click Failed Images to see the per-image errors, or
  4. Click Reprocess Failed to retry only the unsuccessful cards

Note

Common failure reasons include corrupted images, unsupported image formats, or extremely low-resolution photos. Check the error details for each failed card.

If RocketVault cannot identify a card from otherwise valid photos, retake both sides with the full card in frame, sharp focus, even lighting, and readable player, set, or card-number text. Re-uploading the same photos is unlikely to help.

Best Practices

  • Consistent naming — Use a pattern like YYYYMMDD-NNNN_F/B.jpg for easy sorting
  • Reasonable batch sizes — Split large collections into manageable batches for faster feedback
  • One card per image — Don't photograph multiple cards in one image
  • Good lighting — Batch scan setups benefit from consistent, even lighting

Pricing after upload

A saved card can show Pending pricing while its price check waits. Pricing may take a few minutes. You can leave this page. Larger batches can take longer. A missing price does not undo an upload. Follow Pricing, Retrying, Needs review, No matching quote or Pricing unavailable on the card. Correct the card and slab details before retrying a match. A missing graded quote never uses a raw value. See Pricing Data Sources.

Help Assistant

Ask RocketAI

Popular questions

Answers based on our documentation. Always verify important details.

Optional cookies. With ads, Meta gets signup, first-listing and completed-purchase events plus page, browser and ad-click data. Privacy.