Articles on: Campaigns

Spintax and Auto-Spintax

Spintax and Auto-Spintax


Purpose


Spintax lets you create message variations so each recipient gets a unique version of your email or message. Instead of sending the same text to everyone, you define alternatives in a simple format — SuperSend randomly picks one option per send. This improves deliverability by reducing repetitive content that spam filters may flag. This article explains the spintax format, where to find the Auto-Spintax button, how to use it for email steps, and how to write spintax manually for LinkedIn and Twitter messages.


Prerequisites


  • A campaign with at least one sequence step (email, LinkedIn, or Twitter).
  • For Auto-Spintax: an email step with subject and/or body content already written.



What Is Spintax?


Spintax uses curly braces and pipe characters to define alternatives. At send time, SuperSend randomly selects one option from each spintax block. Each recipient sees a different combination, so your messages feel more natural and less templated.


Format: {option1|option2|option3}


  • Use single curly braces { and }.
  • Separate options with the pipe character |.
  • Each block must have at least two options (and thus at least one pipe).


Example:


{Hi|Hey|Hello} {{first_name}},

{Just checking in|Wanted to follow up|Circling back} to see if you had a chance to look at the {proposal|overview|deck} I sent over last week.

{Let me know|Feel free to reply|Would love your thoughts}!

{Best|Cheers|Thanks},
{{senderName}}


For one contact, the result might be: "Hey Sarah, Wanted to follow up to see if you had a chance to look at the deck I sent over last week. Feel free to reply! Cheers, John"

For another: "Hello Sarah, Just checking in to see if you had a chance to look at the proposal I sent over last week. Let me know! Best, John"



How Spintax Works With Variables and Conditionals


SuperSend processes content in this order:


  1. Liquid variables (e.g. {{first_name}}, {{company_name}}) are replaced with contact data.
  2. Liquid conditionals (e.g. {% if first_name %}...{% endif %}) are evaluated.
  3. Spintax randomly selects one option from each {option1|option2} block.


Variables work inside spintax. For example:


{Hi {{first_name}}|Hey {{first_name}}|Hello {{first_name}}}


Variables are resolved first, then spintax picks an option. So if the contact's first name is "Sarah", one of "Hi Sarah", "Hey Sarah", or "Hello Sarah" is chosen.


You can also combine conditionals and spintax:


{% if first_name %}{Hi {{first_name}}|Hey {{first_name}}}{% else %}{Hi there|Hey there}{% endif %}


Conditionals run first, then spintax.


Important: Spintax does not support nesting. Use only single-level blocks like {a|b|c}. Nested structures like {a|{b|c}} are not supported.



Where to Find Auto-Spintax (Email Steps Only)


Auto-Spintax uses AI to convert your plain text into spintax format. It is available for email steps only — not for LinkedIn or Twitter steps.


Simple Sequence


  1. Open your campaign → Sequence tab.
  2. Click an email step in the left panel.
  3. In the email editor toolbar (above the subject and body fields), look for the Auto-Spintax button — it has a refresh/cycle icon and sits between AI Rewrite and Variables.
  4. Click Auto-Spintax.


Complex Sequence


  1. Open your campaign → Sequence tab.
  2. Click an email node on the canvas to select it.
  3. The node action sidebar appears on the right (or left, depending on layout).
  4. Find the Auto-Spintax button — it has a refresh/cycle icon, near AI Rewrite and Attach Files.
  5. Click Auto-Spintax.


The button is disabled if the step has no subject or body content. Write your email first, then use Auto-Spintax.



Using Auto-Spintax


  1. Click Auto-Spintax (see above for where to find it).
  2. A panel slides in from the right. Choose what to add spintax to:
  • Subject Line — add variations to your email subject.
  • Email Body — add variations to your email body.
  1. Click your choice. SuperSend generates spintax using AI (this takes a few seconds).
  2. Review the preview. Spintax blocks are highlighted so you can see the variations.
  3. Click Apply Spintax to replace your content with the spintax version, or Cancel to discard.
  4. Save your sequence.


You can run Auto-Spintax again to regenerate different variations, or edit the spintax manually after applying.



Writing Spintax Manually (Including LinkedIn and Twitter)


Auto-Spintax is only available for email steps. For LinkedIn and Twitter messages, you must type spintax yourself. The same format applies: {option1|option2|option3}.


LinkedIn connection messages: Max 300 characters. If you use spintax or variables, the final resolved message must be under 300 characters or it will be trimmed.


LinkedIn DMs and InMail: Same spintax format. Ensure the final message stays within LinkedIn’s limits.


Twitter DMs: Same spintax format. Respect Twitter’s character limits.


Message Variables Modal (Spintax Tab)


To see spintax examples and copy-paste snippets:


  1. In the sequence editor, click Message Variables (or Variables in some flows).
  2. Open the Spintax tab.
  3. Use the examples to learn the format and copy snippets into your message.


This modal is available for email, LinkedIn, and Twitter steps where the Variables button is shown.



Expected Result


  • Email: Each recipient receives a version of your email with one randomly chosen option from each spintax block. Subject and body can both use spintax.
  • LinkedIn/Twitter: Each recipient receives a version of your message with one randomly chosen option from each spintax block. You write spintax manually; Auto-Spintax is not available for these step types.



Troubleshooting


  • Issue: Spintax shows literally in the sent message (e.g. {Hi|Hello} appears as-is).

Fix: Check that the format is correct: single braces {}, at least two options, and pipes | between them. Nested spintax is not supported.


  • Issue: Variable inside spintax doesn’t resolve (e.g. {{first_name}} appears literally).

Fix: Variables use double braces {{}}. Ensure the variable name matches a contact field (e.g. {{first_name}}, not {{firstName}} unless that field exists). Variables are resolved before spintax runs.


  • Issue: Auto-Spintax button is disabled.

Fix: Add subject and/or body content to the email step first. The button requires content to generate variations.


  • Issue: LinkedIn connection message is trimmed or rejected.

Fix: LinkedIn limits connection messages to 300 characters. With spintax, the longest possible resolved version must stay under 300 characters. Shorten options or reduce the number of variations.


  • Issue: Pipe character | inside a variable breaks spintax.

Fix: Pipes inside {{...}} (e.g. Liquid filters like {{name | capitalize}}) are handled correctly. Pipes outside variable blocks split options — avoid raw pipes in option text unless you intend to split there.





Updated on: 19/03/2026

Was this article helpful?

Share your feedback

Cancel

Thank you!