Skip to main content

​
Overview

Store Reviews API provides comprehensive review and rating functionality including customer reviews, store responses, helpfulness voting, and review management. Location: convex/stores/reviews.ts

​
Add Review

​
storeId
Id<'stores'>
required
Store ID to review
​
rating
number
required
Rating from 1-5 stars
​
comment
string
Review comment
const review = await convex.mutation(api.stores.reviews.addReview, {
  storeId: "j123456789",
  rating: 5,
  title: "Excellent food!",
  comment: "The pizza was amazing and delivery was fast. Highly recommended!",
  photoIds: ["s123456789"]
});

{
  "reviewId": "r123456789",
  "message": "Review added successfully"
}

​
Get Store Reviews

​
storeId
Id<'stores'>
required
Store ID
​
paginationOpts
PaginationOptions
required
Pagination options
const reviews = await convex.query(api.stores.reviews.getStoreReviews, {
  storeId: "j123456789",
  paginationOpts: { numItems: 10, cursor: null },
  sortBy: "newest"
});

​
Add Store Response

​
reviewId
Id<'storeReviews'>
required
Review ID to respond to
​
comment
string
required
Store response comment
await convex.mutation(api.stores.reviews.addStoreResponse, {
  reviewId: "r123456789",
  comment: "Thank you for your wonderful review! We're glad you enjoyed our pizza."
});
Reviews include photo support, verified purchase indicators, and helpfulness voting.