Skip to main content

Personalise SMS with placeholders

Updated over 3 weeks ago

What are placeholders?

Placeholders (also known as merge tags) are a simple way to add a personal touch to your SMS messages. They allow you to automatically insert dynamic content—like customer names, order numbers, or invoice details—directly into each message.


How to setup placeholders

We’ll show you how to use placeholders with an example.

Let’s say you want to send a reminder to clients to pay their outstanding invoices. You’d like to include their name, the invoice number, and the amount owing in each message.

  1. Prepare your contact list in a spreadsheet, with the following columns:

    1. First name

    2. Last name

    3. Contact number

    4. Invoice number

    5. Invoice amount

  2. Upload your contacts to ClickSend.

  3. Import your spreadsheet as a CSV file in the ClickSend Dashboard.

  4. During the upload, you’ll be prompted to map each column in your file with ClickSend’s placeholders.

Your spreadsheet might look like this:

First name

Last name

Contact number

Custom string 1
(Invoice number)

Custom string 2
(Invoice amount)

Jack

Smith

1234567890`

A123441

$698

Make sure you map First Name, Last Name, and Contact Number to the correct placeholders. For Invoice Number and Invoice Amount, use Custom String 1 and Custom String 2.


How to add placeholders to SMS

It’s simple to add placeholders where you’re using Quick SMS, SMS Campaign or Messenger.

  1. Compose your message.

  2. Add the placeholders using brackets. For example:

  3. Hi (First Name), invoice number (Cust. 1) is now due. Please pay the amount of (Cust. 2) as soon as possible. Thank you.

  4. If your placeholders are set up correctly, you’ll see something like this in the preview:

    Hi Jack, invoice number A123441 is now due. Please pay the amount of $698.

Do not manually enter data into placeholders. The placeholder relies on your contact list fields, and manually entering details will prevent dynamic insertion.

Did this answer your question?