Replacement Tokens

Replacement Tokens allow dynamic insertion of variable data (like dates or customer info) into templates, ensuring personalized and accurate documents.

---

What are Replacement Tokens?

The items surrounded by braces { } in various templates on the settings tabs are called tokens. These tokens are used in the messages to represent the data that will be replaced in the template. For example, when a template using the customer token {Customer} is sent, it replaces the token with the actual customer.

Token support is specific to which template is being rendered — the Driver Dispatch SMS template and the Driver Start Time template do not share the same set of tokens. Tokens also aren’t validated as you type them — an unsupported token is simply left unchanged in the generated message rather than being flagged.

Driver Dispatch SMS Template Tokens

These tokens are used when sending dispatches through the “Schedule” page using the “Dispatch to driver” menu, or through “Send orders to drivers”:

Token Name	Description
{DeliveryDate}	Delivery date of the order
{Shift}	Shift of the order
{OrderNumber}	Order number of the order
{Customer}	Customer’s name
{LoadAt}	”Load At” value present in the order
{DeliverTo}	”Deliver To” value present in the order
{Directions}	”Directions” value present in the order
{Item}	”Item” value present on the order line
{Supplier}	”Supplier” value present on the order line
{Quantity}	”Quantity” value present on the order line
{UOM}	”UOM” value present on the order line (case-insensitive; {Uom} also resolves)
{ChargeTo}	”Charge To” value present on the order
{CompanyName}	Your company/tenant name

{TimeOnJob} and {StartTime} do not resolve in this template. If included here, they’ll be left in the message as literal text rather than being replaced — see the Driver Start Time table below for where those two tokens actually work.

Driver Start Time Template Tokens

This template is used when the “Notify drivers” button on the “Driver Assignments” page is used, and has its own separate set of tokens:

Token Name	Description
{TruckCode}	The truck code
{TimeOnJob}	”Time on Job” value present in the order
{StartTime}	Clock-in/start time

These three tokens resolve on the Driver Start Time notification path only — they will not resolve if used in the Driver Dispatch SMS template.

Invoice and Email Templates

Invoice and email templates use the same substitution rules as the order/order-line/company tokens listed above. Two additional notes specific to invoices:

• If your invoice settings hide Load At and Deliver To on hourly invoices, {LoadAt} and {DeliverTo} will render blank on those invoices.
• {Order.DateTime} is a backward-compatible alias for {DeliveryDate} — both resolve to the same value.

A Note on Deprecated Tokens

{Route} is not a supported token in the current system. If included in a template, it will be left unchanged in the message rather than being replaced with a value.