Product Reviews

About

This plugin adds a `reviews` collection to a Payload v3 config. Each review points to a product through a relationship field, and the target collection is set by the `productsCollection` option (default `products`). Reviews carry an author name, an author email, a 1 to 5 star rating, an optional title, a comment capped at 1000 characters, and a status of pending, approved, or rejected. New reviews start as pending. Public create and read access is open to anyone. Updates and deletes require a logged-in user. The author email is restricted to authenticated users at the field level, so it stays out of the public API. The plugin also forces the `verified` checkbox to false whenever it is set to true, on any write. The README describes this as admin-only verification, but the hook does not check the requester's role, so in the current code nobody can save a review as a verified purchase. The plugin does not create database tables. The README includes SQL for Postgres that has to be run by hand when Payload runs in dev mode. The README also covers the frontend side: a Next.js route that returns approved reviews with an average rating, a product page that renders them, and a JSON-LD `aggregateRating` block built from the same data. The `adminEmail` option is accepted but nothing reads it, so no notification is sent. The `enabled` flag turns the whole plugin off.

Package info

Package name

payload-plugin-reviews

Latest version

1.0.2

Unpacked size

14 kB

License

MIT

Weekly downloads

289

Last publish

Oct 11, 2026