> ## Documentation Index
> Fetch the complete documentation index at: https://docs.flexxible.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Ratings and reactions

> How to tell which pages help their readers and which need work, and how to recognize the people who write the most useful ones.

Flexxible KB offers two ways to gather feedback from people who read the pages. **Ratings** ask whether a page was helpful and point out which ones need improving. **Reactions** let you recognize the pages that help the most and the people who wrote them.

Both features are optional and turned off by default. An owner or administrator turns them on in **Settings**.

## Ratings

### Rate a page

With ratings turned on, every page asks its reader: **Was this page helpful?**

* Select **Helpful** or **Not helpful**.
* If you choose **Not helpful**, you can add a comment about what was missing or what was wrong. The people who write the pages see it in **Ratings**, with your name.
* You can change your rating at any time. If the page changes after you rated it, it lets you know so you can rate it again.

### The Ratings screen

**Ratings**, in the sidebar, shows what readers said and what's worth fixing first.

![Ratings screen: percentage of helpful ratings, chart over time and the list of pages that need attention with readers' comments.](https://mintcdn.com/flexxible/luynIZmFTttZPpU9/images/features/kb-ratings.png?fit=max\&auto=format\&n=luynIZmFTttZPpU9\&q=85\&s=34a28941f16718a42621081629955f69)

| Section | What it shows |
| - | - |
| Summary | The percentage of helpful ratings, the number of ratings in the period and the comparison with the previous period. |
| **Ratings over time** | Helpful and not helpful votes per day or per week. |
| **Pages that need attention** | Pages with negative votes. Votes after the page's last change carry more weight, and recent ones more than older ones. Includes readers' comments. |
| **Negative votes since validation** | [Validated](https://docs.flexxible.com/en/features/flexxible-kb/validation.md) pages that have received a negative vote after being validated. |
| **Most helpful** | The pages that helped readers the most. |

You can filter by **Period** (last 7, 30 or 90 days) and, if you use spaces, by **Spaces**.

> [!TIP]
>
> Each page shows how many negative votes it has received since its last change and how many before. If the negative votes predate the change, the problem has probably already been fixed.

### Turn ratings on or off

In **Settings** → **Ratings**, select **Turn on ratings**. When you turn them off, pages stop asking and **Ratings** disappears from the sidebar, but no rating is deleted.

## Reactions

### Give a reaction

With reactions turned on, each person has a number of reactions to give to the pages that have helped them. Reactions are given from the page itself, in **Reactions**.

* Each person receives an allowance at the start of each day, week or month. Whatever isn't given doesn't carry over.
* The page shows how many you have left and when you'll get more.
* Select a reaction again to take it back.
* You can't give a reaction to a page written only by you.

### The Leaderboard

**Leaderboard**, in the sidebar, shows who wrote the pages that received the most reactions, and which pages those are.

![Leaderboard screen: the people and agents whose pages received the most reactions and the pages with the most reactions.](https://mintcdn.com/flexxible/luynIZmFTttZPpU9/images/features/kb-leaderboard.png?fit=max\&auto=format\&n=luynIZmFTttZPpU9\&q=85\&s=f8233de6c187e14a5f29459b6c29b3d0)

* **Top rated.** The people and agents whose pages received the most reactions.
* **Pages with the most reactions.**

You can filter by period (**This week**, **This month** or **All time**), by type of **Reaction** and by **Spaces**.

### Configure reactions

In **Settings** → **Reactions**, an owner or administrator decides which reactions exist. The first one is created when the feature is turned on.

For each reaction you can define:

* **Name** and icon. The icon can be an emoji or one of your organization's [custom icons](https://docs.flexxible.com/en/features/flexxible-kb/settings.md#iconos).
* **Amount** each person receives and **period**: per day, per week or per month.
* **Unlimited.** An unlimited reaction has no amount: each person can give it to as many pages as they want, once per page.

Also:

* You can reorder reactions and remove the ones you don't use. What was given with a removed reaction still counts in the Leaderboard.
* A change to the amount or period applies right away: each person has the new amount in the current period, minus what they've already given. Nothing already given is taken back.
* Periods start based on UTC time.

When you turn reactions off, nothing is shown, but nothing that was given is lost.

## Next steps

* [Page validation](https://docs.flexxible.com/en/features/flexxible-kb/validation.md)
* [Missing from the KB](https://docs.flexxible.com/en/features/flexxible-kb/gaps.md)
* [Settings](https://docs.flexxible.com/en/features/flexxible-kb/settings.md)
