> For the complete documentation index, see [llms.txt](https://docs.itranslator.app/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.itranslator.app/amazing-features/statistics.md).

# Statistics

Follow your translation activity, and export it.

Statistics show how much your server translates: per day, week or month, for the whole server or for a single channel. They are useful to follow your usage on every plan.

<figure><img src="https://3955709218-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FuW8Vjy8RHWcWMwcAWdcy%2Fuploads%2Fgit-blob-89e76e582b2b7fdffdab3efcb699c08b063b4010%2Fstats.gif?alt=media" alt="The /stats command and its chart in Discord"><figcaption><p>Statistics in Discord</p></figcaption></figure>

## Where to find them

{% tabs %}
{% tab title="Dashboard" %}
Open your server in the [dashboard](https://docs.itranslator.app/fundamentals/dashboard.md). The **Overview** page shows the characters used, the lifetime totals and the **Translation activity** chart, with its total, peak and average.

<figure><img src="https://3955709218-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FuW8Vjy8RHWcWMwcAWdcy%2Fuploads%2Fgit-blob-b6549e59fd465f1dc1fb691b037ca651d23de9ec%2Fdashboard-overview.png?alt=media" alt="The Overview page of the dashboard with the translation activity chart"><figcaption></figcaption></figure>

Three filters sit above the chart: **Data Type**, **Time Period** and **Channels/Categories**.
{% endtab %}

{% tab title="Command" %}
Run `/stats generate`. iTranslator answers with a chart and buttons to change the period or export the data.

| Argument   | Description                                                   | Optional |
| ---------- | ------------------------------------------------------------- | -------- |
| `type`     | The [data type](#data-type) to display.                       | No       |
| `specific` | A channel or a category. Leave it empty for the whole server. | Yes      |

`/stats help` displays a summary of the feature. Both commands require the **Manage Server** permission.
{% endtab %}
{% endtabs %}

## Data type <a href="#data-type" id="data-type"></a>

Two types of data can be analyzed:

* `TRANSLATED_MESSAGES`: the number of messages processed by iTranslator.
* `TRANSLATED_CHARACTERS`: the number of characters billed by iTranslator.

In the dashboard they are the **Messages** and **Characters** buttons.

{% hint style="info" %}
Would another data type be useful to you? Tell us on our [Discord Server](https://discord.itranslator.app/).
{% endhint %}

## Period

By default the statistics cover the last day. The period can be extended to the last week, month, quarter or year.

* In the dashboard, use the **Time Period** menu.
* In Discord, use the **History Type** button under the chart. The period you choose is also applied to the CSV export.

<figure><img src="https://3955709218-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FuW8Vjy8RHWcWMwcAWdcy%2Fuploads%2Fgit-blob-91a4ee97f17d20b839116f8d98e2cd284b505ab6%2Fimage%20(5).png?alt=media" alt="The History Type button under the statistics chart"><figcaption><p>The History Type button</p></figcaption></figure>

{% hint style="info" %}
Changing the period requires [**Premium**](https://docs.itranslator.app/overview/premium.md). Free servers see the last 24 hours.
{% endhint %}

## Whole server, category or channel

Statistics can be limited to what you are looking for: **the whole server**, a **category** or a single **channel**.

* In the dashboard, use the **Channels/Categories** menu ([Premium](https://docs.itranslator.app/overview/premium.md)).
* In Discord, fill in the `specific` argument of `/stats generate`. Leave it empty for the whole server.

## Export data to a CSV file

{% hint style="info" %}
The CSV export requires [**Premium**](https://docs.itranslator.app/overview/premium.md).
{% endhint %}

To analyze the data your own way, run `/stats generate`, adjust the settings with the buttons, then click **Export to CSV**. The file is generated with your current settings.

<figure><img src="https://3955709218-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FuW8Vjy8RHWcWMwcAWdcy%2Fuploads%2Fgit-blob-6e79bf4c56a7083b18ce15fe789136c747820030%2Fimage%20(6).png?alt=media" alt="The Export to CSV button under the statistics chart"><figcaption><p>The Export to CSV button</p></figcaption></figure>

The file has two columns:

| timestamp                  | value                                |
| -------------------------- | ------------------------------------ |
| The date of the data point | The number of messages or characters |
