> ## Documentation Index
> Fetch the complete documentation index at: https://docs.chatsyncs.com/llms.txt
> Use this file to discover all available pages before exploring further.

# 2. Broadcasting with Personalized Variable Data in ChatSyncs

> How to send a personalized WhatsApp broadcast where every subscriber sees their own name, company, or city, using Custom Fields inserted as #fieldname# variables.

Personalized broadcasts replace generic text with each subscriber's own data — name, company,
city, or any [Custom Field](/learn/chatsyncs-subscriber-manager/manage-custom-fields-and-labels-with-chatsyncs#custom-fields)
you've defined — instead of sending the exact same message to everyone. Instead of "Hi there,
check out our offer," the subscriber sees "Hi Sarah, check out our offer for Acme Corp."

For the basic campaign setup this builds on, see
[How to Send a Broadcast Message in ChatSyncs](/learn/chatsyncs-broadcasting/send-a-broadcast-message-in-chatsyncs).

## Build a personalized broadcast

<Steps>
  <Step title="Set up the Custom Fields you need">
    Personalization pulls from **Custom Fields**, not Template Variables — a Custom Field
    stores a different value per subscriber (e.g. `company_name`, `city`), which is exactly
    what personalization needs. [Create a Custom Field](/learn/chatsyncs-subscriber-manager/manage-custom-fields-and-labels-with-chatsyncs#custom-fields)
    if you don't already have the ones you want to personalize with.
  </Step>

  <Step title="Make sure your subscribers' data is filled in">
    Every subscriber you plan to target needs that field populated before you broadcast.
    [See the three ways a Custom Field gets filled in](/learn/chatsyncs-subscriber-manager/manage-custom-fields-and-labels-with-chatsyncs#how-a-custom-field-gets-filled-in) —
    an extra column in a CSV/Google Sheet import, a Keyword Replies **Save to Custom Field**
    action, or an Input Flow / WhatsApp Flow form answer.
  </Step>

  <Step title="Insert the Custom Field into your message template">
    Open the template's **Message Body** and insert the field from the **Custom Fields**
    picker, written as `#fieldname#` — e.g. `#name#`, `#company_name#`, `#city#`. See
    [Custom Fields and Variables inside a template](/learn/chatsyncs-message-templates/creating-a-whatsapp-message-template-in-chatsyncs#custom-fields-and-variables)
    for the full builder walkthrough. Submit the template and wait for Meta's approval before
    using it in a broadcast.
  </Step>

  <Step title="Use the personalized template in your broadcast">
    Create the campaign as described in
    [How to Send a Broadcast Message in ChatSyncs](/learn/chatsyncs-broadcasting/send-a-broadcast-message-in-chatsyncs) — set
    **Broadcast Type** to **Anytime** and pick your personalized template under **Select
    Template**. Filter the audience by label or Custom Field as usual, then save and send.
  </Step>
</Steps>

**Example template body:**

```text theme={null}
Hi #name#, we have an exclusive offer for #company_name# customers in #city#!
```

| Subscriber | `#name#` | `#company_name#` | `#city#` | What they receive                                                         |
| ---------- | -------- | ---------------- | -------- | ------------------------------------------------------------------------- |
| Sarah      | Sarah    | Acme Corp        | Mumbai   | "Hi Sarah, we have an exclusive offer for Acme Corp customers in Mumbai!" |
| James      | James    | Beta Ltd         | London   | "Hi James, we have an exclusive offer for Beta Ltd customers in London!"  |

Each subscriber automatically gets their own saved value — you don't pass field values
manually per broadcast the way you would with a plain Template Variable.

## Why personalize?

|                          | Generic broadcast                    | Personalized broadcast                               |
| ------------------------ | ------------------------------------ | ---------------------------------------------------- |
| **Message**              | "Hi there, check out our new plans!" | "Hi Sarah, check out our new plans for Acme Corp!"   |
| **Open/engagement rate** | Lower — feels like mass spam         | Higher — recipients feel addressed directly          |
| **Blocks and reports**   | More — generic messages read as spam | Fewer — the message feels relevant, not spam         |
| **Targeting**            | One-size-fits-all                    | Tailored by name, company, city, or any Custom Field |

Personalization isn't just a nicer message — it's also a [quality
rating](/learn/chatsyncs-message-templates/understanding-whatsapp-quality-rating-in-chatsyncs) safeguard, since messages that feel relevant get blocked
and reported less often than identical mass text.

## Frequently asked

<AccordionGroup>
  <Accordion title="How do I personalize a broadcast with each subscriber's own name or details?">
    Create a Custom Field for the data you need (e.g. `company_name`), make sure every targeted
    subscriber has it filled in, then insert it into your message template as `#fieldname#`. Each
    subscriber automatically receives their own saved value when the broadcast sends.
  </Accordion>

  <Accordion title="What's the difference between a Custom Field and a Template Variable for personalization?">
    A **Custom Field** stores a different value per subscriber and fills in automatically from
    each subscriber's profile — that's what makes it personalization. A plain **Template
    Variable** needs one value assigned manually per broadcast, so it sends the same value to
    everyone, not a per-subscriber one.
  </Accordion>

  <Accordion title="Do I need an approved template to send a personalized broadcast?">
    Yes — a personalized message body is still a Message Template, so it goes through the same
    Meta approval process as any other template before it can be used in an **Anytime**
    broadcast.
  </Accordion>

  <Accordion title="What happens if some subscribers are missing the custom field I'm personalizing with?">
    That part of the message sends blank for them — e.g. `Hi , we have an exclusive offer...`
    with no name. Check the field is populated for your whole target audience before sending, or
    narrow your audience filter to subscribers who have it set.
  </Accordion>

  <Accordion title="Can I personalize with more than one Custom Field in the same broadcast?">
    Yes — insert as many `#fieldname#` placeholders as the template needs, e.g. `#name#`,
    `#company_name#`, and `#city#` in the same message body, as shown in the example above.
  </Accordion>
</AccordionGroup>

<Warning>
  A Custom Field only has a value if it's actually been populated for that subscriber. Before
  sending a personalized broadcast, confirm the Custom Field is filled in for everyone in your
  target audience — otherwise part of the message will be missing for subscribers who don't have
  that field set.
</Warning>