---
title: "The Reviews facade — Reviews for Laravel | Roundly"
description: "Every reviews operation on one facade — for($subject) handles, the swap-aware query(), and flat verbs for moderation, votes and verification."
url: https://roundly-consulting.com/open-source/docs/reviews-for-laravel/facade
language: en
---

[All packages](https://roundly-consulting.com/open-source.md)

[Reviews for Laravel](https://roundly-consulting.com/open-source/docs/reviews-for-laravel.md)

# The Reviews facade

Everything the package does is one call away on the Reviews facade — RoundlyConsulting\\Reviews\\Facades\\Reviews, also registered as a global Reviews alias:

```php
use RoundlyConsulting\Reviews\DataTransferObjects\CreateReviewData;
use RoundlyConsulting\Reviews\DataTransferObjects\UpdateReviewData;
use RoundlyConsulting\Reviews\Facades\Reviews;

// One subject: author a review, read its aggregates, list its reviews
Reviews::for($product)->by($user)->rating(5)->content('Great')->create();
Reviews::for($product)->summary();            // RatingSummary DTO
Reviews::for($product)->average();            // ?float
Reviews::for($product)->count();              // int (approved)
Reviews::for($product)->distribution();       // [5 => 120, 4 => 80, ...]
Reviews::for($product)->photoCount();         // photos on approved reviews
Reviews::for($product)->reviewsWithPhotos();  // approved reviews that carry a photo
Reviews::for($product)->query()->approved()->mostHelpful()->paginate();

// Every review (swap-aware) — e.g. the moderation queue
Reviews::query()->pending()->latestFirst()->paginate();

// Act on one review
Reviews::create(new CreateReviewData(author: $user, reviewable: $product, rating: 5));
Reviews::approve($review);
Reviews::reject($review, 'Spam');
Reviews::update($review, new UpdateReviewData(content: 'Edited'));
Reviews::delete($review);
Reviews::respond($review, $owner, 'Thanks!');
Reviews::vote($review, $user, helpful: true);
Reviews::removeVote($review, $user);
Reviews::verify($review);
Reviews::unverify($review);

// Tests
$fake = Reviews::fake();
```

## Methods

| Method | Returns | Does |
| --- | --- | --- |
| `for(Model $reviewable)` | `ReviewableScope` | Scopes the calls below to one subject. |
| `for(…)->by(Model $author)` | `PendingReview` | Starts a review of the subject; finish with ->create(). |
| `for(…)->summary() / average() / count() / distribution() / photoCount() / reviewsWithPhotos()` | `aggregates` | Approved, top-level reviews of the subject only. |
| `for(…)->query()` | `Builder<Review>` | The subject’s top-level reviews, every status (responses via $review->responses). |
| `query()` | `Builder<Review>` | Every review on the configured model — every subject, status and response. |
| `create(CreateReviewData $data)` | `Review` | Creates a review from a DTO — the builder’s terminal step. |
| `approve() / reject() / update() / delete()` | `Review / void` | The moderation lifecycle. |
| `respond(Review, Model $author, string $content, ?string $title)` | `Review` | Creates an owner response. |
| `vote(Review, Model $voter, bool $helpful) / removeVote(Review, Model $voter)` | `ReviewVote / bool` | Helpful votes (removeVote() is false when there was no vote). |
| `verify(Review) / unverify(Review)` | `Review` | Sets or clears the verified flag; fires ReviewVerified. |
| `fake()` | `ReviewsFake` | Swaps in the recording fake — see Testing. |

## One subject: Reviews::for()

for($subject) returns a ReviewableScope with the subject fixed at construction — nothing it returns reaches another subject’s rows. Its aggregates count approved, top-level reviews only; its query() returns the subject’s top-level reviews in every status. Reviews::query() is the wider, swap-aware query over every review on the configured model.

## Model helpers use the same manager

$product->addReview(), the HasReviews aggregates, $review->respond(), $review->markVerified() / markUnverified() and the CanVoteOnReviews helpers all delegate to the same manager. A container override therefore applies everywhere, and Reviews::fake() sees every call.

## Show your open-source love

This package is free and MIT-licensed. If it saves you time, a one-off donation or a Patreon membership keeps it maintained, tested and documented.

[More ways to support, including crypto](https://roundly-consulting.com/support-us.md)

By donating, you agree to our [donation terms](https://roundly-consulting.com/donation-terms.md).

[Support our open source work (opens in a new tab)](https://donate.stripe.com/dRmeVe8FX5PF1Qd9pXcEw00) [Join us on Patreon (opens in a new tab)](https://www.patreon.com/cw/roundly)

## Want this built into your product?

We integrate our packages into custom Laravel and AI builds. Tell us what you're working on and we'll reply within 48 hours.

[Get a quote in 48 hours](https://roundly-consulting.com/contact.md) [Browse all packages](https://roundly-consulting.com/open-source/docs/reviews-for-laravel.md)