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

# Keywords

> Keywords improve transcription accuracy for specific terms that are important to your script. This is particularly useful for brand names, industry jargon, or uncommon words that the transcription service might otherwise mishear.

## What are Keywords?

Keywords are a list of terms you provide to help the transcription service recognise specific words accurately. When the user speaks these terms, the transcription is more likely to capture them correctly.

Common use cases:

* **Brand names** — "Voxworks", "iPhone", company names
* **Product names** — Model numbers, product lines
* **Industry terms** — Technical jargon, acronyms
* **Names** — Common names that might be transcribed incorrectly

***

## How Keywords Work

When you add keywords to your script:

1. The transcription service is primed to recognise these terms
2. When audio matches a keyword, it's more likely to be transcribed correctly
3. The assistant receives the accurate transcription and can respond appropriately

Keywords don't change how the assistant responds — they improve what the assistant "hears" from the user.

***

## Automatic Keywords

Voxworks automatically includes certain keywords for each call without any configuration:

* **Contact name** — The caller's first and last name
* **Contact company** — The caller's business or organisation
* **Your business name** — Your team's business name

These automatic keywords mean common names and business terms are already optimised for transcription. You only need to add additional keywords for specialised terms not covered by your script content.

***

## Adding Custom Keywords

Add keywords in the Script settings. Enter each term that should be recognised accurately during calls.

### Examples

**A law firm might add:**

```text theme={null}
power
attorney
affidavit
litigation
deposition
```

**A tech company might add:**

```text theme={null}
Voxworks
API
OAuth
webhook
```

**A healthcare provider might add:**

```text theme={null}
paracetamol
Ibuprofen
referral
GP
```

***

## Best Practices

1. **Use single words where possible** — Better performance is achieved with single words. For example, add "Power" and "Attorney" as separate keywords rather than "Power of Attorney"
2. **Two words maximum** — Keywords should be two words or less for best results
3. **Avoid common words** — Don't include words like "the", "and", "is", or other everyday terms
4. **Keep the list focused** — Aim for 20 keywords or fewer. A targeted list is more effective than an exhaustive one
5. **Match your desired capitalisation** — Keywords are transcribed as entered, so ensure capitalisation matches how you want terms to appear
6. **Focus on problem words** — Only add terms that are commonly misheard or important to get right
7. **Test and refine** — Review call recordings and transcripts to identify words that need adding

***

## Limitations

Keywords improve transcription but cannot guarantee perfect accuracy. Factors like audio quality, background noise, and speaker clarity still affect results.

For guidance on handling of accents and soft speech, see [Assistant Behaviour](/conversation-dynamics/assistant-behaviour).

***

## Related Topics

* [Assistant Behaviour](/conversation-dynamics/assistant-behaviour) — Understanding transcription limitations
* [Silence Tolerance](/conversation-dynamics/silence-tolerance) — Configure pause handling