# What ticket ratings are

<i class="fa-crown">:crown:</i> **Premium.** Ticket Rating gives the member who opened a ticket a way to rate the support they received, on a 1 to 5 star scale, with an optional or required text comment depending on the mode you choose.

The rating prompt is sent to the ticket author in a direct message after the ticket closes.

<figure><img src="/files/4JSLusGaMRrZY4UOU043" alt="A Discord DM from Ticket King to a ticket author showing the 5-star rating prompt with the star buttons"><figcaption></figcaption></figure>

## How it works

1. A ticket closes.
2. If the server has Premium and Ticket Rating is on, the bot sends the ticket author a separate direct message with a row of 5 star buttons and an "Ignore" button. This is sent even if the close notice DM is turned off.
3. The author clicks 1 to 5 stars.
4. Depending on your rating mode, a comment box may also open.
5. The rating is posted to the Ticket Rating Log Channel, if one is set.
6. The rating is saved to the dashboard, where it appears in Statistics and Ticket History.

A ticket can be rated once. The rating buttons stay usable for 7 days after the message is sent. After that, they stop working.

## What you configure

Settings, in the **Ticket Rating Settings** group. The whole group is Premium.

| Field                         | Options / default                                                              |
| ----------------------------- | ------------------------------------------------------------------------------ |
| **Ticket Rating**             | Off by default. Turn it on to enable ratings.                                  |
| **Ticket Rating Mode**        | Rating Only, Rating + Optional Comment (default), or Rating + Required Comment |
| **Ticket Rating Log Channel** | The channel where ratings are posted. None by default.                         |

[Rating modes](/docs/ticket-rating/rating-modes.md)

## What is fixed and cannot be changed

* **The number of stars** is always 1 through 5.
* **The 7-day rating window** is fixed.
* **The prompt is always sent by direct message.** It is sent separately from the close notice.
* **Ticket Rating is a server-wide setting.** It is not set per panel.

## Where ratings end up

* In the Ticket Rating Log Channel, if one is set.
* On the dashboard Statistics page, where ratings are averaged over the time range you pick.
* On each closed ticket in Ticket History.

## Related

{% content-ref url="/pages/ikkD9dDSGwACJv6pOMuF" %}
[Rating modes](/docs/ticket-rating/rating-modes.md)
{% endcontent-ref %}

{% content-ref url="/pages/zDWTQGI2Rn7FnVTqrbwI" %}
[The rating log channel](/docs/ticket-rating/rating-log-channel.md)
{% endcontent-ref %}

{% content-ref url="/pages/NE7s8u7ClZcuXRHiALUB" %}
[Where to read ratings](/docs/ticket-rating/where-to-read-ratings.md)
{% endcontent-ref %}


---

# 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://ticketking.xyz/docs/ticket-rating/what-ticket-ratings-are.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.
