# Reviews & Ratings

> Star ratings and written reviews of products, with moderation, store replies and imported reviews.

> Markdown version of https://kanorio.com/en/developers/products/reviews. Append `.md` to any developer docs URL for this format. Index: https://kanorio.com/llms.txt · MCP: https://app.kanorio.com/api/mcp

Status: **Partial**

Reviews let customers rate and describe what they bought. A review points at its target, and the target stores only the aggregate rating and display settings.

## Core objects

- **Reviews.** A rating and text from a verified buyer, or an imported review. Buyer reviews are approved or rejected; imported reviews can also be deleted.
- **Replies.** The store's public answer to a review.
- **Settings.** Per product: whether reviews are on, the visibility threshold and any historical rating to start from.

## How the APIs fit

- Read published reviews and the rating summary with the Content Delivery API, or render them with `<kanorio-reviews>` and `<kanorio-rating>`.
- Customers write and edit their own reviews through the Customer API.
- Moderate, reply, import and change settings with the Management API.
- Webhooks report submitted, published and replied reviews.

## What the APIs expose

| Capability | Status | API | Elements | Hosted site | Webhooks |
| --- | --- | --- | --- | --- | --- |
| Reviews & ratings for products (services when bookings ship) | Partial | Management API `reviews.*` (list, get, approve, reject, reply, import, delete_imported, settings.get/update); Delivery `GET /reviews?target=` and `GET /reviews/summary?target=`; Customer API `GET/POST/PATCH /customer/reviews` | `<kanorio-reviews>` and `<kanorio-rating>` | `/store/products/reviews` and the hosted product page | `reviews.submitted`, `reviews.published`, `reviews.replied` |
| Photo or video attachments on reviews | Not offered | — | — | — | — |
| Multi-step moderation workflows and reviewer assignment | Not offered | — | — | — | — |
| Store-wide mixed review wall | Not offered | — | — | — | — |
| Google Product Ratings feed generation | Not offered | — | — | — | — |
| Hiding or auto-rejecting reviews by star rating | Not offered | — | — | — | — |

## API reference

- Management API: [Reviews](https://kanorio.com/en/developers/management-api/reviews) (9 operations)
- Content Delivery API: [Reviews](https://kanorio.com/en/developers/delivery-api/reviews) (2 operations)
- Customer API: [Reviews](https://kanorio.com/en/developers/customer-api/reviews) (3 operations)

## Webhook events

- `reviews.submitted`: Fired when a buyer submits or edits a review (it is pending moderation).
- `reviews.published`: Fired when a review becomes public: approved by the store, or imported.
- `reviews.replied`: Fired when the store posts or replaces its public reply to a review.

Payloads: https://kanorio.com/en/developers/webhooks/events

## Elements

- `<kanorio-reviews>`: Published reviews for a product or service with the rating summary, verified badges, replies and load more.
- `<kanorio-rating>`: Compact star rating and review count for a product or service.

## Recent changes

- 2026-10-28: Reviews: moderate, reply, import and settings

Full changelog: https://kanorio.com/en/developers/changelog

## For site owners

Dashboard help: https://kanorio.com/en/help/reviews