Skip to main content
An audio tag is an English word or phrase in square brackets in text. It changes how the voice speaks, or adds a sound such as a laugh. Public and instant voices perform audio tags on all three models: heygen-voice-1, heygen-voice-1-turbo, and heygen-voice-1-turbo-free. Both speech endpoints accept them. Professional voices do not perform audio tags. Each tag is in one of four categories: emotion, delivery, acoustic event, or scenario. The common tags table shows what each category does.

Add tags automatically

To add tags to a script you already have, give this prompt to an LLM, with your script in place of <your text>. It uses only the common tags.
Prompt

Listen

Every sample below is the exact text shown under its player. Unless a section names a different voice, one instant voice with the same settings speaks every sample.

Same line, different tags

One script, first with no tags and then with a different lead tag. The words stay almost the same, and the tags change the delivery.

No tags

[calm]

[excited]

[nervous]

[warm]

[whispers]

One category at a time

Emotion, delivery, acoustic event, and scenario tags, each in its own script.

Emotion: nervous, relieved, excited

Delivery: whisper, loud, fast

Delivery: pause and hesitation

Acoustic events: laugh, sigh, gasp

Acoustic events: gasp and laugh

Scenario: news anchor to sports commentator

Scenario: sharing a secret

Example scripts

These scripts mix categories, with one tag at each position.

Telling a story to a friend

Customer support

Ad read

Tutorial

Bedtime story

Accent preservation

A cloned voice keeps its accent when you add tags. The voice below was cloned from a speaker with an Indian English accent. The first player is a neutral reading with [matter-of-fact]. The other players are tagged lines spoken by the same voice.

[matter-of-fact]

[shy]

[talking to a small child]

[surprised]

Emotion intensity

To make an emotion weaker or stronger, put slightly or extremely in front of the emotion tag, such as [slightly sad] or [extremely angry]. This works with the emotion tags in the Feelings and Tone lists of All supported tags. Each group below is one line spoken by one voice, first with no tag and then at three levels of the same emotion. The two tabs are two voices with the same lines.
Sad

No tag

[slightly sad]

[sad]

[extremely sad]

Happy

No tag

[slightly happy]

[happy]

[extremely happy]

Angry

No tag

[slightly angry]

[angry]

[extremely angry]

How tags work

  • An emotion, delivery, or scenario tag changes the speech after it. It has an effect for up to approximately 17 seconds of speech, approximately 233 characters of English. To keep the effect for a longer time, write the tag again in a later sentence.
  • An acoustic event tag, such as [laughs] or [sighs], adds one sound at its position.
  • These delivery tags are exceptions. Each one acts one time at its position, as an acoustic event does: [pause], [hesitates], [after a long pause], [voice cracking], [trailing off], and [catching themselves mid-sentence].
  • When text contains a tag other than [pause], expressiveness_boost is not applied. The request is not rejected.

Writing tags

  • Write each tag in lowercase, exactly as it is in the list below, with no closing tag. [deadpan, dry humor] is one tag. [sad, quietly] is not a tag.
  • To make an emotion weaker or stronger, write slightly or extremely and one space in front of an emotion tag from the Feelings or Tone list in All supported tags, such as [slightly sad] or [extremely happy]. Other words, such as [very sad], and other tags, such as [slightly whispers], are not tags.
  • Put one tag at a position. Do not put two tags side by side, such as [angry] [whispers].
  • Write tags in English, also when text is in a different language.
  • Bracketed text that is not a tag, such as [Section 4], is usually not spoken. To have those words spoken, remove the square brackets.
  • Tags count toward the 10,000-character limit of text.
  • Markdown is not interpreted. **word** does not add emphasis, so remove Markdown from text before you send it.

Common tags

