Documentation
Getting Started
Spadeberry turns your product photos into fully optimized eBay listings using AI. This guide walks you through the entire workflow — from signup to published listing.
Quick Start
- Create an account — every new account gets a free trial with 50 listing tokens (no credit card required)
- Connect your eBay account via secure OAuth in Settings
- Upload product photos — drag and drop up to 5,000 at a time
- Assign SKUs to group photos by product
- Generate listings — AI creates titles, descriptions, item specifics, and selects the category
- Edit & review — adjust anything before going live
- Publish to eBay — individually or in batch
When you're ready for a paid plan, visit Pricing to compare tiers and features.
Uploading Photos
Supported Formats
JPG / JPEG, PNG, GIF, HEIC, HEIF, and WebP.
Limits
- Max file size: 50 MB per photo
- Max batch size: 5,000 files per upload
How to Upload
Drag and drop files directly into the upload area, or click to open the file picker. You can select as many files as you need — they'll upload in the background so you can keep working.
Background Removal
Optionally remove the background from the first photo of each SKU to create a clean, white-background product image — ideal for eBay's search results. Background removal uses photo tokens (separate from listing tokens). You can toggle this on or off per batch.
Photo Tips
- Use high-resolution images (minimum 500x500 pixels)
- Ensure good lighting and clear focus
- Capture multiple angles of your product
- Include close-ups of important details, labels, and any flaws
SKU Assignment
SKUs (Stock Keeping Units) group all photos that belong to the same product into a single listing.
How It Works
- After uploading, go to the Assign SKUs page
- Select the photos that belong to one product
- Enter a SKU or use the auto-incrementing SKU feature to generate one automatically
- Repeat for each product
Batch Assignment
You can assign SKUs to multiple groups in a single session. Photos can also be rotated on this page if the orientation needs adjusting.
Generating Listings
Once photos are grouped by SKU, the AI analyzes them to create a complete, publish-ready eBay listing.
What the AI Generates
- Title — SEO-optimized with relevant keywords
- Description — detailed product write-up with features and condition notes
- Item Specifics — brand, model, size, color, material, and more
- Category — best-fit eBay category selected automatically
- Condition — new, pre-owned, etc., based on photo analysis
- Measurements — extracted from photos when visible (optional)
Standard Mode
Uses 1 listing token per listing. Supports up to 24 photos per SKU and includes full AI category detection.
Economy Mode
Stretch your tokens further with three independent toggles you can mix and match:
| Toggle | Savings | What Changes |
|---|---|---|
| Pre-select category | -0.20 tokens | You choose the eBay category instead of AI |
| Limit to 6 photos | -0.20 tokens | AI analyzes fewer photos (faster results) |
| Limit to 2 photos | -0.40 tokens | Minimum photo input for fastest generation |
| Economy AI | -0.20 tokens | Uses a lighter AI model (still high quality) |
The 6-photo and 2-photo limits are mutually exclusive — pick one or the other. With all maximum savings enabled (pre-select category + 2-photo limit + Economy AI), a listing costs just 0.20 tokens — up to 5x more listings from the same balance.
Editing & Reviewing
Every generated listing lands on the Ready to Publish page where you can review and edit before going live.
What You Can Edit
- Title, description, price, and quantity
- Category and condition
- All item specifics (brand, size, color, etc.)
- Measurements
- Photo selection and ordering
Listing Templates
Create and save custom HTML description templates. You can load any saved template into a listing and set one as your default so every new listing uses it automatically.
Retry Failed Listings
If a listing fails to generate, you can retry it for free — no additional tokens are charged. The retry button appears on any listing with an error status.
Publishing to eBay
Before Publishing
- Review all listing details for accuracy
- Set your pricing and quantity
- Verify item condition and specifics
- Configure your business policies in eBay (payment, return, and fulfillment) — Spadeberry will use these when publishing
Batch Publishing
Select one listing or hundreds — Spadeberry publishes them in a queue with real-time progress tracking so you can monitor the entire batch.
Publishing Steps
- Go to the Ready to Publish page
- Select the listings you want to publish
- Review and accept the publishing terms
- Click Publish to eBay
Tokens & Billing
Two Token Types
- Listing tokens — used to generate listings (1 token each at standard rate, less with Economy Mode)
- Photo tokens — used for optional background removal ($0.03 each)
How Tokens Work
- Your membership plan adds listing tokens to your balance each month
- Tokens accumulate and never expire — unused tokens roll over
- Need more? Purchase additional listing tokens at $0.50 each or photo tokens at $0.03 each any time
Visit Pricing for full plan details and token allotments.
Multi-User Access
Available on Professional and Enterprise tiers.
- Add up to 5 operators per account
- Each operator's photos, SKUs, and listings are kept separate (scoped data isolation)
- Works on both web and mobile
Manage operators from the Settings page under your account.
Need Help?
- FAQs — searchable knowledge base covering common questions
- AI Chat — click the chat icon in the bottom-right corner for instant answers
- Contact Support — reach the team directly for anything else