# About app ratings and reviews

## Overview

Ratings and reviews help users make informed decisions when choosing apps on the Oten Store. They provide social proof and feedback that can significantly impact your app's visibility and adoption.

***

## Rating system

### Star ratings

Users can rate your app from 1 to 5 stars:

| Rating          | Meaning                          |
| --------------- | -------------------------------- |
| ⭐⭐⭐⭐⭐ (5 stars) | Excellent - exceeds expectations |
| ⭐⭐⭐⭐ (4 stars)  | Good - meets expectations        |
| ⭐⭐⭐ (3 stars)   | Average - acceptable             |
| ⭐⭐ (2 stars)    | Poor - below expectations        |
| ⭐ (1 star)      | Very poor - does not work        |

### Average rating

Your app's overall rating is calculated as the average of all user ratings. This is displayed prominently on your app's marketplace page.

**Formula:** `Average Rating = Sum of all ratings / Total number of ratings`

### Subscription count

The number displayed as "downloads" represents the **total number of users who have subscribed** to your app, not traditional downloads.

{% hint style="info" %}
**Subscription count:** This metric includes all active and past subscriptions. It represents the total number of users who have ever subscribed to your app.
{% endhint %}

***

## User reviews

### Review components

Each review includes:

* **Star rating:** 1-5 stars
* **Review title:** brief summary of the review
* **Review content:** detailed feedback from the user
* **Reviewer name:** username of the reviewer
* **Review date:** when the review was submitted
* **Verified badge:** indicates the user has an active subscription

### Who can review

Only users who have **subscribed to your app** can leave a review. This ensures all reviews come from actual users with hands-on experience.

{% hint style="success" %}
**Verified Reviews:** All reviews on the Oten Store are from verified subscribers, ensuring authentic feedback.
{% endhint %}

***

## Review management

{% hint style="warning" %}
**Flagging policy:** Only flag reviews that genuinely violate guidelines. Abuse of the flagging system may result in penalties.
{% endhint %}


---

# Agent Instructions: 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://oten.gitbook.io/identity-support/user-guide/oten-workspace/applications/oten-developer/user-guides/3.-input-application-info/about-app-ratings-and-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.