> For the complete documentation index, see [llms.txt](https://help.voiceout.app/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.voiceout.app/premium/pronunciation-rules.md).

# Pronunciation Rules

Tell Voice Out how to say acronyms, names, and technical words.

Text-to-speech voices sometimes say words incorrectly. A voice can spell an acronym letter by letter, or say a name incorrectly. A pronunciation rule tells Voice Out to replace a text with a different text before the voice reads it.

{% hint style="info" %}
You must have Voice Out Premium to add, import, or sync pronunciation rules. Refer to [Upgrade To Premium](https://help.voiceout.app/premium/upgrade-to-premium.md).
{% endhint %}

## Examples

| Text   | Pronunciation             | Result                                  |
| ------ | ------------------------- | --------------------------------------- |
| SQL    | sequel                    | The voice says "sequel", not "S Q L".   |
| i.e.   | that is                   | The voice says "that is", not "eye ee". |
| e.g.   | for example               | The voice says "for example".           |
| gif    | jif                       | The voice says "jif".                   |
| w3c    | World Wide Web Consortium | The voice says the full name.           |
| Nguyen | win                       | The voice says the name as "win".       |

## Open the pronunciation rules

1. Right-click the Voice Out button to the right of the address bar.
2. Click **Options**.
3. In the left sidebar, click **Pronunciation Rules**.

## Add a rule

1. In the **Custom Rules** area, click **Add Rule**.
2. In **Text**, type the text that Voice Out says incorrectly. Example: `w3c`.
3. In **Pronunciation**, type the text that Voice Out must say. Example: `World Wide Web Consortium`.
4. Click **Add Rule**.

If a rule for the same text exists, the new rule replaces it.

{% hint style="info" %}
For the **Pronunciation**, write the word as it sounds. Example: to make Voice Out say "Nguyen" as "win", type `win`. Try different spellings until the voice says the word correctly.
{% endhint %}

## Test a rule

1. In the **Test Pronunciation** area, type a sentence that contains your text.
2. Click **Test Pronunciation**.
3. Listen to the voice. If the word is not correct, edit the rule.

You can also open a webpage that contains the word, and listen to it with Voice Out.

## Edit or delete a rule

* To edit a rule, click the edit icon in the **Actions** column. Change the text, then click **Update Rule**.
* To delete a rule, click the delete icon in the **Actions** column.
* To delete many rules, select the checkboxes next to the rules. Then click **Delete**.

## Add many rules at the same time

1. Click **Bulk Add**.
2. Type one rule on each line, in the format `text,pronunciation`.\
   Example:

   ```
   SQL,sequel
   i.e.,that is
   w3c,World Wide Web Consortium
   ```
3. Click **Add Rules**.

Voice Out shows the number of rules that it added and the number of lines with errors.

{% hint style="warning" %}
Do not use commas in the text or in the pronunciation. Voice Out uses the comma to separate the two parts. A line with more than one comma causes an error, and Voice Out does not add that rule.
{% endhint %}

## Export your rules

1. Click **Export**.
2. Copy the text in the dialog box.

The export uses the same `text,pronunciation` format as **Bulk Add**. To copy your rules to a different account, paste the text into **Bulk Add** in that account.

## Use your rules on a different computer

Voice Out keeps your rules in your browser. When you add, edit, or delete a rule, Voice Out also saves the change to your account.

Voice Out does not copy rules to a new computer automatically. To get your rules on a different computer or browser profile, do these steps:

1. Install Voice Out and activate Premium on the new computer. Refer to [How to activate Voice Out Premium on a new computer/profile?](https://help.voiceout.app/help/account-and-billing/how-to-activate-voice-out-premium-on-a-new-computer-profile.md)
2. Open the **Pronunciation Rules** section on the Settings page.
3. Click **Sync**.

Voice Out downloads your rules from your account and adds them to the rules in your browser.

{% hint style="warning" %}
Log in to Voice Out before you add rules. If you are not logged in, Voice Out cannot save the rules to your account, and **Sync** cannot find them.
{% endhint %}

## How Voice Out applies the rules

* Rules are not case-sensitive. A rule for `sql` also changes `SQL` and `Sql`.
* Rules change only full words. A rule for `cat` does not change `category`.
* If two rules match the same text, Voice Out uses the rule with the longer text first.
* Rules operate with all voices: premium voices, browser voices, and custom voices.
* Rules operate on webpages, Google Docs, and PDFs that you read with the Voice Out extension.
* The [Reader](https://help.voiceout.app/premium/voice-out-premium-guide.md#reader) web app does not use pronunciation rules at this time.
* Rules do not use wildcards or regular expressions.

{% hint style="info" %}
Premium credits count the characters that the voice reads. A rule that makes text longer also uses more credits. Example: the rule `w3c` → `World Wide Web Consortium` uses 25 credits each time, not 3.
{% endhint %}

## If your Premium subscription ends

Voice Out keeps your rules, but it does not apply them. Voice Out reads the original text. You cannot add, import, or sync rules.

When you upgrade again, Voice Out applies your rules again. You do not have to add them again.

## Related articles

* [Voice Out Premium Guide](https://help.voiceout.app/premium/voice-out-premium-guide.md)
* [Upgrade To Premium](https://help.voiceout.app/premium/upgrade-to-premium.md)
