SV SmartViner Guide
SmartViner user guide

Everything SmartViner can do

Feature-by-feature walkthroughs — set it up, tune it, and get the most out of Amazon Vine. Jump to any feature from the menu.

Getting started

Signing in

SmartViner is a dashboard that layers on top of your Amazon Vine session. You sign in once with a SmartViner account; it reads your Vine orders and reviews using your existing Amazon login — there is no separate "connect Amazon" step.

How to use

  1. Open the SmartViner dashboard. If you are signed out you will see the Log in card ("Welcome back — sign in to continue").
  2. Enter your Email and Password (use Show/Hide to reveal it), then press Log in.
  3. No account yet? Click Sign up and fill Full name, Email, Password, Confirm password → Create account.
  4. Make sure you are also logged into Amazon Vine in the same browser — Orders and Reviews use your Amazon session.

Options & settings

  • Remember me — keeps you signed in (sliding ~29.5-day session, so active users rarely log in again).
  • Forgot password? — starts the reset flow.

Tip · Your Amazon password is never entered here — SmartViner reaches Amazon through the browser session you are already logged into.

The Log in card.
The Log in card.

The Dashboard feed

The Dashboard & columns

The Dashboard is a horizontally-scrolling board of feed columns. Each column is an independent live feed of Vine products from one source. Columns fill top-to-bottom and wrap, and the whole board scrolls left/right.

How to use

  1. Open Dashboard from the sidebar.
  2. The sticky top toolbar holds board-wide controls: Add column, Import from UV, Refresh all, session-stat chips, Sound/Muted, NSFW, the save-status dot, and Auto Pagination.
  3. Scroll the board with the on-screen arrows, the mouse wheel, or [ / ]. Press ? for the keyboard-shortcuts overlay.

Tip · Column layout auto-saves to your account and syncs across devices (watch the top-right dot: “Saving…” → green “Saved”). Live items and current page are not persisted.

Tip · A silent keep-awake audio runs while the Dashboard is open so background collection, alerts, and pagination keep going when you switch tabs.

The board with several columns and the top toolbar.
The board with several columns and the top toolbar.

Queue types

Every column has a Queue type that decides where its items come from — shown as a colored badge in the header. Four map to Amazon Vine queues; three are SmartViner features.

Options & settings

  • RFY — "Recommended for You" (Vine’s personalized queue).
  • AFA — "Available for all" (last-chance queue).
  • AI — "Additional items" (Vine’s Additional Items queue; the badge means Additional Items, unrelated to the AI Shopper).
  • Search — a live keyword search against Amazon Vine.
  • Explore (DB) — searches SmartViner’s own catalog of every product ever seen (not a live Amazon fetch).
  • ALERT — a real-time push feed of items never seen before; has Pause/Resume and can drive the AI Shopper.
  • LIKE — items you liked.

Tip · ALERT and LIKE columns have nothing to page through, so they are excluded from Refresh all and all auto-pagination. Only ALERT columns show the AI Shopper panel.

The seven queue types at a glance.
The seven queue types at a glance.

Add, clone, reorder & remove columns

Columns are fully managed from the board — add by type, duplicate with all settings, drag to reorder, or delete.

How to use

  1. Add: click Add column and pick a type row.
  2. Import existing: Import from UV pulls your UltraViner queues in (one-shot, safe to re-run).
  3. Clone: column kebab (⋯) → Clone (D) — copies filters, categories, size, and last items.
  4. Reorder: grab the 6-dot handle on the header and drag.
  5. Remove: kebab (⋯) → Delete column (immediate, no confirmation).

Tip · Every add/clone/reorder/delete auto-saves — there is no separate save button.

Column settings

Each column’s full configuration lives in the Queue settings modal — "Tune refresh, pagination, filters, and display options." Open it from the kebab (⋯) → Settings (,); changes apply live.

