> For the complete documentation index, see [llms.txt](https://docs.watzap.id/help/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.watzap.id/help/email-broadcast/penjelasan-variable-di-email-broadcast.md).

# Penjelasan Variable di Email Broadcast

**Variable** adalah penanda yang otomatis diganti dengan data masing-masing penerima saat email dikirim. Dengan variable, setiap penerima merasa mendapat email yang ditulis khusus untuknya.

Variable bisa dipakai di **Subject** dan di **isi email**.

### Daftar Variable

| Variable  | Diisi dengan                |
| --------- | --------------------------- |
| `{name}`  | Nama kontak                 |
| `{email}` | Alamat email penerima       |
| `{var1}`  | Kolom tambahan ke-1 di List |
| `{var2}`  | Kolom tambahan ke-2 di List |
| …         | …                           |
| `{var8}`  | Kolom tambahan ke-8 di List |

Penulisan variable memakai **kurung kurawal tunggal**, misalnya `{name}`. Huruf besar/kecil tidak berpengaruh, jadi `{Name}` sama dengan `{name}`.

### Contoh Penggunaan

**Subject:**

```
{name}, voucher ulang tahunmu sudah siap 🎉
```

**Isi email:**

```
Halo {name},

Terima kasih sudah menjadi pelanggan setia kami di {var1}.
Khusus untuk kamu, ada potongan 20% untuk pembelian {var2} berikutnya.
```

Jika kontak Budi punya kolom tambahan Kota = Bandung dan Produk Favorit = Kopi Arabika, email yang diterima Budi menjadi:

```
Halo Budi,

Terima kasih sudah menjadi pelanggan setia kami di Bandung.
Khusus untuk kamu, ada potongan 20% untuk pembelian Kopi Arabika berikutnya.
```

### Cara Menyisipkan Variable

**Cara 1: Tombol `{ }`**

Letakkan kursor di posisi yang diinginkan, lalu klik tombol **{ }** (Insert variable) di toolbar editor. Pilih variable dari daftar yang muncul.

<figure><img src="https://4182233851-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F5hxDGBLGZN4N69IP4zHp%2Fuploads%2ForfhZae6wRuAfYKrmJYS%2Femail-variable-menu.png?alt=media" alt="Menu Insert variable"><figcaption><p>Daftar variable setelah tombol { } diklik. Nama kolom list tampil di kiri, kode variable-nya di kanan</p></figcaption></figure>

**Cara 2: Ketik @**

Ketik **@** di awal kata, lalu ketik nama variable atau kolom. Daftar saran akan muncul. Pilih dengan klik atau tombol Enter. Jika tidak ada yang cocok, muncul *"No variable matches what you typed."*

Di daftar variable, `{var1}`–`{var8}` diberi label sesuai **nama kolom** dan **nama list** yang kamu pilih di langkah 1. Contoh pada gambar: *Kota · Tes Banyak Kolom* → `{var3}`. Jadi kamu tidak perlu menghafal nomor kolomnya.

### Hal Penting yang Perlu Diperhatikan

**1. Data kosong menjadi teks kosong**

Jika data kontak kosong, variable akan diganti dengan **teks kosong**. Belum ada fitur nilai cadangan (fallback). Contoh:

| Ditulis        | Nama kontak | Hasil      |
| -------------- | ----------- | ---------- |
| `Halo {name}!` | Budi        | Halo Budi! |
| `Halo {name}!` | *(kosong)*  | Halo !     |

{% hint style="success" %}
**Tips:** sebelum mengirim, pastikan semua kontak di list sudah punya nama. Jika tidak memungkinkan, gunakan sapaan yang tidak bergantung pada nama, misalnya `Halo, Sobat Kopi!`.
{% endhint %}

**2. Variable yang tidak dikenal terkirim apa adanya**

Hanya `{name}`, `{email}`, dan `{var1}`–`{var8}` yang dikenali. Jika kamu menulis `{kota}` atau `{nama}`, penerima akan melihat tulisan `{kota}` atau `{nama}` persis seperti itu.

Di langkah 3 (Review & Send), variable yang tidak dikenal akan ditandai di baris **Unknown variables** dengan keterangan *"recipients see it exactly as typed"*. Variable seperti ini juga diberi warna sorot di preview.

**3. Nomor `{varN}` mengikuti urutan kolom di masing-masing list**

Jika kamu memilih beberapa list dengan susunan kolom berbeda, `{var2}` di List A bisa berisi "Kota", sedangkan `{var2}` di List B berisi "Produk".

Cek baris **List columns** di langkah 3 untuk melihat pemetaannya, misalnya `{var2} → Kota`. Jika susunannya berbeda, samakan dulu kolom di list-list tersebut, atau kirim broadcast terpisah per list.

**4. Variable di email percobaan**

Di email percobaan (Send a Test), variable diisi dengan data contoh. Lihat [Cara Kirim Email Percobaan](https://docs.watzap.id/help/email-broadcast/cara-kirim-email-percobaan.md).
