Settings Reference
Every setting in every Settings section — Account, Plan & Billing, eBay Connection, Pricing, Listing, Naming, Lots, Notifications, and Review triggers — with defaults.
Overview
This is the comprehensive reference for every user-configurable setting in RocketVault. The Settings page is grouped into sections:
| Section | Panels |
|---|---|
| You | Account, Plan & Billing |
| Connections | eBay Connection |
| Selling defaults | Pricing, Listing, Naming, Lots |
| Notifications | Notifications |
| Advanced | Review triggers |
Admin-only panels (Processing, Parallel, Market) are not documented here — they govern internal AI pipeline behavior and aren't surfaced to normal accounts.
Most fields commit on blur. Panels that batch updates show an amber dot until you click Save All.
Account
Lives under You. Your identity and credentials — this replaces the old standalone Profile page (/profile redirects here).
- Display name and phone number — editable inline.
- Email address — read-only; managed by your authentication provider (Firebase).
- Password — change it here if you signed up with email/password.
- Email verification — resend the verification email if you haven't confirmed your address.
- Delete Account — permanently removes your account and data. Irreversible.
eBay Connection
Lives under Connections. 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 in the background, so you won't be asked to reconnect on a schedule. You'll only see a Reconnect prompt if eBay revokes the connection (e.g. you remove RocketVault from your eBay app permissions).
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.
Sync also runs on a server-side schedule that fires every 15 minutes and honors each user's chosen interval — so your listings update on their own and you don't need to come back and hit Sync Now manually unless you want an immediate refresh.
Refresh pricing
Default price-drop percentages that the Refresh dialog pre-fills when you refresh stale listings. The dialog lets you adjust the percentage per run — these are starting points, not hard rules.
- Soft refresh price drop — default 3%. Pre-filled when the dialog's style is Soft refresh.
- Hard refresh price drop — default 0% (relist at the exact same price). Pre-filled when the style is Hard refresh.
Both are capped at 25%, and every drop is clamped to your minimum listing price — RocketVault will never drop a $50 card to $1.99 because you fat-fingered a setting.
Pricing
Lives under Selling defaults. Controls how cards get priced when there's no live market data. Most cards use RocketVault Pricing and 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 RocketVault Pricing match 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 RocketVault Pricing match 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 triggers
Lives under Advanced. 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 |
| Comp-Priced Auto-Ready | On | Don't send a card to review just because its price came from live eBay comps (instead of an exact catalog match), when the comps are confident enough and the card is below the high-value threshold. Thin-comp or high-value cards still route to review. |
| Comp-Price Min Confidence | 0.55 | Minimum comp confidence required for Comp-Priced Auto-Ready to skip review. Lower it to auto-ready more comp-priced cards; raise it (or turn the toggle off) to review more of them. |
Naming
Lives under Selling defaults. 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
Lives under Selling defaults. 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 lives on the Plan & Billing panel — it's tied to the listing-branding subscription discount.
Lots
Lives under Selling defaults. 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 |
Notifications
Lives under Notifications. One switch controls your Daily Briefing delivery:
| Setting | Default | Description |
|---|---|---|
| Daily briefing | On | Controls both the daily briefing generation and the weekly briefing email. Turning it off stops both; the weekly email's one-click Unsubscribe link does the same thing. |
Plan & Billing
Lives under You. 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 |
Refresh activity
Surfaces the most recent listing-refresh stats — last run timestamp, today's refreshed 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 your account, eBay connection, selling defaults, notifications, and review triggers — all from one grouped Settings page.
Account & Subscription Setup
Manage your account details, 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.