Options & settings

  • Display Type — Mosaic / Original / List (Mosaic = no title, Vanilla = Vine default, List = title on side).
  • Queue sorting — Alphabetical / Date / Smart / Vanilla.
  • Items per row (1–4) and Title lines (None–3).
  • Color — accent swatch or custom hex for the column.
  • Behavior — Auto-Refresh, Auto Paginate, Max page, Pause on hover, Play sound on new items.
  • Preview — "Run preview" applies your filter rules to recent products and shows Would show / Would hide.

Tip · Quick tile-size tweaks without opening settings: keys 19/+/-, or drag the column’s right/bottom edges.

The Queue settings modal (Basics + Behavior).
The Queue settings modal (Basics + Behavior).

Filtering & tuning

Category filter

For queues that expose Amazon categories, a two-level category / subcategory dropdown narrows the column to one category tree. It only appears when the column has category data.

How to use

  1. Below the column header, open the first dropdown ("All Categories") and pick a parent.
  2. A second dropdown appears ("All Subcategories") — pick a child to narrow further.
  3. Use Clear category / Clear subcategory to reset.

Tip · This refetches from Amazon (server-side narrowing), unlike keyword filter rules which hide items in the browser.

Keyword & boolean filter rules

Per-column Filter rules hide or allow items by matching words in the title. Rules are either Hide (deny) or Allow (only show matches), as simple keyword chips or full boolean expressions with AND / OR / NOT, parentheses, and "quoted phrases".

How to use

  1. Open Queue settings → Filter rules.
  2. Click Add rule (or a starter chip like "Hide refurbished").
  3. Set Hide / Allow, then use Chips (type words) or Expression (boolean) view.
  4. Watch the live "matches N of M" status; use Run preview to see the effect on real items.
  5. Optional: click AI, describe what to filter in plain language, and add the proposed rules.

Options & settings

  • Single words match on word boundaries ("man" ≠ "manual"); quoted phrases match as substrings.
  • An account-wide deny list (Account settings) applies on top of per-column rules.

Tip · ALERT columns filter on the title only, so a shown alert never vanishes under your cursor.

An AI-generated Allow rule (Expression view) with a live preview of what would show vs hide.
An AI-generated Allow rule (Expression view) with a live preview of what would show vs hide.

Auto-refresh & auto-pagination

Columns can refresh and page themselves in the background so the board keeps collecting — per column, or board-wide.

Options & settings

  • Auto-Refresh (per column) — re-fetches the current page every N seconds (1–60). Footer chip turns green when on.
  • Auto Paginate (per column) — walks pages every N seconds, then loops; footer chip turns blue. "Max page" 0 = all pages.
  • Auto Pagination (board-wide toggle in the toolbar) — cycles all search-type columns through their pages on a shared, staggered schedule; keeps running when the tab is hidden.
  • Window / Stagger — in Auto Pagination Settings, set an active time window and a per-request stagger ("Delay between page requests to look more human").

Tip · LIKE and ALERT columns never auto-paginate. Auto-paginating columns are skipped by Refresh all.

Tip · Stuck? Run __svAutoPager.why() in DevTools for a one-line reason.

Throttle protection

When Amazon starts rate-limiting SmartViner (HTTP 429/503, a 404 storm, or a captcha page), the pager automatically stops, pauses for a growing cooldown, then resumes gently — so you don’t dig a deeper hole.

Options & settings

  • The pause escalates on each hit: 30s → 1m → 2m → 4m → 8m → 15m (capped).
  • After 3 clean loads it steps the backoff back down and returns to normal speed.

Tip · Nothing to configure — you’ll see a toast "Amazon is throttling — pausing auto-pagination for …". It resumes on its own.

Route the feed through a proxy

If Amazon rate-limits or blocks your IP, SmartViner can route just the Vine feed fetches through your own rotating residential proxy, so blocked feeds get a fresh IP. Image CDNs and every other site stay direct, and your normal browsing is untouched.

How to use

  1. Open Settings → Network.
  2. Enter your proxy Endpoint (host : port) — it must be IP-whitelisted.
  3. Toggle Route Vine feed through proxy on.

