Customize the TTS dictionary

You can use the TTS dictionary feature to specify how the text-to-speech feature should pronounce common acronyms or shorthand expressions when they are included in voice notifications. For example, you could configure the TTS dictionary to pronounce "BTW" as "by the way" rather than speaking the individual letters.

If an existing recording matches a phrase after TTS dictionary substitution, the recording will be played.

TTS Dictionary page

You can also use the dictionary to control content filtering, such as replacing expletives or inappropriate words with a 'beep' or alternate expression. If your xMatters company has more than one language configured, you can specify substitutions for those languages as well.

The TTS dictionary is not supported for script-based xMatters integrations. In this case, you can use voice files to provide pronunciations for acronyms and other shorthand expressions.

Example Dictionary Entries
Word Substitution
4:00 zero four hundred
A300 Airbus three hundred
s'pore Singapore
e.g. for example
etc. etcetera


FYI for your information
NW north west
aug. August
tues. Tuesday
SFO San Francisco International Airport
xMatters ex matters
<rude or curse word> beep

TTS words are restricted to alphanumeric characters and the following punctuation: periods (.), hyphens (-), ampersands (&), apostrophes ('), and colons (:).

To add a dictionary entry:
  1. If you are not already on the TTS dictionary page, click the Developer tab and then click TTS Dictionary in menu on the left side of the screen.
  2. If your company has more than one language configured, click the desired language tab.
  3. In the fields below the dictionary list, type the word or phrase in the left field, and its substitution in the right field.
  4. Click Add Entry to add the entry to the dictionary.

To work with existing entries, do any of the following:
  • To remove an entry, select its check box, and then click Delete Entries (this button is displayed only when you have selected one or more entries).
  • To reorder entries, click and drag an entry to a new position in the list.
  • To search for entries, start typing in the search field.
    • All rows with matching characters or words are highlighted.
    • You can use the up and down arrow buttons to move through all of the results that include the search term (these buttons are displayed only when there are matching results).

xMatters On-Demand does not currently support the use of third-party TTS engines.