Discovery — browsing and filtering your library

When you open BetterReviews, the first thing you see is Discovery — a two-column layout that turns your whole review library into something you can actually work with day to day. It’s where your marketing team will spend most of their time.

What’s on the page

Left rail (your library, organized)

• Products with a review-count badge next to each name. Click a product to filter the right pane to just that product’s reviews.
• A search-by-name box at the top of the product list so you don’t have to scroll a long catalog.
• Sort: toggle the product list between A–Z and Most reviews to reorder how products appear.

Right pane (the reviews themselves)

• A virtualized result list of reviews — 50 per page. Every row shows rating, reviewer display name, product, the first chunk of review text, and a marketing-ready chip when the review qualifies.
• A free-text search box at the top — type what you’re looking for (“comfortable”, “fits true to size”, “shipping delay”) and Discovery uses semantic ranking to surface the best matches.
• Bulk-select checkboxes on every row, with Download as ZIP and Copy as table actions in the header.

Before you put a downloaded photo or quote into an ad, email, or social post, make sure the review is Cleared to use — featuring a customer’s words or photos in marketing needs their permission. See requesting permission to feature reviews.

Above everything

When you haven’t run the cutover yet, a slim “Since you last visited” strip shows what changed in your library since the last time you opened the dashboard: how many reviews were newly imported, how many got analyzed, how many got tagged marketing-ready, and how many new ad-ready photos came in. The strip disappears once you cut over — at that point the dashboard is no longer “wait and watch” mode and the strip would just be noise.

Filtering

The filter panel below the product list covers the basics:

• Rating range (1–5)
• Has photos toggle
• Date range with a Polaris date picker
• Marketing-ready only — narrows to the strict predicate (marketing_potential = 'high' AND word_count >= 50)
• Sort by newest, oldest, highest rating, most words, or quality score

Click a filter and the URL updates with the matching query params. This means the audit page can link directly into a pre-filtered view — for example, the “Browse marketing-ready” CTA on your library audit drops you into Discovery with the marketing-ready filter already applied.

Free-text search

The search box at the top of the right pane uses semantic ranking — it understands what you mean, not just the words you typed. Type “delivery problems” and it surfaces reviews mentioning shipping delays, package damage, late arrivals, even if those exact words aren’t there.

A few things to know about search mode:

• Some filters pause while search is active. Free-text uses a different ranking path that doesn’t apply every filter (product type, tags, has-photo, marketing-ready, stage, status, sort). Those controls grey out with a tooltip; an info banner above the result list calls out exactly how many filters are paused. Clear the search to re-apply them.
• Rating, sentiment, date range, verified buyer, and the product picker keep working in both modes.
• Search is capped at 256 characters and rate-limited per store; you won’t hit either in normal use.

Bulk actions

Select reviews with the checkboxes in the result list, then use the header bar:

• Download as ZIP packages the photos from your selected reviews. The export shares a 5/hour and 30/day cap with the existing marketing photo export, so if you’ve already pulled photos elsewhere today, expect the same limit to apply.
• Copy as table copies a TSV (tab-separated values) block of the selected rows to your clipboard — rating, reviewer, product, word count, has-photo, created-at. Paste into a spreadsheet, a Notion table, a sales doc, whatever.

A “Send to Slack channel” action is on the roadmap but not in this release.

How Discovery fits with the rest

• The Reviews tab (at /reviews) is your moderation queue — pending approvals, stage chips, takedown actions. Discovery doesn’t replace it; the two are separate surfaces for separate jobs (Reviews = moderation; Discovery = daily marketing workflow).
• The Library audit (during onboarding) drops you into pre-filtered Discovery views via “Browse →” CTAs. Both pages use the same review projection so what you see in the audit matches what you see when you click through.
• The legacy Overview (your old home page with stat cards) is reachable at /legacy for one release cycle while teams transition. It will be removed in a future release.

When you’d use Discovery

• Pulling a batch of marketing-ready photos for a Meta or Klaviyo campaign — filter to marketing-ready + has-photo, bulk-select, Download as ZIP.
• Finding the best 5-star review about a specific product to feature on a landing page — search by product name, sort by quality score, copy the text.
• Skimming what changed in your library while you were away — the “Since you last visited” strip is right at the top.
• Spotting a trend before it hits your inbox — search “sizing” or “delivery” to surface reviews mentioning common topics across products.