> For the complete documentation index, see [llms.txt](https://cogna8-io.gitbook.io/docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://cogna8-io.gitbook.io/docs/troubleshooting/voice-issues.md).

# Voice Issues

Voice issues usually fall into two categories: speech-to-text input problems and text-to-speech output problems.

***

## Speech-to-Text Checks

{% tabs %}
{% tab title="Microphone Access" %}
Confirm browser microphone permission is enabled for the site.
{% endtab %}

{% tab title="Device Selection" %}
Make sure the intended microphone is active at the system and browser level.
{% endtab %}

{% tab title="Input Quality" %}
Background noise, distance from microphone, and speaking pace can reduce transcription quality.
{% endtab %}

{% tab title="Language" %}
Check that the configured language matches the spoken language.
{% endtab %}
{% endtabs %}

## Text-to-Speech Checks

Confirm system volume and correct audio output device. Verify voice playback is enabled in General settings. Some browsers restrict autoplay until user interaction.

{% hint style="warning" %}
**If voice transcription quality is poor, downstream state may be inaccurate.** Inspect the captured text and use State and Why to verify what the system actually formed.
{% endhint %}