Settings Reference
Every setting in every Settings tab — Integrations, Pricing, Review, Naming, Listing, Lots, and Billing — with defaults.
Overview
This is the comprehensive reference for every user-configurable setting in RocketVault. Tabs are listed in the same order they appear in the sidebar of the Settings page. Admin-only tabs (Processing, Parallel, Market, Advanced) are not documented here — they govern internal AI pipeline behavior and aren't surfaced to normal accounts.
Most fields commit on blur. Tabs that batch updates show an amber dot until you click Save All.
Integrations
Connects RocketVault to external marketplaces. Currently eBay is the only supported destination; more are flagged "Coming Soon" inside the panel.
eBay seller prerequisites
Before connecting, your eBay account must already have:
- Completed seller registration (identity verification, payout bank account, tax info).
- Opted into Business Policies with at least one fulfillment, payment, and return policy.
- A shipping-from (merchant) location set on the eBay account.
Without these, eBay's Sell APIs return Invalid access token or empty-policy errors and every publish attempt fails silently.
eBay Connect
- Connect / Disconnect — Secure OAuth flow. Mobile uses redirect; desktop uses popup.
- Switch Account — Re-authorize with a different eBay account. Forces an eBay re-login first.
- Token expires — Surfaced under the badge. Tokens auto-refresh; if refresh fails, you'll be prompted to reconnect.
Business policies
Picked from the live policies eBay returns at connect time:
- Fulfillment policy (shipping)
- Payment policy
- Return policy
Use the Configure policies here → link to open eBay's policy manager in a new tab. RocketVault re-fetches your policy list when you reconnect.
Shipping rule by card price
Optional rule that overrides the bulk-publish form's shipping picker on a per-card basis.
- Enabled — Master on/off switch. The rule is "saved but inactive" until every required field is filled.
- Threshold price (USD) — Cutoff price. Cards below get the "under" service; cards at or above get the "over" service.
- Under / Over service — Picked from the backend's allowed shipping-services list, grouped by carrier (USPS, UPS, FedEx).
- Under / Over cost (USD) — Each branch has a Free checkbox; toggling it locks cost at $0.
If any field is blank, the rule shows an amber warning and falls back to the bulk-publish form's shipping default.
Listing sync interval
Tier-gated, mirrored against subscription_tiers.allowed_sync_intervals in the backend:
| Tier | Available intervals |
|---|---|
| Free / Collector / Seller | Once a day |
| Pro | + 1 hour, + 6 hours |
| Enterprise | + 15 minutes, + 30 minutes |
Sync Now is always available regardless of tier — kicks off an immediate orders + active-listings refresh. Sync runs in batches (one paginated orders fetch + one active-listings fetch per cycle), so faster cadences don't multiply per-listing API calls.
Auto-refresh stale listings
Once-a-day sweep that revises listings with 0 views in the last 30 days. Tier-gated daily caps (50/day on Seller, 250/day on Pro+).
- Auto-refresh enabled — Master toggle.
- Strategy —
title_only(rotate the title),price_sync(push the latest market price), orboth(recommended). - Last run and today's count — Surfaced in the panel.
Hard refresh (end-and-relist, brand-new item ID) is always manual — never automated.
Pricing
Controls how cards get priced when there's no live market data. Most cards use SCP/eBay comps; these values apply only as a fallback.
Base Prices
Floor for raw, no-parallel cards.
| Setting | Default | Description |
|---|---|---|
| Price Floor | $0.99 | Minimum listing price for any card |
| Base Veteran | $0.75 | Default price for non-rookie base cards |
| Base Rookie | $1.50 | Default price for rookie base cards |
Multipliers
Stack on top of the base price for premium attributes.
| Setting | Default | Description |
|---|---|---|
| Rookie | 2.0x | Multiplier applied to rookie cards |
| Autograph | 1.5x | Multiplier for autograph cards |
| Memorabilia / Relic | 1.3x | Multiplier for relic/memorabilia cards |
| Gem Mint (PSA/BGS 10) | 3.0x | Multiplier for gem-mint graded cards |
| Mint (PSA/BGS 9) | 1.5x | Multiplier for mint graded cards |
Parallel Tiers
Used when a parallel card has no SCP price and no eBay comps. The tier is picked by keyword-matching the parallel name.
| Setting | Default | Triggered when parallel name contains |
|---|---|---|
| Standard parallel | $4.00 | Default tier — anything not matching the lists below |
| Retail SP parallel | $10.00 | shimmer, mojo, atomic, genesis, checkerboard |
| Case hit / 1-of-1 / SSP | $125.00 | superfractor, 1/1, ssp, case hit, black |
Insert & Relic Tiers
Used when an insert or relic has no SCP price and no eBay comps.
| Setting | Default | Description |
|---|---|---|
| Common insert | $1.50 | Default tier for inserts not matching the popular-insert list |
| Popular insert | $3.50 | Inserts whose name contains: silver, explosion, lazer, burst |
| Plain relic | $3.50 | Single-color jersey/relic, no patch |
| Patch / multi-color relic | $10.00 | Multi-color or patch relic |
Pricing Sources
| Setting | Default | Description |
|---|---|---|
| Use RocketVault database pricing | On | Use RocketVault Pricing as primary source |
| Fallback to Rule-Based | On | Use rule-based pricing when no market data is available |
Per-sport multipliers (Baseball 1.0, Basketball 1.2, Football 1.1, Hockey 0.9, Soccer 0.8) are applied automatically and aren't user-editable from the UI.
Review
Decides which cards land on the Needs Attention chip on the Available tab.
| Setting | Default | Description |
|---|---|---|
| Auto-Apply Threshold | 0.85 | Confidence required to auto-apply parallel detection |
| High Confidence Threshold | 0.85 | Threshold for high-confidence matches |
| Medium Confidence Threshold | 0.70 | Threshold for medium-confidence matches |
| Review Threshold | 0.50 | Confidence below this requires manual review |
| Price Anomaly Threshold | 5.0x | Flag cards priced > N× the base value |
| High Value Review Threshold | $50 | Cards at or above this price route to high-value review |
| Missing Player → Review | On | Send to review if player can't be identified |
| Missing Set → Review | On | Send to review if set can't be identified |
| Serial Without Number → Review | On | Send to review if serial is detected but the number is missing |
| Auto-Confirm High-Confidence Parallels | On | Auto-confirm parallels that clear all confidence + value gates |
| Auto-Confirm Soft-Warning Threshold | $25 | Cards in $25–$50 still auto-confirm but get a softer badge for spot-checks |
Naming
Configures the filename convention for paired front / back image uploads. The Settings page shows a live filename preview as you edit.
| Setting | Default | Description |
|---|---|---|
| Front Image Suffix | _F | Suffix marking a front image (e.g. _F, -front) |
| Back Image Suffix | _B | Suffix marking a back image (e.g. _B, -back) |
| Separator Character | _ | Separator between base name and suffix |
| Case Sensitive | Off | Whether suffix matching is case-sensitive |
Listing
Defaults applied to AI-generated eBay listings.
| Setting | Default | Description |
|---|---|---|
| Include Condition Description | On | Add condition info to the listing description |
| Include Shipping Info | On | Add shipping details to the listing description |
| Default Listing Duration | 30 days | How long fixed-price listings stay live |
| Title Max Length | 80 | Hard cap from eBay |
| Auto-Calculate Shipping | On | Calculate shipping based on weight |
| Default Handling Time | 1 day | Business days before shipment |
| Use Emojis in Listings | Off | Include relevant emojis in AI-generated titles + descriptions (no effect on rule-based or template titles) |
| Description Style | Structured | Structured (consistent table per card) or AI Enhanced (rich AI prose, falls back to structured) |
| Description Heading | "Card Details" | Heading at the top of every description |
| Description Tone | Professional | Professional / Casual / Enthusiastic — applies to AI-enhanced descriptions |
| Shipping Policy Text | Standard envelope copy | Shipping line in the description |
| Returns Policy Text | "30-day returns accepted." | Returns line in the description |
| Custom Footer Text | empty | Optional line at the end of every description |
| Description Details | all on | Per-field include toggles: Player, Sport, Set, Card Number, Parallel, Insert, Serial, Attributes, Grading, Condition |
The Powered by RocketVault branding toggle has moved to the Billing tab — it's tied to the listing-branding subscription discount.
Lots
Defaults for the AI Lot Generator (Seller plan and above).
| Setting | Default | Description |
|---|---|---|
| Default Cards Per Lot | 10 | Default size for AI-generated lots (2–50) |
| Default Lot Discount % | 15% | Discount applied to lot pricing (0–50) |
| Minimum Lot Value | $5.00 | Minimum total card value required to create a lot |
| Auto-Generate Lot Names | On | Automatically generate descriptive lot names |
Billing
The full billing surface for your RocketVault subscription.
Current plan
- Tier name, status badge (active / trialing / past_due / canceled), trial / renewal date.
- Card usage bar — current count vs. tier limit, including any one-time card-slot packs you've purchased.
Plan comparison
- All five tiers in one grid with in-app upgrade/downgrade buttons.
- Upgrades are immediate and prorated. Downgrades take effect at the end of the current billing cycle.
Powered by RocketVault branding
Toggle to add a small Powered by RocketVault.io mark to your listing images and descriptions. Active enrollment earns a recurring discount: $5/mo off Seller, $10/mo off Pro. Disabling it stops the discount at the end of the current billing period.
Card-slot packs
One-time purchases that add storage above your tier limit. Slots accumulate and never expire.
| Pack | Slots | Price |
|---|---|---|
| Small | 100 cards | $3 |
| Best value | 500 cards | $10 |
Auto-refresh activity
Surfaces the most recent auto-refresh stats — last run timestamp, today's revised count, daily cap remaining.
Cancel
Step-by-step cancel flow: preview the impact, optionally accept a downgrade offer, then confirm. Your account stays active until the end of the current billing period; data is retained for 30 days after that.
Before Canceling
If you're on Collector or higher, export your inventory to CSV before downgrading. CSV export is not available on Free.
Settings & Configuration
Configure integrations, pricing, review thresholds, naming, listings, lots, and billing — all from one tabbed Settings page.
Account & Subscription Setup
Manage your profile, choose a subscription plan, configure billing, and customize your settings.
Plans & Pricing
Complete guide to RocketVault's subscription tiers, feature gates, signup trial, card-slot packs, and billing options.