Email Placeholder Reference

Every placeholder available in the Email Center — tokens like {customerfirstname} that you type into a template and that are replaced when the email is sent.

How to use placeholders

In any template editor, click a token in the Available placeholders list to copy it, then paste it into the subject, heading, body, or footer.
Unknown or unavailable tokens are simply removed when the email is sent, so a stray placeholder never appears to customers.
Values are safely escaped automatically.

Site

Placeholder	Value
`{site_name}`	Your website’s name
`{site_url}`	Your website’s address
`{admin_email}`	The site admin email

Customer

Placeholder	Value
`{customer_name}`	Customer’s display name
`{customer_first_name}`	Customer’s first name (falls back to display name)
`{customer_email}`	Customer’s email address

Order (payment emails)

Placeholder	Value
`{order_id}`	The order number
`{order_total}`	The order total (formatted)
`{order_date}`	The order date

License

Placeholder	Value
`{license_key}`	The license key
`{plan}`	The plan name
`{status}`	The license/subscription status
`{expires_at}`	Expiry date (or “Never”)
`{allowed_sites}`	How many sites the license allows
`{activated_domain}`	The site being activated/deactivated (license emails)
`{used_sites}`	Sites currently activated (license emails)
`{remaining_activations}`	Activations still available (license emails)
`{days_remaining}`	Days until renewal/expiry (renewal reminders)

Free Trial (trial emails)

Placeholder	Value
`{trial_start_date}`	Trial start date
`{trial_end_date}`	Trial end date
`{trial_days_remaining}`	Days left in the trial
`{next_payment_date}`	First/next payment date
`{payment_method_status}`	Whether a payment method is on file
`{product_name}`	Product name

See Free Trials.

Security (security emails)

Placeholder	Value
`{ip_address}`	IP address associated with the event
`{event_time}`	Date and time of the event

Links

Placeholder	Value
`{dashboard_url}`	Link to the customer dashboard

Which placeholders can I use where?

Each template lists the placeholders that make sense for it in its editor. As a guide:

Subscription emails — Customer, License, Links (payment ones also Order).
Free Trial emails — Customer, License, {product_name}, the Free Trial tokens, Links.
License emails — Customer, License (incl. {activated_domain}, {used_sites}, {remaining_activations}), Links.
Security emails — Customer, Security ({ip_address}, {event_time}), Links.
Retention emails — Customer, License, {days_remaining}, Links.
Admin emails — Customer, Order, License, Site.

Tips & Best Practices

Personalise with {customer_first_name} in the greeting — it reads far warmer than a generic “Hello”.
Always add {dashboard_url} to action emails (payment failed, limit reached, win‑back) so customers can act immediately.
Preview after adding placeholders to confirm they resolve to sensible values.

Frequently Asked Questions

What happens if I use a placeholder that has no value?

It’s removed from the final email — customers never see a raw {token}.

Can a developer add custom placeholders?

Yes — the engine is extendable with a filter so custom tokens can be registered.

Are values safe from broken formatting?

Yes — every value is escaped before it’s inserted into the email.