Commerce glossary

Reviews and customer media

Ratings, written reviews, photos and videos that past buyers leave on products, plus the requests that ask for them, the moderation that checks them and the places they are shown.

All areas

48 parts and 21 phrases. Apps in this area include Judge.me, Yotpo, Okendo, Loox, Trustpilot, Stamped.

Collecting reviewsreviews.collectShowHow reviews reach the store: asked for by email, written on the site, or brought in from elsewhere.

Asking for a reviewreviews.collect.requestShowWhen and how the store asks a buyer to leave a review.

How to extend

EventMany side by sideevent.shipment.delivered event.review.submittedA plugin that sends its own requests, such as by SMS, starts from the delivery event and stops once the review event arrives.

Part	Litestore today	How to extend
Request after delivery`reviews.collect.request.after_delivery`A review request is a message that asks the buyer to review the products a set number of days after the order is delivered.	Core`modules/email/automations.ts`	Event · many
Review reminder`reviews.collect.request.reminder`A reminder is a second request sent a few days later only when the buyer has not yet reviewed the order.	Core`modules/email/automations.ts`	Event · many
Discount after a review`reviews.collect.request.discount_reward`A review incentive sends the buyer a discount code after they leave a review, often a larger one for a photo or video review.	Plugin	Event · many
Form inside the email`reviews.collect.request.in_email_form`An in-email form puts the star rating and text box inside the request email, so the buyer submits without opening the store.	Plugin	Event · many
Request by text message`reviews.collect.request.sms`An SMS request sends the review link to the buyer's phone instead of their inbox.	Plugin	Event · many

Writing a review on the sitereviews.collect.formShowThe form a buyer fills in on the product page, and who may use it.

How to extend

SlotMany side by sidestorefront.slot.product.reviewsA plugin adds its own questions or upload fields below the review form on the product page.

Part	Litestore today	How to extend
Review form`reviews.collect.form.on_site`The review form on the product page collects a star rating, a title, the text, photos and an optional link to a social post.	Core`modules/reviews/storefront/review-form.tsx`	Slot · many
Buyers only`reviews.collect.form.purchase_gate`The purchase gate rejects a review from any account that has no order containing the product, and hides the form from it.	Core`modules/reviews/storefront/actions.ts`	Slot · many
Custom question`reviews.collect.form.custom_question`A custom question is an extra field on the form, such as skin type or usual size, whose answer is stored with the review.	Plugin	Slot · many
Review without an account`reviews.collect.form.guest`A guest review accepts a review from someone who is not signed in, usually checked by an emailed link.	Plugin	Slot · many

Bringing reviews inreviews.collect.importShowReviews copied from a file, another review app, a marketplace listing or social media.

How to extend

ProviderMany side by sidereview importerEach import source is one importer; several can sit side by side and all write through the same review records.

Part	Litestore today	How to extend
Import from a file`reviews.collect.import.csv_file`A file import reads a CSV with SKU, rating, text and reviewer name and creates one pending review per row, recorded as an import run.	Core`modules/integrations/import/reviews.ts`	Provider · many
Import from another review app`reviews.collect.import.other_app`An app import pulls existing reviews, photos and dates from another review service through its API when a store moves over.	Plugin	Provider · many
Import from a marketplace listing`reviews.collect.import.marketplace_listing`A marketplace import copies the reviews shown on a supplier's marketplace listing onto the matching product.	Plugin	Provider · many
Import from social media`reviews.collect.import.social_post`A social import brings in photos or videos where customers tagged the brand on a social network, after the poster grants permission.	Plugin	Provider · many

Showing reviewsreviews.displayShowWhere reviews appear: on the product page, on other store pages and in the customer's account.

On the product pagereviews.display.productShowThe review list, the summary and the tools shoppers use to read it.

How to extend

SlotMany side by sidestorefront.slot.product.reviews storefront.slot.listing.card_below_priceA display plugin, such as a photo gallery or stars on product cards, renders in these places and reads published reviews.

