Skip to content
WunderUI

Review Card

Pro

A customer review in a card: author, stars and date, an optional title, the text, photos and the shop's reply, with a Helpful button and a Report link.

Playground

PR
Priya Raman
Nov 2, 2026

Stable at full height

Stable at full height and quiet. Assembly took twenty minutes.

24 people found this helpful

Installation

Review Card comes with WunderUI Core and Pro, in the package from your plan. See the plans.

Then import what you need:

tsx
import { ReviewCard, ReviewCardProps } from "@wunderui/react"

Then use it:

tsx
import * as React from "react"
import { ReviewCard } from "@wunderui/react"

export function ProductReview() {
  const [helpful, setHelpful] = React.useState(false)

  return (
    <ReviewCard
      author={{ name: "Priya Raman", color: "indigo" }}
      verified
      rating={5}
      date="Nov 2, 2026"
      title="Stable at full height"
      helpfulCount={helpful ? 25 : 24}
      helpful={helpful}
      onHelpful={() => setHelpful((value) => !value)}
    >
      Stable at full height and quiet. Assembly took twenty minutes.
    </ReviewCard>
  )
}

Expected result: You should see a card for Priya Raman with a green Verified purchase badge, five stars, a title, the text and a Helpful button. Pressing the button turns it indigo and makes the count 25.

When to use

Use Review Card for

  • A customer review in a list on a product page
  • A review with a reply from the shop, photos and a vote that it helped
  • A review that a moderator holds back, with a note that says why

Use something else for

  • Rating for only the rating of a product, in a line or a tile (read-only, size sm), or asking a customer for one, where the stars are a control
  • Progress for the number of reviews per star level above the list (ProgressRow)

Content

The text is the content. A title, photos and the shop's reply are optional and sit between the header and footer in that order; photos are 72 px tiles with an 8 px radius and no alt text.

PR
Priya Raman
Nov 2, 2026

Stable at full height and quiet. Assembly took twenty minutes.

24 people found this helpful

Author

The author is a person: a name, plus a photo or a colour for tinted initials. Initials come from the name unless you pass them, and Verified adds a Verified purchase badge beside the name.

PR
Priya Raman
Nov 2, 2026

Stable at full height

Stable at full height and quiet. Assembly took twenty minutes.

24 people found this helpful

Rating

The rating is drawn as stars, rounded to whole stars, next to the date. The card does not print the number.

PR
Priya Raman
Nov 2, 2026

Stable at full height

Stable at full height and quiet. Assembly took twenty minutes.

24 people found this helpful

Actions

Helpful, Report and the menu button exist only when you pass their handlers, and the helpful count is the text on the left of the footer. The card holds no state: you own the vote and the count.

PR
Priya Raman
Nov 2, 2026

Stable at full height

Stable at full height and quiet. Assembly took twenty minutes.

24 people found this helpful

State

Flagged puts a moderation note above the review and turns the border yellow. A long text wraps and the card grows; nothing is cut off.

PR
Priya Raman
Nov 2, 2026

Stable at full height

Stable at full height and quiet. Assembly took twenty minutes.

24 people found this helpful

Keyboard interactions

The card is an article and has no focus stop of its own. Only the buttons inside are focusable, in this order: the menu button, Helpful, Report, each only when you pass its handler.

TaborShiftTab
Moves focus to the next or previous button inside the card, then on to the next card. Photos and the store reply are skipped.
EnterorSpace
Presses the focused button. On Helpful it calls , which flips and the count in your state; on Report and the menu button it calls their handler.

Behavior and motion

What the card does with its props, its optional parts and its handlers. It is controlled: it holds no state of its own.

Controlled vote
The card never changes the helpful state or count: Helpful calls your handler and you flip the state. A voted button shows a check mark and an indigo border, and the count reads 1 person or 24 people.
Optional parts
The menu button, Helpful and Report exist only with their handlers, and the title, photos, reply, badge and count only with their props. The footer always renders, so it may be empty.
Author
The avatar shows the first two initials of the author name unless you set them. A photo falls back to the initials if it fails; otherwise the tint is the author colour, orange by default.
Flagged
Flagged puts a yellow note under the header and turns the card border yellow. The note is in the page for everyone who sees the card, so show it only to the people who should see it.
Photos
Every photo is a 72 px tile cropped to fit, with an empty alt text, and the row wraps when there are too many. A tile that fails to load falls back to the yellow tint and the package icon.
Long content
The text, title and reply wrap and the card grows. In a narrow card the name and badge wrap onto a second line and the footer stacks its count beside the buttons, so nothing is cut off.
Words in the card
Verified purchase, Helpful, Report, Review menu and the count line are English and fixed. The date is a node, so write it in the format of your language yourself.
Motion and reduced motion
The card does not animate. The buttons inside use the shared press feedback, a 3 percent scale that is switched off under reduced motion.

Anatomy

