# Reviews

URL: /systems/reviews · Id: `system:reviews`

> Reviews shows each Person’s evaluation of a Product, Offer or Brand where evaluations are shown, requested, moderated and mirrored from elsewhere.

[Reviews](/business/nouns/review) asks buyers to rate a [Product](/business/nouns/product), [Offer](/business/nouns/offer) or [Brand](/business/nouns/brand), moderates what they write, shows it, and mirrors reviews posted elsewhere. A [Startup](/business/nouns/startup) asks for reviews and answers them; it never writes one.

## Summary
| Part | This System |
| --- | --- |
| Group | Marketing |
| Status | Beta: it works, and its Verbs may still change |
| Shelf | Reference: documented, never offered first |

You can ask:

- “Ask happy customers for a review”
- “Show reviews on the pricing page”
- “Hide this review until we check it”

## What you get
| Part | This System |
| --- | --- |
| Starts | On for every Startup at creation, with nothing to install. |
| Built from | [Integrations](/code/platform/integrations), [Email delivery](/systems/communications/email), [Database](/code/platform/capabilities/database), [Market data](/systems/marketing/market-data) |

## Nouns it owns
| Noun | Definition |
| --- | --- |
| [Review](/business/nouns/review) | A Review is one person’s rated evaluation of a Product, Offer or Brand, shown on a Site or an outside venue and mirrored from there. |

## Verbs
| Verb | Object | Approval | Event |
| --- | --- | --- | --- |
| [Review.create](/business/nouns/review/create) | [Review](/business/nouns/review) | None | `Review.created` |
| [Review.update](/business/nouns/review/update) | [Review](/business/nouns/review) | None | `Review.updated` |
| [Review.publish](/business/nouns/review/publish) | [Review](/business/nouns/review) | Asks first | [`Review.published`](/business/events/Review.published) |
| [Review.withhold](/business/nouns/review/withhold) | [Review](/business/nouns/review) | None | [`Review.withheld`](/business/events/Review.withheld) |
| [Review.remove](/business/nouns/review/remove) | [Review](/business/nouns/review) | None | [`Review.removed`](/business/events/Review.removed) |

## Events
| Direction | Event | How |
| --- | --- | --- |
| Emits | `Review.created` | By [Review.create](/business/nouns/review/create) |
| Emits | `Review.updated` | By [Review.update](/business/nouns/review/update) |
| Emits | [`Review.published`](/business/events/Review.published) | By [Review.publish](/business/nouns/review/publish) |
| Emits | [`Review.withheld`](/business/events/Review.withheld) | By [Review.withhold](/business/nouns/review/withhold) |
| Emits | [`Review.removed`](/business/events/Review.removed) | By [Review.remove](/business/nouns/review/remove) |

## States
The lifecycle of a [Review](/business/nouns/review):

| State | Meaning | Moves to |
| --- | --- | --- |
| `submitted` (first) | Written and not yet shown. | `published` by [Review.publish](/business/nouns/review/publish); `withheld` by [Review.withhold](/business/nouns/review/withhold); `removed` by [Review.remove](/business/nouns/review/remove) |
| `published` | Shown on the Startup’s Pages or its venue, with its rating counted. | `withheld` by [Review.withhold](/business/nouns/review/withhold); `removed` by [Review.remove](/business/nouns/review/remove) |
| `withheld` | Kept off display for a recorded reason, never for its rating. | `published` by [Review.publish](/business/nouns/review/publish); `removed` by [Review.remove](/business/nouns/review/remove) |
| `removed` | Taken down for good at its author’s or its venue’s request; the record stays. | None: it ends here. |

## Who operates it
| Part | This System |
| --- | --- |
| Accountable | [Marketing Lead](/agents/marketing/marketing-lead) |
| Team | [Marketing Team](/agents/marketing) |
| Seat | A role agent holds it until a Human is seated. |
| Autonomy | `supervised` |

## Approvals and limits
| Verb | Rule | Detail |
| --- | --- | --- |
| [Review.publish](/business/nouns/review/publish) | A person says yes first | None. |

## Processes that use it
None.

## Rail underneath
None.

## Views and dashboards
| View | Shows | Metrics |
| --- | --- | --- |
| The [Marketing Lead](/agents/marketing/marketing-lead)’s view | The Metrics its accountable Role answers for. | [Play-sourced Customers](/agents/marketing#play-sourced-customers), [Fully loaded acquisition cost](/agents/marketing#cac-fully-loaded), [Organic share](/agents/marketing#organic-share), [Referral share](/agents/marketing#referral-share), [Spam rate](/agents/marketing#spam-rate), [Play payback](/agents/marketing#play-payback) |

## Access
What each Access level may call here.

| Access level | May call |
| --- | --- |
| `owner` | Every Verb (7) |
| `admin` | Every Verb (7) |
| `member` | Every Verb (7) |
| `viewer` | Read only (2 of 7) |

## Import and export
None.

## Fees and pricing
None.

## Availability and limits
| Part | This System |
| --- | --- |
| Status | Beta: it works, and its Verbs may still change |

## Compliance notes
Controls it carries:

- [Boundary protection](/systems/trust-and-governance/controls/boundary-protection)
- [Upstream review](/systems/trust-and-governance/controls/upstream-review)
- [Point-in-time recovery](/systems/trust-and-governance/controls/point-in-time-recovery)
- [Processing definitions](/systems/trust-and-governance/controls/processing-definitions)

## Related Systems
- [Surveys](/systems/surveys)
- [Sites](/products/site/sites)
- [Success](/systems/success)

## Example
A [SaaS](/products/templates/saas) for restaurant scheduling asks each owner for a review on day 30, after their third published schedule. Reviews sends the owner to [G2](/workflows/plays#g2) and mirrors the published review on the pricing [Page](/business/nouns/page). A one-star review opens a [Conversation](/business/nouns/conversation) with that owner before anyone replies in public.