Part	Litestore today	How to extend
Review list`reviews.display.product.list`The review list shows each published review with stars, text, photos, the reviewer's name and the date.	Core`modules/reviews/storefront/review-list.tsx`	Slot · many
Rating summary`reviews.display.product.summary`The rating summary shows the average star rating and the number of published reviews, recalculated when a review is published or removed.	Core`modules/reviews/product-review-stats.ts`	Slot · many
Sort reviews`reviews.display.product.sort`Sorting orders the list by newest, highest or lowest rating, or most helpful.	Core`modules/reviews/storefront/actions.ts`	Slot · many
Helpful vote`reviews.display.product.helpful_vote`A helpful vote adds one to a review's helpful count, with one vote per shopper per review.	Core`modules/reviews/storefront/actions.ts`	Slot · many
Imported review label`reviews.display.product.source_label`The source label shows where an imported review came from, such as Sourced from a named marketplace, so it is not passed off as written on this store.	Core`modules/reviews/reviewer-name.ts`	Slot · many
Review media gallery`reviews.display.product.media_gallery`A media gallery collects every review photo and video for a product into one scrollable grid.	Plugin	Slot · many
Stars on product cards`reviews.display.product.card_stars`Card stars show the average rating and count under each product in a grid or list.	Plugin	Slot · many
Filter reviews`reviews.display.product.filter`A review filter narrows the list to one star level, reviews with media or one attribute answer.	Plugin	Slot · many
Product questions and answers`reviews.display.product.questions`Product Q&A lists questions shoppers ask about a product with answers from staff or past buyers.	Planned	Slot · many

Elsewhere in the storereviews.display.storeShowReviews shown away from a single product page.

How to extend

SectionMany side by sidestorefront.section.reviewsA reviews section on a storefront page shows recent published reviews; a plugin adds other layouts as section types.

Part	Litestore today	How to extend
Recent reviews row`reviews.display.store.recent_row`A reviews section shows a row of recent published reviews with stars and the product on the home page or any custom page.	Core`modules/storefront/sections/review-list.tsx`	Section · many
My reviews`reviews.display.store.my_reviews`My reviews lists in the customer's account the reviews they have written and the products they can still review.	Core`modules/reviews/storefront/my-product-reviews.tsx`	Section · many
All-reviews page`reviews.display.store.all_reviews_page`An all-reviews page lists reviews from every product on one page.	Plugin	Section · many
Store rating badge`reviews.display.store.rating_badge`A rating badge shows the store's overall score from a review service in the header or footer.	Plugin	Section · many

What is reviewedreviews.subjectShowThe thing a review is about: one product, or the store as a whole.

How to extend

Core onlyProduct reviews belong to the core product record; a store-wide review needs its own records and lives in a plugin.

Part	Litestore today	How to extend
Product review`reviews.subject.product`A product review belongs to one product and one customer, and each customer can leave one review per product.	Core`prisma/schema.prisma`	Core only
Store review`reviews.subject.store`A store review rates the shop as a whole, such as delivery and service, rather than one product.	Plugin	Core only

What a review holdsreviews.contentShowThe rating, words, media and markers stored on each review.

How to extend

SlotMany side by sidestorefront.slot.product.reviewsA plugin that stores extra review data, such as video or fit ratings, keyed by review id renders it inside each review.

Part	Litestore today	How to extend
Star rating`reviews.content.star_rating`The star rating is a whole number from one to five that every review must have.	Core`modules/reviews/storefront/schema.ts`	Slot · many
Title and text`reviews.content.text`The title and text hold the reviewer's own words about the product.	Core`modules/reviews/storefront/schema.ts`	Slot · many
Review photos`reviews.content.photo`Review photos are images the reviewer attaches, stored as a list of image addresses on the review.	Core`modules/reviews/storefront/photo-url-input.tsx`	Slot · many
Review video`reviews.content.video`A review video is a short clip the reviewer uploads with the review.	Plugin	Slot · many
Link to a social post`reviews.content.social_link`A social link is the address of the reviewer's own post about the product, shown with the name of the network it is on.	Core`modules/reviews/social-platform.ts`	Slot · many
Attribute rating`reviews.content.attribute_rating`An attribute rating scores one quality of the product on a scale, such as fit from runs small to runs large.	Plugin	Slot · many
Purchase badge`reviews.content.purchase_badge`The purchase badge marks a review whose author has a paid order for the product, and the review stores the order it came from.	Core`modules/reviews/storefront/review-list.tsx`	Slot · many

Checking reviewsreviews.moderationShowWhat happens between a review being sent and it being shown.

How to extend

EventMany side by sideevent.review.submitted event.review.approvedA filter or pre-moderation plugin reads each submitted review and flags it before staff approve it.

