All topics
Get started8Account, team & permissions44Units & fields70Records, views & tasks39WhatsApp & Cortex Chat68Email & social27Lead ads & distribution38Automations52Documents & quotes32Dashboards40Cortex AI18Developers & API12
Help Center·448 guidesAll topicsContact support

Fill a template from client data with variables

Write the field’s name between double braces, such as {{first_name}}, and it’s filled from the client record linked to the chat. You can also read from a linked record, such as {{project.name}}.

5 min
Before you start · for owners and managers
The Create or Edit permission in message templates
  • You need: The Create or Edit permission in message templates

Steps

1
In the template, choose the Unit first (for WhatsApp Cloud, the Session, which brings its linked unit), and its fields show in the variable picker.
2
Type {{ or choose the field from the picker, and it’s added, such as {{first_name}}.
3
To read from a linked record, type the relation’s name, then a dot, then the field, such as {{project.name}}.
4
Save.
Corteksa checks that every direct variable matches an active field in the unit.

Allowed fields

Field type
What reaches the client
Text, long text, email, URL, phone, WhatsApp number, session name, serial number
The value as it is
Number, rating, currency, date, date and time
The value, formatted as a number, an amount or a date
Select, multi-select, status, tag, priority, source, ad campaign, ad set, ad
The option’s name. Multiple options are separated by commas
Yes/No
Yes or No

Fields that aren’t allowed: relation, lookup, rollup, calculation, location, smart catalog, file and image. They have no single line of text to print. For a relation, use a field from the linked record, such as {{project.name}}.

Empty values

General template: a variable with no value is removed from the text, so {{name}} never reaches the client. You see the list of empty variables, so you can decide whether to send.

WhatsApp Cloud template: an empty variable blocks sending, because Meta doesn’t accept an empty value. Fill in the field first.

A chat that isn’t linked to a record, or is linked to a deleted record, is treated as having no values.

The sent text is saved with the message as it went out, so the chat history doesn’t change if the record changes later.

If something goes wrong

What you see
Why
What to do
“{{report}} is the ‘Report’ field, a file field, and can’t be inserted in a message as text”
That field type isn’t allowed.
Remove the variable and choose a text, select, number, date or contact field.
Sending failed because of an empty variable on WhatsApp Cloud
The field is empty in the client’s record.
Fill it in, or fill it in and then send from Send a template from the chat, with a preview of the values.
Variables show as they are in the preview
The chat isn’t linked to a record.

A real example

Shield Security Co.
The situation

The visit reminder template needs the client’s name, the visit date, and the site name from the linked “Sites” record.

What they did
  1. They wrote: “Hello {{first_name}}, our next visit to the {{site.name}} site is on {{visit_date}}.”
The result

Every client now gets the reminder with the right details for their site.

A made-up company, to show the idea. The numbers are rounded.

Good to know

A direct variable must match an active field in the chosen unit.
Variables from linked records aren’t checked when you save. They’re resolved when you send.
The unit can’t change after a WhatsApp Cloud template is created.
Did this guide solve it?
If not, we’ll ask what was missing.
Open in Corteksa
Did this guide solve it?

We read every answer. To get a reply, use Contact support.