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:

  1. 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 as CSM, QBR, and ROI 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.

first_name: James

first_name: Liz