Options & settings

  • Endpoint — host and port of your residential proxy (IP-whitelisted auth).
  • Only Vine feed traffic is proxied; images and all other sites stay direct.

Tip · Use a sticky-session endpoint so your normal browsing keeps one IP. Pairs with throttle protection — a fresh IP plus the gentle backoff avoids deeper blocks. Advanced & optional — most users never need it.

Settings → Network — the proxy endpoint + toggle.
Settings → Network — the proxy endpoint + toggle.

Combine variants

An account-wide display option that collapses "variant spam" — floods of the same product in different designs/sizes — into a single tile, so a real product isn’t buried under 30 near-duplicates. Display-only; nothing is deleted. On by default.

How to use

  1. Toggle it in Account → Combine variants ("Collapse floods of the same product in different designs into one cell").
  2. On the board, a collapsed group shows an indigo-ringed tile with a ▦ N pill ("N designs — click to pick one").
  3. Click the group to open the design picker, then click any design to open its product modal.

Tip · Grouping is conservative — it needs a real brand plus a shared category/size signature and several near-identical members, so unrelated items never merge.

A collapsed variant group with the ▦ count pill + picker.
A collapsed variant group with the ▦ count pill + picker.

Freshness heatmap

A thin row of small cells between a column’s items and its pager — one cell per page — colored green by how recently that page last loaded fresh items. Green fades over ~2 hours, so you can see where new stuff just landed and jump to it.

How to use

  1. In any multi-page column, look just above the pager for the strip of small squares.
  2. Bright green = fresh very recently; pale = a while ago; gray = old/never. The current page has a blue ring.
  3. Click any cell to jump to that page.

Tip · It remembers across reloads (stored per column) and scrolls itself to keep the current page centered.

The freshness strip gradient above the pager.
The freshness strip gradient above the pager.

Discovery

24-Hour Recap

A personalized "what’s new today" feed. It ranks every product that appeared in the last 24 hours by how closely it matches your taste — learned from your order history — and scores each with a match %, flagged as bought or missed.

How to use

  1. Click 24h Recap in the sidebar.
  2. Read the stats line: "N matches · N new items scanned · taste from N orders".
  3. Each tile shows a purple match % badge, a bought/missed pill, an added-ago badge, title, price, and queue tag.
  4. Use the Best match / Newest toggle to re-sort; click Refresh to reload.

Options & settings

  • Best match (default) — highest match % first. Newest — freshest first.
  • Category chips narrow the recap to one auto-tagged category.

Tip · Needs order history first — the recap learns from your last ~400 unique orders. Only items scoring ≥50% appear, so quiet days can be short.

Tip · A "bought" tile means you ordered any member of that variation family; the variants badge shows how many designs were folded in. Adult items are always filtered out of the recap.

The Recap with match-% badges, sort toggle, and category chips.
The Recap with match-% badges, sort toggle, and category chips.

Smart categories

SmartViner automatically tags every product with a category (like Home Kitchen or Phone Accessories) using a local, on-device semantic model — no manual tagging, no cloud cost. In the Recap these become clickable filter chips.

How to use

  1. Open 24h Recap; if items are tagged, a chip row appears under the header.
  2. The first chip is All. Each category chip shows its name + a count.
  3. Click a chip to filter; click it again (or All) to clear. Combines with sort + pagination.

Tip · Chips only show categories present in the current recap, so the available filters change day to day. These are SmartViner’s own tags, distinct from the Amazon category filter inside a feed column.

The Recap category chips with counts, one selected.
The Recap category chips with counts, one selected.

Buying & reviewing

Product modal & size-aware checkout

The product popup that opens when you click a tile. Its standout is Available options — a smart variant/size picker that auto-selects your size (from your profile’s Default size), keeps the same colour where it can, and greys out unavailable combinations. From there you run the Vine $0 checkout through a confirmation overlay where you click Amazon’s own "Place your order".