Emotion
  • Attitude: [barely containing excitement], [deadpan, dry humor], [defensive, a little hurt], [genuinely impressed], [mock serious], [nostalgic and wistful], [passive aggressive], [quietly furious], [reluctantly admitting], [skeptical, raising an eyebrow], [trying to sound casual], [with a shrug in their voice], [with forced politeness]
  • Feelings: [amused], [angry], [annoyed], [anxious], [awestruck], [bored], [confident], [confused], [curious], [determined], [disgusted], [embarrassed], [excited], [exhausted], [frustrated], [grateful], [guilty], [happy], [heartbroken], [hopeful], [jealous], [lonely], [melancholic], [nervous], [panicked], [proud], [relieved], [sad], [scared], [shy], [sleepy], [surprised], [tender], [worried]
  • Intensity: slightly or extremely in front of any Feelings or Tone tag, such as [slightly sad] or [extremely angry]
  • Mid-line change: [rising panic], [suddenly serious]
  • Situation: [in disbelief], [on the verge of tears], [rolling their eyes], [with a knowing smile], [with a lump in their throat]
  • Tone: [apologetic], [authoritative], [calm], [cheerful], [cold], [dismissive], [dreamy], [encouraging], [enthusiastic], [firm], [flirtatious], [gentle], [matter-of-fact], [mischievous], [playful], [reassuring], [sarcastic], [serious], [sincere], [smug], [solemn], [stern], [suspicious], [thoughtful], [warm]
Delivery
  • Articulation: [drawls], [enunciating clearly], [mumbles], [mutters], [sings], [slurring], [stammers]
  • Attitude: [as an afterthought], [over-the-top dramatic]
  • Mid-line change: [barely audible], [building to a shout], [catching themselves mid-sentence], [laughing while speaking], [lowering their voice], [singing it softly], [softer than before], [trailing off], [voice cracking], [voice dropping to a whisper], [whispering urgently]
  • Pace & pauses: [hesitates], [pause], [quickly], [rushed], [slowly]
  • Pitch & voice quality: [booming], [breathless], [breathy], [deep voice], [high voice], [hoarse], [low voice], [monotone], [nasal], [raspy], [sing-song], [squeaky voice], [trembling voice]
  • Situation: [after a long pause], [speaking through a smile], [through gritted teeth], [trying not to laugh]
  • Volume & force: [bellows], [calls out], [loudly], [murmurs], [quietly], [screams], [shouts], [shrieks], [softly], [under their breath], [whispers], [yells]
Acoustic event
  • Body sounds: [clears throat awkwardly], [clears throat], [coughs], [gulps], [hiccups], [sneezes], [sniffs], [snores], [snorts], [yawns]
  • Breath: [exhales], [gasps], [huffs], [inhales], [long tired sigh], [pants], [sharp intake of breath], [sighs], [wheezes]
  • Crying: [muffled sob], [sniffles], [sobs], [whimpers]
  • Laughter: [belly laugh], [cackles], [chortles], [chuckles], [giggles], [guffaws], [laughs], [nervous laugh], [short disbelieving laugh], [snickers]
  • Non-voice events (experimental): [applause], [claps], [knocks], [snaps fingers]
  • Vocal reactions: [exasperated groan], [groans], [grunts], [hmm], [hums], [scoffs], [shushes], [small happy hum], [tsks], [whistles]
Scenario
  • Attitude: [as if sharing a secret], [quoting someone mockingly]
  • Audience / role: [addressing a crowd], [comforting a friend], [explaining to a confused customer], [like a drill sergeant], [like a game show host], [like a late-night radio host], [like a museum tour guide], [like a news anchor], [like a sports commentator], [like reading a bedtime story], [talking to a small child], [teasing a close friend]
  • Situation: [from across the room], [half asleep], [into a phone, distracted], [leaning in conspiratorially], [walking fast, slightly out of breath], [while catching their breath], [with a mouth full of food]

Choosing a voice

For an instant voice, clone from clear speech recorded in a quiet room without echo. See Instant Voice Clone. The same tag can sound different from voice to voice. Try a tag with a few voices before you choose one.

Tips

  • A request without seed uses a random one, so sending the same request again gives a new take. Send the same seed to try to repeat a take; repeats are best effort. To steer a different performance, change the wording or punctuation near the tag and send the request again.
  • You can mix tags from different categories in one text.
  • Choose tags that fit the words.
  • Put an acoustic event where the sound happens, such as [laughs] after the funny line.
  • To change the mood inside a sentence, use a mid-line change tag, such as [rising panic], [suddenly serious], or [voice dropping to a whisper].