Custom Cast Filters
cast_highlight
Highlights specific text in a Cast narration box.
Input:
This {{ "text" | cast_highlight }} is highlighted.
Output:
This text is highlighted.
- Inside narrations, select the text you would like to highlight and press the highlight button.
- The cast_highlight filter will be applied. You can see the change reflected in the preview below.
cast_footnote
Adds a footnote at the cursor position.
Input:
This text has a footnote {{ "This is the footnote" | cast_highlight }} at the bottom of the page.
Output:
This text has a footnoteÂą at the bottom of the page.
1 This is the footnote
- Inside narrations, move the cursor to where you want the footnote to be inserted.
- Add the text you want to display in the footnote. You can see the change reflected in the preview below.
cast_pronounce
Make the narrator say words the way you want.
What it does:
- Fixes tricky names, acronyms, and numbers so they sound right in audio.
How to set it up:
- In Cast, go to Projects > Project Workflow > Pronunciations and add the word and how it should be spoken.
Use it in your narration:
Contact your {{ "CSM" | cast_pronounce }}.
Our {{ "AI" | cast_pronounce }} system helps with {{ "ROI" | cast_pronounce }}.
Examples:
- Text shows: Contact your CSM. → Audio says: Contact your Customer Success Manager.
- Text shows: Our AI system helps with ROI. → Audio says: Our artificial intelligence system helps with return on investment.
Real-life scenarios:
Hi {{ first_name }}, let's review your {{ "Q3" | cast_pronounce }} {{ "NPS" | cast_pronounce }} scores and discuss the {{ "API" | cast_pronounce }} integration timeline.
Your {{ "MRR" | cast_pronounce }} has grown by {{ growth_percentage }}% since our last {{ "QBR" | cast_pronounce }}.
We've identified {{ risk_count }} accounts with {{ "SLA" | cast_pronounce }} concerns that need immediate attention from your {{ "CSM" | cast_pronounce }}.
Tip: You can also add a pronunciation right in the narration editor. Highlight the word, click Pronounce, type how it should be said, and save. If the word already has a saved pronunciation, it will be used automatically.
Easy options for clearer speech
Use these add‑ons when you want numbers and codes spoken clearly.
Version (“version”)
- Reads version numbers with dots as “point”.
{{ "1.2.3.4" | cast_pronounce: "version" }} → 1 point 2 point 3 point 4
{{ "1.2.3" | cast_pronounce: "version" }} → 1 point 2 point 3
Number pairs (“number_pair”)
- Breaks long numbers into easy‑to‑hear pairs.
{{ "380" | cast_pronounce: "number_pair" }} → 3 80
{{ "346780" | cast_pronounce: "number_pair" }} → 34 67 80
By character (“by_char”)
- Spells out letters and numbers one by one.
{{ "CSM123" | cast_pronounce: "by_char" }} → C S M 1 2 3
{{ "ROI 2024" | cast_pronounce: "by_char" }} → R O I 2 0 2 4
Apply all your pronunciations to a whole sentence
Instead of adding cast_pronounce
to each word separately, you can tell Cast to scan an entire sentence and automatically apply all the pronunciations you’ve saved.
- Use “all” to scan the entire text.
- Choose how to match words:
- “strict” (default): match whole words only. Example: finds “QBR”, but not inside “QBRTEMPLATE”.
- “loose” or “partial”: also match parts of words. Example: finds “QBR” inside “QBRTEMPLATE”.
- Existing
<sub>
tags are left alone so the HTML stays clean.
{{ text | cast_pronounce: "all" }}
{{ text | cast_pronounce: "all", "loose" }}
{{ text | cast_pronounce: "all", "partial" }}
Examples
{%- assign message = "Your CSM will review the QBR with key stakeholders to discuss ROI improvements" -%}
{{ message | cast_pronounce: "all" }}
Difference between “strict”, “loose”, and “partial” modes:
{%- assign text = "Schedule a QBR meeting and send the QBRTEMPLATE to stakeholders" -%}
{{ text | cast_pronounce: "all" }} → Schedule a quarterly business review meeting and send the QBRTEMPLATE to stakeholders
{{ text | cast_pronounce: "all", "loose" }} → Schedule a quarterly business review meeting and send the quarterly business review TEMPLATE to stakeholders
{{ text | cast_pronounce: "all", "partial" }} → Schedule a quarterly business review meeting and send the quarterly business review TEMPLATE to stakeholders
- “strict” (default): Only matches whole words. “QBR” in “QBRTEMPLATE” is ignored.
-
“loose” or “partial”: Also matches parts of words. “QBR” in “QBRTEMPLATE” gets pronounced.
- With a list like
{ "CSM": "customer success manager", "QBR": "quarterly business review", "ROI": "return on investment", "CRM": "customer relationship management" }
, words such asCSM
,QBR
, andROI
will be spoken the way you set. Overlaps are handled smartly (for example, longer matches take priority).
More examples:
{{ "SLA" | cast_pronounce }} → service level agreement
{{ "NPS" | cast_pronounce }} → net promoter score
{{ "ARR" | cast_pronounce }} → annual recurring revenue
{{ "987654" | cast_pronounce: "number_pair" }} → 98 76 54
{{ "2.1.5" | cast_pronounce: "version" }} → 2 point 1 point 5
Notes
- If you do not choose a match mode, “strict” is used.
- Matching respects upper/lower case.
- If nothing matches, your text stays the same.
cast_apostrophe
Inserts an apostrophe based on the string that is passed in.
This is useful when using a name variable that can change.
Enter in narration box:
Let's take a look at {{ "Mike" | cast_apostrophe }} progress.
Output:
Let's take a look at Mike's progress.
In the example below, the variable first_name can change quite frequently. Here are a few instances where cast_apostrophe will update based on the value for first_name.