Article overview
Make a voice say something different from what's written on the page.
A replacement tells Studio to speak a piece of text differently than it's written — without changing your script. Use it for numbers, IDs, brand names, and anything else that reads one way and should sound another.
Before you get started
- The Pronunciation Library only supports Latin characters. Arabic, Chinese, Japanese, Korean, Persian, and Turkish characters aren't supported.
- Saved replacements go to your Pronunciation Library. You have a personal library; teams also share a Team Library.
- A replacement can optionally include a phonetic respelling for precise pronunciation control — see Using Respellings.
When to use a replacement
Use a replacement whenever the written text shouldn't be read literally:
-
Names and branding —
6ix9inewould otherwise read as "six ix nine ine"; a replacement makes it "six nine." -
Reference numbers —
101would otherwise read as "one hundred and one" instead of "one oh one." -
URLs —
http://www.ourproduct.comwould otherwise read out every character; a replacement shortens it to "our product dot com." -
Shorthand —
e.g.would otherwise read as "E G" instead of "for example."
Adding a replacement
From the Smart Toolbar:
- Highlight the word in the editor to open the Smart Toolbar.
- Click on + New Replacement.
- In the Replacements panel, confirm the Original text field (filled in automatically).
- Enter the spoken text in the Replacement field.
- For pronunciation control instead of a text swap, turn on Phonetic Respelling and enter a phonetic spelling — see Using Respellings.
- Preview the pronunciation.
- Click on Save to Library.
From the Pronunciation Library:
- Open the Replacements panel in the right sidebar.
- Click on + New Replacement.
- Enter the Original text.
- Enter the Replacement text.
- For pronunciation control instead of a text swap, turn on Phonetic Respelling and enter a phonetic spelling instead.
- Preview the pronunciation.
- Click on Save to Library.
Once saved, the replacement applies automatically everywhere that text appears — in this project and any other project you work in.
Switching, editing, and deleting replacements
Text with a replacement applied appears bolded in the editor.
To switch or disable a replacement:
- Highlight the word to open the Smart Toolbar.
- Open the dropdown to see other saved replacements for that text.
- Select a different replacement, or choose to disable replacements for that word.
To delete a replacement:
- Highlight the word and open the Smart Toolbar dropdown.
- Select the replacement you want to remove.
- Click the trash icon and confirm.
To edit a replacement:
- Open Libraries in the left navigation.
- Select the replacement entry you want to update.
- Edit the original text or replacement value.
- Save your changes.
FAQs
Q: What's the difference between a replacement and a respelling?
A: A replacement changes what text is spoken. A respelling — created with the Phonetic Respelling toggle inside a replacement — controls how a word is pronounced. See Using Respellings for the full syntax.
Q: Do I need a separate replacement for every project?
A: No. Save it once to your Pronunciation Library, and it applies consistently across all your projects.
Q: My project is in a non-Latin script, and replacements won't save. Why?
A: The Pronunciation Library only supports Latin characters. Replacements aren't currently supported in Arabic, Chinese, Japanese, Korean, Persian, or Turkish projects.