Reviews

Independently verified patient reviews, with the volume always shown.

<!-- GENERATED FILE. Do not edit by hand. Source: components/help/content/. Run npm run gen:docs. -->

Purpose & Business Context

The Reviews page is the credibility engine of the public site. Trust is the currency of medical travel, so this page does more than show a score: it explains where the reviews come from, how many sit behind the rating, and that lower ratings are never hidden. It is built to let a sceptical visitor judge reliability for themselves.

Commercially, honest, verified social proof is what converts a hesitant browser. By publishing the review count beside every rating and separating verified-transaction reviews from open public ones, the page earns trust precisely by refusing to overstate it.

Screen Overview

A server-rendered page with the shared chrome and a teal page hero, then three sections: a reputation summary (a big overall score with a star distribution, beside a per-source breakdown), a verification explainer (three cards on how reviews are verified), and a patient reviews section built around the client-side ReviewsExplorer.

The ReviewsExplorer is a filterable list: source filters (All sources, Trustpilot, Google, Verified visit) plus a 'Verified transactions only' toggle, a live results count, and a responsive grid of review cards.

Controls & Components

• Page hero: eyebrow, title, subtitle and three stats (blended rating, verified reviews, verified transactions percentage).
• Reputation summary: the overall score with stars and total reviews, a five-row star distribution with percentage bars, and a per-source list (Trustpilot, Google, Verified visits) each with rating and count.
• Verification explainer: three cards (Verified transactions, Volume shown always, The full picture) describing the review policy.
• Source filter chips: All sources, Trustpilot, Google, Verified visit; the active chip is filled teal.
• Verified transactions only toggle: a chip that limits the list to reviews tied to a verified transaction.
• Results count: '<n> reviews' for the current filters.
• Review cards: each shows the author avatar and country, a source badge, the star rating and date, a title and body, and the procedure and clinic.

Field Definitions

• Blended rating: The overall rating averaged across all review sources (4.6).
• Verified transactions %: The share of reviews tied to a real booking rather than open submission (86%).
• Distribution: The percentage of reviews at each star level, from 5 stars down to 1, shown as bars.
• Source: Where a review originates: Trustpilot (verified-transaction), Google (public business reviews), or Verified visit (post-treatment survey).
• Verified: Whether a review is tied to a verified transaction; the toggle filters to these, and a shield marks them.
• Review card fields: Author, country, source badge, star rating, date, title, body, and the procedure and clinic the review concerns.

User Actions & Workflows

1. Read the hero and reputation summary for the overall score, the distribution and the per-source breakdown.
2. Read the verification explainer to understand how reviews are sourced and why the count is always shown.
3. Filter the list by source (Trustpilot, Google or Verified visit), or leave All sources selected.
4. Toggle 'Verified transactions only' to see just the reviews tied to a real booking.
5. Read individual review cards, noting the procedure and clinic each one concerns.

Navigation & Relationships

Reached from: the Reviews item in the primary nav, the brand logo via Home, and the Read verified reviews button in the Home reviews section.

Leads to: no onward routes of its own beyond the shared header and footer; its job is to build trust in place.

Pairs with: the Quality page, which covers third-party trust signals and the vetting process behind these clinics, and the marketplace, where the same verified-review ratings appear on each clinic card.

Business Rules & Constraints

• The review count is always published beside the rating, so reliability can be judged, not just the score.
• Lower ratings are never hidden; public Google reviews sit alongside verified-transaction ones.
• The source filter is single-select; the 'Verified transactions only' toggle combines with it.
• Verified-transaction reviews (Trustpilot and post-treatment surveys) are distinguished from open public reviews.
• Public screen: fully browsable without an account.

Data Dependencies

The hero and reputation summary read reputation (overall rating, total, verified percentage, distribution and per-source breakdown). The ReviewsExplorer reads reviews (the filterable cards) from lib/data. The verification explainer copy is authored on the page.

• reputation: overall rating, totals, distribution and per-source rows
• reviews: the filterable review cards with source and verified flags

Error Handling & Edge Cases

• A filter combination with no matches simply shows a zero count and an empty grid; the page does not error.
• The 'Verified transactions only' toggle layered on a source filter narrows correctly, including to an empty set.
• Aside from the filters, the page is static, so a visitor sees no loading or fetch-failure states.
• Mobile: the summary cards stack, the filter chips wrap, and the review grid reflows to a single column.

User Roles & Permissions

• Public (no sign-in required): Anyone can read and filter reviews. Signed-out visitors browse the page freely.
• Get started / Sign in: The header CTAs lead into the authentication flow and the patient portal; the Reviews page itself requires no account.

Related Features & Functionalities

The Quality page (vetting and third-party trust signals), the marketplace (per-clinic verified-review ratings on each card), the Home reviews section (the three sample cards that link here), and the platform-wide review-volume policy that the verification explainer describes.

Flow & Screenshots

flowchart LR
  Reviews[Reviews] --> Hero[Page hero]
  Reviews --> Summary[Reputation summary]
  Reviews --> Verify[Verification explainer]
  Reviews --> Filter[Source filters + verified toggle]
  Filter --> List[Review cards]
  Reviews -.shared rating.-> Clinics[Find Care cards]

Guided Walkthrough Steps

The in-app walkthrough for this screen has 6 steps (auto-advances every 5 seconds; Prev / Pause / Next; click outside to exit):

1. Verified reviews you can trust ([data-tour="reviews.hero"])

We publish independently verified reviews and always show the count, so you can judge reliability for yourself. The stats summarise the picture.

1. The full reputation ([data-tour="reviews.summary"])

The overall score, the star distribution, and a breakdown by source: Trustpilot, Google and post-treatment surveys, each with its own rating and count.

1. How reviews are verified ([data-tour="reviews.verification"])

Verified transactions are tied to a real booking, the volume is always shown, and lower ratings are never hidden.

1. Filter the reviews ([data-tour="reviews.filter"])

Filter by source, or switch on Verified transactions only to see just the reviews tied to a real booking.

1. Read what patients say ([data-tour="reviews.list"])

Each card shows the author, source, rating and date, plus the procedure and clinic the review concerns.

1. Cross-check quality ([data-tour="site.nav"])

For the vetting and accreditations behind these clinics, the Quality page in the nav goes deeper.