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

# Web reader conversions, chunks and logs

> See every article readers have played, listen to each reading, edit one chunk to fix a word, read the conversion logs and cost, and clear cached audio.

> [!NOTE]
>
> Web reader is in beta and switched on for selected accounts.

A conversion is one article from your site, with the audio made for each reading readers have played. The **Conversions** tab lists them. From each one you can listen, open its chunks to correct a sentence, read its conversion logs to see what it cost, or clear its cached audio so it is made again.

## The Conversions tab

Articles appear here on their own the first time a reader presses play on them. Until then the tab shows "No conversions yet" with **Go to setup**.

![The Conversions tab with All dialects, English and Egyptian chips, one article processing and one ready to play](https://mintcdn.com/hamsa-452fa79a/SjdNHyLOJ-5kYaqE/images/media/web-reader/conversions-light.webp?fit=max\&auto=format\&n=SjdNHyLOJ-5kYaqE\&q=85\&s=88680cf112454752286e9d1be067c6a4)

When the site has more than one reading, chips at the top (**All dialects** and one per reading) show only the articles read in that reading. Scroll or click **Load more** for older articles.

Each article card shows:

* The title and a link to the article on your site.
* A chip for each reading, with its state. Click a chip to see that reading below.
* **Open article**, **Chunks**, and a menu with **Copy article link** and **Clear cached audio**.
* The reading's state:

| State | What it means |
| - | - |
| **Ready** | Press play to listen in the media player. The voice and length are shown. |
| "Processing audio for …" | The reading is being made right now. |
| "Conversion failed" | It couldn't be made. The reason is shown, for example that the article is too short. Readers see a message in the player. |
| "Not converted to … yet" | No reader has played this reading yet. |

* Plays, completion and the date, and **Conversion logs**.

## Listen piece by piece: article chunks

Every reading is split into chunks of about 100 words, always at the end of a sentence. Click **Chunks** on an article card to open **Article chunks**, where each chunk can be played and checked on its own.

* Choose the reading with the chips at the top.
* Click a chunk to play from there.
* **Open article** opens the page on your site.

If the reading is still being made, the page shows "No chunks yet".

![Article chunks for one article in English: five chunks, with the chunk count, words and length at the top](https://mintcdn.com/hamsa-452fa79a/SjdNHyLOJ-5kYaqE/images/media/web-reader/chunks-light.webp?fit=max\&auto=format\&n=SjdNHyLOJ-5kYaqE\&q=85\&s=061b95789932b0f1fff88dc2cac02e2a)

## Edit a chunk

Use a chunk edit to fix a mispronounced name, a translation you don't like, or text that shouldn't be read aloud. Only that chunk's audio is made again.

**1. Open the chunk**

In **Article chunks**, double-click the chunk, or click its **Edit text** button.

**2. Change the text**

Type the new wording. Write it exactly as it should be spoken: the text is read as you type it, in the reading's language or dialect.

**3. Save**

Press Enter or click **Save**. Press Shift+Enter for a new line, Escape or **Cancel** to stop.

Hamsa speaks the new text, puts that piece back into the full audio, and confirms with "Chunk text updated and audio synced". The next reader hears the corrected version.

![Article chunks with the first chunk open for editing, Cancel and Save under it](https://mintcdn.com/hamsa-452fa79a/SjdNHyLOJ-5kYaqE/images/media/web-reader/chunk-edit-light.webp?fit=max\&auto=format\&n=SjdNHyLOJ-5kYaqE\&q=85\&s=87bde3089fe50d30d4adc8b917737363)

* A chunk can hold up to 5,000 characters.
* An edit is charged as speech for that chunk only. It is never translated, and pronunciation dictionaries aren't applied to it again.
* You can't edit while that reading is being made or another edit on it is running, or while the site is inactive.
* Editing needs the same paid plan and credits as converting.

## Conversion logs

Click **Conversion logs** on an article card to see every time audio was made for that article, and what it cost.

![Conversion logs for one article: five figures, the search and filters, and rows for two full generations and one chunk regeneration](https://mintcdn.com/hamsa-452fa79a/SjdNHyLOJ-5kYaqE/images/media/web-reader/conversion-logs-light.webp?fit=max\&auto=format\&n=SjdNHyLOJ-5kYaqE\&q=85\&s=9228395e653d958edcd89c5575ba30ad)

The figures at the top cover the article's whole history:

| Figure | What it counts |
| - | - |
| **Operations** | How many times audio was made |
| **Total cost** | Credits spent, split into speech and translation |
| **Words processed** | Words spoken, counted after translation |
| **Audio produced** | Length of all audio made |
| **Chunk edits** | How many chunks were edited |

Each row is one action:

| Action | When it happens |
| - | - |
| **Full generation** | The first time a reading of the article is made |
| **Full regeneration** | A reading made again after you cleared the cached audio |
| **Chunk regeneration** | One chunk edit. Words, audio and cost are for that chunk only |

The table shows **Article**, **Voice and language**, **Action**, **Words**, **Credits**, **Duration** and **Time**. Search by title, link or voice, filter by action (**All actions** or one type) and by time (**All time**, **Today**, **Last 7 days**, **Last 30 days**), and click **Reset** to clear the filters.

Click **Open log** on a row to see the chunk text, play or download the audio made, and the cost split into **Speech** and **Translation**. **Export** downloads the rows shown as a JSON file. **Refresh** reloads them.

![An opened log for a chunk regeneration: time, voice, words and duration, the chunk text, the generated audio and the cost](https://mintcdn.com/hamsa-452fa79a/SjdNHyLOJ-5kYaqE/images/media/web-reader/log-detail-light.webp?fit=max\&auto=format\&n=SjdNHyLOJ-5kYaqE\&q=85\&s=1b45b987327f70e712042d2e9386085b)

## Clear cached audio

Hamsa never reads an article again on its own. When you change an article on your site, or change voices or dictionaries, clear its cached audio so the next play uses the new version.

**1. Open the article's menu**

On the **Conversions** tab, open the menu on the article card.

![An article card's menu open: Copy article link and Clear cached audio](https://mintcdn.com/hamsa-452fa79a/SjdNHyLOJ-5kYaqE/images/media/web-reader/conversion-menu-light.webp?fit=max\&auto=format\&n=SjdNHyLOJ-5kYaqE\&q=85\&s=ed0c55ae6289069f9fe43e580d08c413)

**2. Clear it**

Click **Clear cached audio**. "Cached audio cleared" confirms it.

This clears every reading of that article and removes its chunks, including any edits you made. The next reader who presses play gets a fresh conversion, read from the live page and charged again (a **Full regeneration** in the logs). You can't clear an article while it is processing.

## Good to know

* Each reading is made the first time someone plays it, so an article can be ready in one reading and "Not converted to … yet" in another.
* Articles are matched by address without the query string. Two pages that differ only in their query string share one conversion.
* Plays and completion on a card are the article's own. Site totals are on [Analytics](https://docs.tryhamsa.com/media/web-reader/analytics.md).

## Related

> [card] [Web reader](https://docs.tryhamsa.com/media/web-reader/overview.md)
>
> How readings are made and charged.

> [card] [Analytics](https://docs.tryhamsa.com/media/web-reader/analytics.md)
>
> Plays, completion and devices for the whole site.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.