Spintax: why every recipient should get a slightly different message

When you send the same text to 50 people in a row, messaging platforms notice. Spintax is a simple technique that makes each message look unique without writing 50 different texts.

The problem with copy-paste broadcasts

Imagine you run a small online shop and want to tell 200 customers about a weekend sale. You write one message, load the contact list, and hit send. Simple — but every single outgoing message is byte-for-byte identical.

Messaging platforms are looking for exactly that pattern. When a personal account sends the same text to dozens of people in a short window, it looks like spam. The account gets flagged, throttled, or banned. The content of the message barely matters at that point.

What spintax looks like

The syntax is simple: curly braces wrap a set of alternatives, separated by a pipe character. When the message is sent, one alternative is chosen at random for each recipient.

{Hello|Hi|Hey} {{name}}, the weekend sale starts Friday at 6 pm. {Grab 15% off|Save 15%|Use code WEEKEND15} {on everything|on your next order|sitewide}.

From this single template, recipient A might get "Hello Anna, the weekend sale starts Friday at 6 pm. Grab 15% off on everything." Recipient B gets "Hey Marcus, the weekend sale starts Friday at 6 pm. Save 15% sitewide." Same information, different surface.

Where to add variation and where not to

Not every word needs a synonym. Over-spinning makes the message sound unnatural and hard to proofread. Here is a practical breakdown:

Part of the messageWorth spinning?Notes
Opening greetingYesEasy, low risk of awkward phrasing
Offer headlineYesTwo or three variants is enough
Key facts (price, date, link)NoNever randomise the facts you need people to act on
Closing call to actionSometimesSpin the phrasing, not the actual link or number
Brand name or legal disclaimerNoThese must be consistent

Using variables alongside spintax

chat-valet lets you upload a contact list with extra columns — name, city, order number, or anything else. Those columns become variables you insert with double curly braces.

{Hi|Hello} {{first_name}}, your booking at {{location}} is confirmed for {{date}}. {See you there|Looking forward to it|We'll be ready for you}.

The personalisation makes the message feel direct; the spintax keeps the delivery pattern varied. Both work together from the same template.

The WhatsApp Business API comparison

The official WhatsApp Business API (Meta) has its own template system. Approved templates must be submitted and reviewed before sending; you can add variables but you cannot randomise text freely. Spintax is not part of the API spec.

The API gives you more sending headroom — a properly warmed business account can reach thousands of contacts per day. The trade-off is cost: Meta charges per conversation (roughly $0.05–0.08 per 24-hour thread in most markets), plus the platform fee. For small-volume, relationship-driven outreach, a personal account with spintax can be more practical. For high-volume transactional messages, the API is the right tool. See our full comparison.

Nested spintax: when it makes sense

You can put a spintax block inside another one:

{Good {morning|afternoon|evening}|Hey|Hi there}, hope your {week|day} is going well.

This multiplies the number of unique combinations without writing each one out. Three outer variants, one of which has three inner sub-variants, gives five distinct openings from a single block. Useful when you need high variation across a large list.

Keep it to two levels of nesting at most. Deeper than that and you will struggle to spot phrasing errors when something sounds off.

How chat-valet handles spintax

When you write your broadcast message in chat-valet, you type spintax directly into the message field. Before the broadcast queue runs, the system validates that all blocks are properly closed. If a brace is missing, the broadcast is held and you see an error.

During sending, the variant is chosen fresh for each recipient — not once per batch. So a list of 100 contacts does not end up with 25 people getting the same variant. See how broadcasts work for the full picture on limits and scheduling.

Honest limits of spintax

Spintax is a useful tool, not a magic shield. Platforms look at more than just message uniqueness:

Our recommendation: keep sends under 20–30 per day per number, focus on contacts who actually know you, and treat spintax as one layer of a reasonable approach — not as a workaround for sending at scale.

Try spintax in a real broadcast — free for 30 days, no card required.

Start free trial

Frequently asked questions

What is spintax?

Spintax is a notation where you list word or phrase variants inside curly braces, separated by a pipe: {Hello|Hi|Hey}. The sender picks one variant randomly for each recipient, so the outgoing messages differ even though they come from the same template.

Does spintax actually reduce the chance of a block?

It helps, but it is not a silver bullet. Platforms use many signals — send volume, complaint rates, account age, recipient behaviour. Spintax removes one obvious red flag (identical mass messages), but a high send volume is still risky regardless of how varied the text is.

Can I nest spintax blocks?

Yes. {Good {morning|afternoon}|Hey} will produce "Good morning", "Good afternoon", or "Hey". chat-valet supports nested blocks, but keep it readable — overly nested templates are hard to proofread.

How do I combine spintax with personalisation variables?

You can mix both in the same template: {Hello|Hi} {{name}}, your order {{order_id}} is ready. The variable is filled first from your contact list, then the spintax variant is chosen at random.

What happens if a spintax block is malformed?

If the parser cannot read the block, chat-valet will show a validation error before sending — the broadcast will not go out with broken syntax.

Is spintax available on all messengers in chat-valet?

Yes — WhatsApp, Telegram, and MAX broadcasts all support spintax. Formatting support (bold, italic) depends on the messenger, not on spintax itself.