How to use

  1. Click a tile to open the modal; use ◀ ▶ or ←/→ to move Prev/Next.
  2. If the product has variations, pick from Available options (unavailable combos are struck through).
  3. Confirm Ship to at the bottom (checkout is disabled until an address is set).
  4. Click Checkout; if Amazon needs the interactive step, the confirmation overlay opens badged Order not placed yet.
  5. Review Amazon’s page, then I placed the order, Open in new tab, or red Cancel to bail out safely.

Options & settings

  • Default size (Account → profile, e.g. "M", "9", "32W x 30L") — the modal auto-picks the matching variant, keeping the same color where possible.
  • Median-size fallback — if your size doesn’t match (or isn’t set) it picks the middle size, never Amazon’s default XS/XXL.

Tip · Nothing is ordered until Amazon’s "Place your order" — the Cancel button always aborts safely. The AI Shopper drives this exact modal for autonomous orders, which is why the size logic protects unattended orders too.

The highlighted "Available options" — a smart variant/size picker that auto-picks your size.
The highlighted "Available options" — a smart variant/size picker that auto-picks your size.

AI Reviewer

Turns your own honest product experience into a guideline-compliant Vine review, then prefills it straight into Amazon’s form so you only hit Submit. Photos are converted to JPEG for you (Amazon rejects HEIF).

How to use

  1. On the Reviews page, click Write with AI on a pending item (opens seeded with its title/ASIN/image).
  2. 1. Product — confirm the title; optionally paste the listing details + ASIN.
  3. 2. Your experience — set the star rating (required) and optionally what you liked/disliked, plus Tone and Length.
  4. 3. Photos & video — drop files (auto-converted to JPEG, drag to set attach order).
  5. Click Generate review, edit inline, then Prefill on Amazon → just hit Submit.

Options & settings

  • Tone — Balanced / Enthusiastic / Critical / Concise. Length — Short / Medium / Long.
  • Photos — up to 12; per-tile rotate/flip/remove; HEIC/HEIF converted server-side (shows a green "JPEG ✓" badge).

Tip · The prefill button opens Amazon’s form but never submits — you always review and click Amazon’s own Submit. Photo order matters; drag tiles before prefilling.

A generated draft with photo tiles + the Prefill button.
A generated draft with photo tiles + the Prefill button.

AI Shopper

A per-column autopilot (ALERT columns only) that evaluates incoming items against criteria you write in plain English and — when the AI approves with enough confidence — places the Vine $0 order for you automatically. It respects a daily cap, a nightly sleep window, and keeps a full Decision Log.

How to use

  1. Open an ALERT column’s settings → the purple AI Shopper panel, and enable it.
  2. In "What kind of items should I order?" describe your criteria (required).
  3. Set safety caps: Max ETV, Daily cap, Sleep start/end, Confidence threshold.
  4. Leave Dry-run mode on and click Run test to see how a real item is judged before spending anything.
  5. When confident, turn Dry-run off. Review everything in the Decision Log.

Options & settings

  • Confidence threshold (50–95%, default 70%) — the AI must return "order" and meet this, or the item is skipped.
  • Daily cap (1–10, default 1) and optional Max ETV gate (off by default).
  • Sleep window — the shopper only acts inside it (handles windows crossing midnight).

Tip · ⚠️ With Dry-run off, an approved item is ordered end-to-end with no click — always test with Dry-run first. Sized items use your Default size (or median), and only one autonomous checkout runs at a time.

The AI Shopper panel — criteria, caps, sleep window, confidence, and Dry-run.
The AI Shopper panel — criteria, caps, sleep window, confidence, and Dry-run.
Every item must pass all safety gates before the AI is called.
Every item must pass all safety gates before the AI is called.

AI Shopper Decision Log

The audit view for everything the AI Shopper has done — KPI tiles plus grouped, timestamped rows for what was ordered, is in progress, failed, was skipped by the AI, or gated before ever reaching the AI.

How to use

  1. Click AI Shopper in the sidebar (Decision log).
  2. Pick a window: 24h / 3d / 7d / 30d.
  3. Read the KPIs: Ordered, In progress, Errored, Skipped, Gated, plus Total ETV ordered.
  4. Scroll the grouped sections; click a thumbnail to open the item on Amazon.

