Discovery — browsing and filtering your library

Discovery lives at /discovery in the BetterReviews admin. It is a two-column layout that turns your whole review library into something you can work with day to day, and it is where your marketing team will spend most of their time. It sits alongside the Overview dashboard you land on when you open the app, and alongside the Reviews tab you use for moderation.

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

Before you run the cutover, 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. That means any pre-filtered view is a plain link you can bookmark or share with a teammate. Filter down to marketing-ready reviews with photos, copy the URL, and whoever opens it lands on the same view.

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, 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 Overview (at /) is the page you land on when you open BetterReviews. It has stat cards, setup prompts, and a snapshot of how collection is doing. Overview answers “how are we doing”. Discovery answers “show me the reviews”.
• 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).
• Discovery isn’t in the main navigation yet, so reach it by going to /discovery directly. Bookmark it if your team uses it daily.

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.