> For the complete documentation index, see [llms.txt](https://docs.premsoft.de/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.premsoft.de/en/plugins/blog/reviews.md).

# Reviews

{% hint style="info" %}
Reviews are a **premium feature**. They are not available in the administration or storefront in the Basic or Advanced plan.
{% endhint %}

## Why reviews matter

Reviews make your articles more credible and add authentic customer-generated content. Every approved review appears:

* In the review list on the article detail page
* In the aggregated star widget above the article
* In search engine snippets with star ratings in Google results
* In the administration lists for moderation

## How it works in the storefront

1. The visitor opens an article and sees the average star rating
2. Below it they see a **Write a review** prompt
3. Clicking it opens the form and scrolls it into view
4. Fields: name, email, stars, title and review text
5. After submission the review is stored with the status `pending approval`
6. The form can also be closed again with **Cancel**

## How moderation works in the administration

In the **Reviews** tab of the blog dashboard you see each review with:

* The reviewer's name and email
* The review title and star rating
* An active toggle for approval
* The linked article

Use the **Active** toggle to approve a review. After saving it becomes visible in the storefront immediately — no cache clear required.

Without the premium plan the tab shows an upgrade note instead of the list.

## What visitors submit

| Field       | Meaning                                                     |
| ----------- | ----------------------------------------------------------- |
| Name        | Shown under the review.                                     |
| Email       | Internal only — never shown publicly.                       |
| Title       | Review headline, at least 5 characters.                     |
| Review text | Main review content, at least 40 characters.                |
| Stars       | Value from 1 to 5.                                          |
| Active      | Starts as not approved — you approve it later in the admin. |

## Enable reviews

1. Open **Extensions → My extensions → Blog → Configuration**
2. Turn on **Enable reviews**

This setting applies per sales channel. While it is off — or while you do not have the premium plan — neither the review widget nor the review form appears in the storefront.

## Availability by plan

| Feature                       | Basic | Advanced | Premium |
| ----------------------------- | :---: | :------: | :-----: |
| Write reviews                 |   –   |     –    |    ✓    |
| Review list on article pages  |   –   |     –    |    ✓    |
| Aggregated star rating        |   –   |     –    |    ✓    |
| Admin moderation              |   –   |     –    |    ✓    |
| Star markup in Google results |   –   |     –    |    ✓    |

Upgrade details are in [Advanced and premium version](/en/plugins/blog/advanced-and-premium-version.md).


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.premsoft.de/en/plugins/blog/reviews.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.