Tip · "In progress — verify in Amazon" is the one bucket needing your eyes. The "Gated" bucket is tuning feedback: lots of gated_daily_cap → raise the cap.

KPI tiles + Ordered and Gated rows.
KPI tiles + Ordered and Gated rows.

Your workflow

Orders

A searchable list of your Amazon Vine orders. SmartViner reads your Amazon orders page, shows each item (image, title, ASIN, FMV, date), and quietly syncs them so you can search across pages you’ve visited. AI Shopper orders get an "AI" badge.

How to use

  1. Open Orders; the first page loads automatically.
  2. Watch the status pill cycle "Scanning…" → "Syncing…" → Up to date.
  3. Search (title, ASIN, order id) across all synced pages, not just what’s visible.
  4. Click a title or Order details to open it on Amazon.

Tip · Search only covers pages you’ve already opened at least once — page through your history to make search complete.

Orders with the "Up to date" pill, counters, AI badge + FMV chip.
Orders with the "Up to date" pill, counters, AI badge + FMV chip.

Reviews

Your Vine review queue, split into Awaiting review and Completed. Jump straight to Amazon’s form or draft with AI without leaving SmartViner.

How to use

  1. Open Reviews (opens on Awaiting review).
  2. For a pending item: Write with AI (built-in drafter) or Write review (Amazon’s form).
  3. For a completed item: Edit review / View review.
  4. Search all reviews in the current tab (title, ASIN, status).

Tip · Status dots: amber = awaiting, sky = draft/in-progress, green = published/completed.

Awaiting review tab with Write with AI + Write review.
Awaiting review tab with Write with AI + Write review.

Account-status alerts

A hard-to-miss banner that pins to the top of every Amazon page when your Vine account is at risk of closure for low review completion — surfacing a warning Amazon otherwise buries on /vine/account.

How to use

  1. It appears automatically on Amazon pages when risk is detected (nothing to enable).
  2. Read the message (Amazon’s own wording) and click Vine account → to see details.
  3. Clear your pending reviews; once you’re back in good standing the banner clears itself.

Tip · It has no dismiss button by design — a genuine risk can’t be clicked away. Opening /vine/account is the authoritative re-check.

Account & privacy

Settings & profile

The Settings screen (account menu → Account settings) controls language, appearance, notifications, display behavior, filter rules, and shows your read-only Vine account details.

Options & settings

  • General — Language, Theme, Notifications, Auto refresh, Combine variants (default on), Hide NSFW items (default off), Default size.
  • Filters — account-wide allow/deny rules applied to every column and notification.
  • Account — read-only Vine data (status dates, marketplace, tier, membership/violation status).

Tip · Combine variants, Hide NSFW, and Theme take effect immediately; Language, Notifications, Default size, and Filters persist after Save changes.

The Settings screen — Account tab (tier, status, marketplace).
The Settings screen — Account tab (tier, status, marketplace).

Performance telemetry

A tiny gauge at the bottom of the sidebar showing the tab’s JavaScript heap %. Click it for a live Telemetry panel — a diagnostics tool for spotting slowdowns during long sessions.

Options & settings

  • Chip color = health: grey OK, amber ≥80%, red + pulsing ≥92%.
  • Panel shows JS heap, Phase, Long tasks, Stalls, DOM nodes, Recent blocks.

Tip · If heap hits ~92%, SmartViner shows a countdown and auto-reloads the tab to stay healthy. "JS heap %" is a trend indicator, not the tab’s full footprint.

The memory chip with the Telemetry panel open.
The memory chip with the Telemetry panel open.

Privacy & your data

SmartViner never stores your Amazon password and works only on Amazon Vine and smartviner.com. Your settings and orders/reviews are stored in your SmartViner account to power the feed and recommendations.

How to use

  1. Read the full policy at smartviner.com/privacy.

Ready to try it?

Free during beta. Works on Chrome, Edge, Firefox & Safari.

Add to Chrome