Working with Variables & Merge Tags

Personalize your email templates with dynamic variables and merge tags.

Variable Syntax

Mailofly uses double curly braces for variables:

<h1>Hello, {{first_name}}!</h1>
<p>Your subscription to {{plan_name}} will renew on {{renewal_date}}.</p>

To prevent empty spaces when a variable is not provided for a specific contact, specify a fallback using the pipe | syntax:

<p>Hey {{first_name | there}},</p>

Mailofly automatically injects the following system merge tags into every send:

Variable	Description
`{{email}}`	The recipient’s email address.
`{{unsubscribe_url}}`	Unique URL for one-click unsubscribe.
`{{current_year}}`	Four-digit current calendar year (e.g. `2026`).
`{{organization_name}}`	The name of your Mailofly organization.

You can access nested fields inside structured objects:

<p>Ship to: {{order.shipping_address.city}}, {{order.shipping_address.country}}</p>

And in your API request:

{
  "order": {
    "shipping_address": {
      "city": "San Francisco",
      "country": "USA"
    }
  }
}