Variables reference

A variable is a placeholder in double curly brackets, such as {{order.number}}. When Invoicepak sends an invoice, it replaces the variable with that order's details. For example, Invoice {{order.number}} becomes Invoice #1001.

Where you can use variables#

Variables work in three fields in Settings:

The hint under each field lists the variables most useful there:

1. Subject: {{order.number}}, {{shop.name}}
2. Message body: {{customer.firstName}}, {{customer.lastName}}, {{order.number}}, {{order.total}}, {{shop.name}}

PDF file name: {{order.number}}, {{shop.name}}, {{customer.lastName}}

Every variable in the next section works in all three fields, not just the ones listed in the hints.

Variables don't work in:

• the Footer message text, where curly brackets are removed,
• text you type into a template in the template editor,
• Business details.

Every variable at a glance#

Your store#

The order#

The customer#

The shipping address#

Line items don't work in emails or file names#

{{lineItem.title}}, {{lineItem.quantity}} and {{lineItem.price}} don't work. An order can have many products, so these variables have no single value in an email or a file name. They're treated like a misspelled variable. Your customer sees every product in the line items table on the invoice PDF.

How to type a variable#

• Use two curly brackets on each side: {{order.number}}.
• Match the capital letters exactly: {{customer.firstName}} works, but {{customer.firstname}} and {{Order.Number}} don't.
• Spaces inside the brackets are fine: {{ order.number }} works the same as {{order.number}}.
• You can use as many variables as you like, anywhere in the text.

When a variable is empty or misspelled#

A variable can be empty when the order doesn't have that detail. For example, a guest checkout may have no first name, and a digital order has no shipping address. A misspelled variable, a {{lineItem.*}} variable, or wrong capital letters are treated the same way.

What happens depends on the field:

If a file name ends up completely empty, the default is used instead, for example Invoice-#1001.pdf.

Copy-paste examples#

Subject#

Message body#

A friendly thank-you:

Hi {{customer.firstName}},

Thanks for your order {{order.number}} from {{shop.name}}.
Your invoice for {{order.total}} is attached.

Questions? Just reply to this email.

Hi Jane,

Thanks for your order #1001 from Acme Coffee Roasters Ltd.
Your invoice for $52.02 is attached.

Questions? Just reply to this email.

A breakdown of the total:

Hello {{customer.firstName}} {{customer.lastName}},

Your order is on its way to {{shipping.city}}, {{shipping.country}}.

Subtotal: {{order.subtotal}}
Shipping: {{order.shipping}}
Tax: {{order.tax}}
Total: {{order.total}}

Hello Jane Cooper,

Your order is on its way to Portland, United States.

Subtotal: $44.00
Shipping: $4.50
Tax: $3.52
Total: $52.02

PDF file name#

You don't type .pdf. It's added for you.

Which plan do I need?#

Variables in PDF file name work on every plan, including Free. Subject and Message body can only be edited on the Basic plan or higher.

On the Free plan, emails use the default subject and message, which already include {{order.number}}, {{shop.name}}, {{customer.firstName}} and {{customer.lastName}}.

Common questions#

My customer's email subject shows {{customer.firstName}}. Why?#

The order had no first name (for example, a guest checkout), or the variable is misspelled. In the Subject, these are left as typed. Use variables every order has, like {{order.number}}.

Why does my message say "Hello," with no name?#

The order has no customer name, so the name variables were removed. Your customer still sees a tidy greeting.

Can I show the products in the email?#

No. The {{lineItem.*}} variables don't work in emails or file names. Your customer sees every product on the attached invoice PDF.

Can I format the order date?#

Not yet. {{order.date}} prints a technical date and time, such as 2026-10-06T14:23:05Z. The invoice PDF shows a friendly date, such as "Oct 6, 2026".

Why does {{shop.address}} show my Shopify address and not my Company address?#

It uses the street, city and country from your Shopify store details. Update them under Settings → Store details in the Shopify admin.

Does {{shop.name}} use my Company name?#

Yes. If Company name is empty, it uses your Shopify store name.