> For the complete documentation index, see [llms.txt](https://chatlyst.gitbook.io/chatlyst-user-guide/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://chatlyst.gitbook.io/chatlyst-user-guide/dashboard/usage.md).

# Usage

This section explains what is shown in the Usage tab and how to review KC Bot and AI Response usage.

### Review Credits

The Usage page shows both credit types in one panel.

<div data-with-frame="true"><img src="https://1646628841-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FBW7n4ClAhZvbgvusylCd%2Fuploads%2F0Fuv4S2VwjK47gTtWAAa%2Fattachment%3Af17d7e82%20e9b1%2043ad%208fd3%204f2e2ffd1949%3A4a0717a8%20062d%2042a2%20bab1%20d048180ae074.png?alt=media&amp;token=465c9bfb-ed06-4095-9dcb-a57e46a7b616" alt=""></div>

{% hint style="info" %}
Top up — Select the wallet icon to open the [top-up flow](/chatlyst-user-guide/top-up-guideline/top-up-guideline.md).

<img src="https://1646628841-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FBW7n4ClAhZvbgvusylCd%2Fuploads%2FqvNEo0GGzFmZi42SdMWD%2Fimage.png?alt=media&amp;token=8027008d-f72a-441c-920a-b8f62b063998" alt="" data-size="original">
{% endhint %}

***

### Review Overview and Trends

{% hint style="info" %}
All data and metrics displayed in this section update automatically based on the specific date range selected.
{% endhint %}

{% stepper %}
{% step %}

#### Choose a Date Range

Use the Date Range tool to control the specific time period shown across all charts and totals on the dashboard.

1. Locate the Date Range selector in the top-right corner of the screen.

<div data-with-frame="true"><figure><img src="https://1646628841-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FBW7n4ClAhZvbgvusylCd%2Fuploads%2FzKWwLMYRRXud81U3hvuY%2Fimage.png?alt=media&amp;token=63eaada7-29bc-4696-9237-508e4d0992c0" alt="" width="563"><figcaption></figcaption></figure></div>

2. Select the desired dates. The dashboard will immediately update to display the relevant data.

<div data-with-frame="true"><figure><img src="https://1646628841-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FBW7n4ClAhZvbgvusylCd%2Fuploads%2FICVwDTACiUeUFXinZQ2A%2Fimage.png?alt=media&amp;token=8e0da684-84b0-410a-82e7-929a8e6e9fe1" alt="" width="375"><figcaption></figcaption></figure></div>

<div data-with-frame="true"><figure><img src="https://1646628841-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FBW7n4ClAhZvbgvusylCd%2Fuploads%2FrXZOW6kYI4AunJHRFR6X%2Fimage.png?alt=media&amp;token=630e8d3a-7f0a-476b-ac26-3f66c19ee7a6" alt=""><figcaption></figcaption></figure></div>
{% endstep %}

{% step %}

#### Switch between Overview and Trends

Use the navigation tab in the middle of the page to switch between [Overview](#overview) and [Trends](#trends).

{% hint style="info" %}
Navigation Tab — Switch between Overview and Trend.

<img src="https://1646628841-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FBW7n4ClAhZvbgvusylCd%2Fuploads%2FhDBs7YVNF53L8p8FspZE%2Fimage.png?alt=media&amp;token=e8afc088-4f22-45e2-9207-ab80da66167f" alt="" data-size="original">
{% endhint %}

<div data-with-frame="true"><img src="https://1646628841-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FBW7n4ClAhZvbgvusylCd%2Fuploads%2Fg2TJlnpuZcMadul8JjQi%2Fattachment%3A9c40e66d%20ab74%204fc9%209c91%208a9c2534224a%3AScreenshot_2026%2004%2027_at_2.20.12_PM.png?alt=media&amp;token=b3390c8b-fcbc-498a-add0-4c8dbabbc41e" alt=""></div>
{% endstep %}

{% step %}

#### **Overview**

In Overview, key information updates based on the selected date range.

<div data-with-frame="true"><figure><img src="https://1646628841-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FBW7n4ClAhZvbgvusylCd%2Fuploads%2FLRZpAkbsepwmrlp58rxT%2Fimage.png?alt=media&amp;token=91a40c56-16f0-46d4-b740-7db90f826a84" alt=""><figcaption></figcaption></figure></div>

1. Period Summary shows key activity for the selected date range.

<div data-with-frame="true"><img src="https://1646628841-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FBW7n4ClAhZvbgvusylCd%2Fuploads%2F9tgHNNX1ly71DhcrMRpL%2Fattachment%3Aa62e2adc%20db02%2045f6%20a11e%20bdac64711474%3Aimage.png?alt=media&amp;token=f187f9e1-7d2e-459a-b332-7f41461374fc" alt=""></div>

2. Top Users shows the most active users during the selected period.

<div data-with-frame="true"><img src="https://1646628841-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FBW7n4ClAhZvbgvusylCd%2Fuploads%2F1DZtnl9fzOTISPusC6Rw%2Fattachment%3Ab08eadba%20eab9%204221%20a8c8%2009480c7d86fd%3Aimage.png?alt=media&amp;token=3c9e5fab-a39f-4089-b709-99223019e42b" alt=""></div>

3. Top Documents shows the most queried knowledge documents and a feedback breakdown.

<div data-with-frame="true"><img src="https://1646628841-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FBW7n4ClAhZvbgvusylCd%2Fuploads%2FCNS80AYoOE2kFQEmjJGM%2Fattachment%3Ad8cf5657%205e90%204dd8%208fd9%203b73f6b65ba5%3Aimage.png?alt=media&amp;token=4efd253f-4280-4d18-b048-74d7c37bfd40" alt=""></div>
{% endstep %}

{% step %}

#### **Trends**

In Trends, compare metrics such as AI Responses Used, KC Bot Used, Messages, and Cost.

The comparison depends on the selected date range.

* If the date range is **Apr 17 to Apr 18**, Chatlyst compares it to **Apr 15 to Apr 16**.

<div data-with-frame="true"><img src="https://1646628841-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FBW7n4ClAhZvbgvusylCd%2Fuploads%2F8HlZ9yuhVSKEmLQSUzA4%2Fattachment%3Af9cafcfa%206d6a%204a06%20ac23%206f11376cdcaf%3Aimage.png?alt=media&amp;token=67fac5a5-1e50-4226-8212-481643b8803a" alt=""></div>

* If the date range is **Apr 14 to Apr 20** (Last 7 days), Chatlyst compares it to **Apr 7 to Apr 13**.

<div data-with-frame="true"><img src="https://1646628841-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FBW7n4ClAhZvbgvusylCd%2Fuploads%2FkyvDKOeehryALRut8lTi%2Fattachment%3A4dd8fdf9%2092fa%204733%20ae69%2073e5184fc692%3Aimage.png?alt=media&amp;token=9449b840-49b1-49d8-b022-c7592beca79d" alt=""></div>
{% endstep %}
{% endstepper %}

***

### Export the Usage Log

1. Select **Export Usage Log** in the top-right corner.
2. If there is no data in the selected date range, Chatlyst does not generate a file.

<div data-with-frame="true"><img src="https://1646628841-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FBW7n4ClAhZvbgvusylCd%2Fuploads%2FPQqDrDilruWFWdOmZEIh%2Fattachment%3Aebd35569%20d11e%20471f%20916f%20f2688b9475eb%3Aimage.png?alt=media&amp;token=2e691902-a5c6-42c8-ba38-c08c4301e31b" alt=""></div>

The exported CSV includes the following columns:

* Date
* AI Response Used
* KC Bot Used
* Messages
* Cost (Currency)

An example template is shown below:

| Date       | AI Response Used | KC Bot Used | Messages | Cost (HKD) |
| ---------- | ---------------- | ----------- | -------- | ---------- |
| 2026-04-16 | 10               | 1           | 12       | 3.64       |
| 2026-04-17 | 7                | 1           | 7        | 3.21       |
| 2026-04-20 | 5                | 3           | 5        | 7.32       |

#### Troubleshooting Chinese Display Issues <a href="#csv-troubleshooting-chinese-display-issues" id="csv-troubleshooting-chinese-display-issues"></a>

If your CSV file cannot display Chinese characters, follow the steps below based on your software.

* Google Sheets — No issues expected. Simply import the file and Chinese characters will display normally.
* Pages — No issues expected. Simply open the file and Chinese characters will display normally.
* Excel  — Chinese characters may not display correctly by default. Use one of these methods: [Import via File Tab](#method-1-import-via-file-tab) or [Import via Data Tab](#method-2-import-via-data-tab)

#### Method 1: Import via File Tab

{% stepper %}
{% step %}
Open a New Blank Workbook.
{% endstep %}

{% step %}
Go to **File** and select **Import**.

<div data-with-frame="true"><figure><img src="https://1646628841-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FBW7n4ClAhZvbgvusylCd%2Fuploads%2FKPJDhNky8p8A0vwQALlF%2Fimage.png?alt=media&amp;token=79dca3c3-56ec-4fc8-aac1-dd63f53f4369" alt=""><figcaption></figcaption></figure></div>

<div data-with-frame="true"><figure><img src="https://1646628841-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FBW7n4ClAhZvbgvusylCd%2Fuploads%2FzEhSA8UathPB30bwhShs%2Fimage.png?alt=media&amp;token=1fcdb54b-a861-4ab9-8b97-1bdbfd030451" alt=""><figcaption></figcaption></figure></div>
{% endstep %}

{% step %}
Select CSV file and click **Import**, then locate the CSV and select **Get Data** to proceed.

<div data-with-frame="true"><figure><img src="https://1646628841-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FBW7n4ClAhZvbgvusylCd%2Fuploads%2FiM6UcTiXXJqsHEmgUq3I%2Fimage.png?alt=media&amp;token=4ef55f40-a604-433e-9fa0-89108c06adb8" alt="" width="375"><figcaption></figcaption></figure></div>
{% endstep %}

{% step %}
When the Text Import Wizard appears:

1. Set **File Origin** to: **Unicode (UTF-8)**, then select **Next**.&#x20;

<div data-with-frame="true"><figure><img src="https://1646628841-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FBW7n4ClAhZvbgvusylCd%2Fuploads%2FZJiHi1MEskXAoKEndJk6%2Fimage.png?alt=media&amp;token=c0fc9f72-21c0-47ec-bdee-c87ca51bbe84" alt="" width="375"><figcaption></figcaption></figure></div>

2. Tick **Comma** as the Delimiters, select **Finish**.&#x20;

<div data-with-frame="true"><figure><img src="https://1646628841-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FBW7n4ClAhZvbgvusylCd%2Fuploads%2FSkNiS4rpO1YZN882IVaJ%2Fimage.png?alt=media&amp;token=854d1f38-4ad3-41a4-8bf6-e9a23d02fd80" alt="" width="375"><figcaption></figcaption></figure></div>
{% endstep %}
{% endstepper %}

#### **Method 2: Import via Data Tab**

{% stepper %}
{% step %}
Open a New Blank Workbook.
{% endstep %}

{% step %}
Go to **Data** then **Get Data (Power Query)**, select **From Text (Legacy)**

<div data-with-frame="true"><figure><img src="https://1646628841-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FBW7n4ClAhZvbgvusylCd%2Fuploads%2FQhc9plow2ZhYROsuiUdR%2Fimage.png?alt=media&amp;token=23798b8d-5c4c-489e-b79b-eecbd69bbdbc" alt=""><figcaption></figcaption></figure></div>

<div data-with-frame="true"><figure><img src="https://1646628841-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FBW7n4ClAhZvbgvusylCd%2Fuploads%2F1EX182uCqI7ta2pNrGoG%2Fimage.png?alt=media&amp;token=55d4308f-c817-43ba-9fb9-d48647b96dfc" alt=""><figcaption></figcaption></figure></div>
{% endstep %}

{% step %}
Locate the CSV and select **Get Data** to proceed.
{% endstep %}

{% step %}
When the Text Import Wizard appears:

1. Set **File Origin** to: **Unicode (UTF-8)**, then select **Next**.&#x20;

<div data-with-frame="true"><figure><img src="https://1646628841-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FBW7n4ClAhZvbgvusylCd%2Fuploads%2FZJiHi1MEskXAoKEndJk6%2Fimage.png?alt=media&amp;token=c0fc9f72-21c0-47ec-bdee-c87ca51bbe84" alt="" width="375"><figcaption></figcaption></figure></div>

2. Tick **Comma** as the Delimiters, select **Finish**.&#x20;

<div data-with-frame="true"><figure><img src="https://1646628841-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FBW7n4ClAhZvbgvusylCd%2Fuploads%2FSkNiS4rpO1YZN882IVaJ%2Fimage.png?alt=media&amp;token=854d1f38-4ad3-41a4-8bf6-e9a23d02fd80" alt="" width="375"><figcaption></figcaption></figure></div>
{% endstep %}
{% endstepper %}