The parts of the review card, numbered in the figure, with every optional part shown at once. The parts you do not pass are not drawn.

PR
Priya RamanVerified purchase
Nov 2, 2026

Stable at full height, quiet, and easy to assemble alone

Stable at full height and quiet. Assembly took twenty minutes with one person, and the frame has not wobbled in three months.

WunderUI Store· Nov 3, 2026

Thank you, Priya. A new tray is on its way.

24 people found this helpful
  • data-slot="review-card"

    An article with a hairline border, a 16 px radius and 16 px padding, with 12 px between its sections. It takes no other attributes and is not named, so give a list of reviews a label.

  • data-slot="avatar"

    The author as tinted initials, or as a photo with the initials as the fallback.

  • The author name in 12 px semibold text.

  • Optional

    A green Verified purchase badge beside the name.

  • The stars from the rating, then the date in 11 px tertiary text. The number itself is not printed.

  • Optional

    A ghost icon button with three dots, named Review menu. It only calls its handler; the card does not open a menu itself.

  • Optional

    The title in 14 px semibold text, above the text.

  • The review text in a 12 px paragraph. Use plain text or inline markup only, because it sits in a p element.

  • data-slot="product-image"Optional

    One 72 px square tile with an 8 px radius for every photo address. The row wraps when it is too wide, and the tiles have no alt text and no focus.

  • Optional

    A box with 8 px corners and a 1 px border on the page background. It holds the sender in semibold, the date after a dot and the reply text below, with an optional logo before the name.

  • Optional

    The line N people found this helpful on the left of the footer. It says 1 person for one.

  • Optional

    A plain small button that reads Helpful, and Helpful with a check mark and an indigo border once the vote is set. It carries the pressed state.

  • Optional

    A text button in the link colour that only calls its handler.

Best practices

  • Do

    Set the verified flag only for confirmed purchases; it adds a Verified purchase badge.

  • Do

    Pass the helpful handler with the helpful state to toggle the button, and the helpful count for the count text.

  • Do

    Own the vote. Keep the helpful state and the count in your own state, add one to the count while helpful is true, and send the vote to your server in the handler.

  • Do

    Open your own menu or sheet from the menu handler, and your own report form from the report handler. Both are plain click handlers.

  • Do

    Give a list of reviews a label, for example a section named Reviews. Every card is an unnamed article, and every card has a link that reads only Report.

  • Do

    Use the flagged state only for a moderator or the author, with a sentence that says why the review is held. Customers do not need to see it.

  • Don’t

    Don't put block elements in the review text. It is wrapped in a paragraph, so pass plain text or inline markup.

  • Don’t

    Don't rely on the photos to carry information. They have no alt text, so say what they show in the text.

  • Don’t

    Don't show the helpful button with a count that never changes. A button that does nothing is worse than no button, so leave the handler out when voting is off.

API reference

Review Card is one component and takes only the props below, so an id, aria-label or data attribute cannot be passed to it. The author is a person with a name and optional initials, photo and colour.

An article with a hairline border, a 16 px radius and 16 px padding, with 12 px between its sections. It takes no other attributes and is not named, so give a list of reviews a label.

PropTypeDefaultDescription
author requiredPerson—The person who wrote the review: (required), to replace the two letters taken from the name, for a photo, and for the tint of the initials, orange by default. Required.
rating requirednumber—The rating, drawn as Stars. It is rounded to a whole star, and the number is not printed. Required.
date requiredReactNode—The date of the review, shown after the stars. Any node, so you format it. Required.
children requiredReactNode—The text of the review, in a 12 px paragraph. Plain text or inline markup only. Required.
titleReactNode—A short headline above the text, in 14 px semibold. Nothing is drawn without it.
verifiedboolean—Adds a green Verified purchase badge beside the name. Set it only for a confirmed purchase.
photosstring[]—A list of image addresses, one 72 px tile each, under the text. The tiles have no alt text.
reply{ from: ReactNode; date?: ReactNode; text: ReactNode; logo?: ReactNode }—The answer of the shop: (the name), , and optionally and , which is drawn in front of the name. The box sits between the photos and the footer.
flaggedReactNode—A moderation note in a yellow box above the title. It also turns the border of the card yellow.
helpfulCountnumber—The number in the line on the left of the footer. The line is left out without it.
helpfulboolean—Whether the current reader has voted. It sets and the check mark of the Helpful button. Controlled: you own it.
onHelpful() => void—Adds the Helpful button and is called when it is pressed. Flip and update in it.
onReport() => void—Adds the Report link and is called when it is pressed. Open your own report form in it.
onMenu() => void—Adds a three-dot button named Review menu at the end of the header and is called when it is pressed. The card draws no menu; open yours from the handler.
classNamestring—Added to the . Use it for the width and the margins.

Notes for AI

Give your coding assistant the Markdown reference instead of screenshots.

MCPget_component("review-card")
InstallIncluded in Core and Pro

The full library index for assistants is at /llms.txt.