Part	Litestore today	How to extend
Moderation queue`reviews.moderation.queue`The moderation queue holds every new review as pending until staff publish or reject it, and the state comes from the publish and reject dates.	Core`modules/reviews/review-lifecycle.ts`	Event · many
Publish or reject`reviews.moderation.approve_reject`Publishing shows a review and recalculates the product's average; rejecting hides it for good.	Core`modules/reviews/admin/moderation.ts`	Event · many
Bulk moderation`reviews.moderation.bulk`Bulk moderation publishes, rejects or archives many selected reviews in one action.	Core`modules/reviews/admin/review-batch-bar.tsx`	Event · many
Archive and restore`reviews.moderation.archive`Archiving hides a review without deleting it and removes it from the product's rating, and restoring brings it back.	Core`modules/reviews/review-archive.ts`	Event · many
Auto-publish rule`reviews.moderation.auto_publish`An auto-publish rule publishes new reviews that meet a condition, such as four stars or more, without waiting for staff.	Plugin	Event · many
Word filter`reviews.moderation.word_filter`A word filter holds back any review that contains a word from a blocked list.	Plugin	Event · many
AI pre-check`reviews.moderation.ai_check`An AI pre-check reads each new review and marks spam, abuse or off-topic text before a person looks at it.	Planned	Event · many
Report a review`reviews.moderation.shopper_report`A report button sends a published review back to staff when a shopper flags it as wrong or abusive.	Planned	Event · many
Public reply`reviews.moderation.reply`A public reply is the store's answer, shown under the review on the product page.	Plugin	Event · many

Sending reviews elsewherereviews.outboundShowRatings passed to search engines, shopping feeds and ad platforms.

How to extend

ProviderMany side by sidereview feedEach outside destination, such as a shopping engine's ratings feed, is one feed provider reading published reviews.
EventMany side by sideevent.review.approvedA feed plugin pushes a review to its destination when it is published.

Part	Litestore today	How to extend
Rating in search results`reviews.outbound.search_markup`Rating markup adds the average rating, review count and recent reviews to the product page's structured data so search engines can show stars.	Core`modules/storefront/seo/structured-data.ts`	Provider · manyEvent · many
Rating in the product feed`reviews.outbound.product_feed_rating`The product feed includes each product's average rating and review count for shopping engines and AI agents that read it.	Core`app/api/products/feed/route.ts`	Provider · manyEvent · many
Reviews feed to a shopping search engine`reviews.outbound.shopping_engine_feed`A shopping engine reviews feed sends every published review in the engine's own format so stars appear on its product ads and listings.	Plugin	Provider · manyEvent · many
Post a review to social media`reviews.outbound.social_post`Review sharing turns a published review into an image post for a social network.	Plugin	Provider · manyEvent · many

What the phrases mean

The words apps use for a feature, and the plain parts the feature is made of, in the order they happen.

Phrase	Made of
photo reviews	reviews.content.photo reviews.display.product.list
video reviews	reviews.content.video reviews.display.product.media_gallery
verified buyer	reviews.collect.form.purchase_gate reviews.content.purchase_badge
review request	reviews.collect.request.after_delivery
review reminder	reviews.collect.request.after_delivery reviews.collect.request.reminder
in-email reviews	reviews.collect.request.after_delivery reviews.collect.request.in_email_form
review discount	reviews.collect.request.discount_reward The discount is sent after the review; it does not depend on the rating given.
review widget	reviews.display.product.summary reviews.display.product.list
star ratings on collection pages	reviews.display.product.card_stars
review carousel	reviews.display.store.recent_row
review moderation	reviews.moderation.queue reviews.moderation.approve_reject
auto-publish reviews	reviews.moderation.auto_publish
AliExpress review import	reviews.collect.import.marketplace_listing reviews.display.product.source_label
import reviews from CSV	reviews.collect.import.csv_file reviews.moderation.queue
UGC	reviews.content.photo reviews.content.video reviews.collect.import.social_post In review apps, UGC means customer-made photos and videos, from reviews or from tagged social posts.
Instagram UGC	reviews.collect.import.social_post reviews.display.product.media_gallery
review attributes	reviews.content.attribute_rating
Google Shopping reviews	reviews.outbound.shopping_engine_feed
review rich snippets	reviews.outbound.search_markup
store reviews	reviews.subject.store reviews.display.store.rating_badge
product Q&A	reviews.display.product.questions

Phrases left out

These phrases mean different things at different apps, so the glossary doesn't map them.

social proofVendors use it for reviews, sold counters, recent-purchase popups and trust badges alike.
review syndicationIt means a Google ratings feed at one vendor and sharing reviews across a retailer network at another.
reputation managementIt covers anything from replying to reviews to watching mentions on outside sites.

Sources

The app documentation these parts were checked against.