Email Templates with Variables

Use the toolbar to change the font, color, links, and more! You can even insert tables and lists.

In the default email templates, you will notice references to fields like {{shipment.customer_name}}. These fields are called variables. Each variable field is enclosed in curly brackets: {{ }}.

When ShippingEasy creates the email to send to your customer, it will substitute the correct value for the variable field based on the order details - in the above example, the name of your customer.

There is a wide variety of variables that ShippingEasy can substitute for you. They are available from the three variable menu buttons in the toolbar for the Store, Recipient, and Shipment:

To insert a variable, click in the body of the email where you want the variable field to go, then select the variable from the menu. You can also type in the variable field using the special syntax and curly brackets. Learn more about available variables to map your store and order information.

Store Variable	Recipient Variables	Shipment Variables

The {{ shipment.line_items }} variable generates a table of line items included in an order, but also requires special handling. To add the custom variable below, simply copy and paste the entire line, including the {{ curly brackets }} at each end, into your template: {{ shipment.line_items | sort: 'name' | columns: 'sku qty name price total' }}

Available Values

The default Line Item configuration (above) only displays the sku, qty, item name, price, and total values. Below is a list of all values available for sorting or displaying in columns of the Shipment Line Items table.

Sort Line Items

By default, Line Items are sorted by item name. You can specify any of the other available columns for the sort order. Only a value specified as a column can be used to sort the line items.

Indicate which column controls the sort order by editing the term after "sort". For example, the following variable is used to sort the Shipment Line Items table by product SKU: {{ shipment.line_items | sort: 'sku' | columns: 'sku|qty|item name|price|total' }}

Columns Displayed

By default, five values are displayed as columns: sku, qty, name, price, and total. Any of the available values may be assigned to a column. The order of the values in the variable determines the order of the columns.

Product Images

By default, images from the Product Catalog are sized in the Shipment Line Items table at 75 x 75 pixels. You can change the size of the image by specifying the dimensions in the image_size value. For example: {{ shipment.line_items | sort: 'name' | columns: 'sku image qty name price total' | image_size: '60x60' }}

Format the Table

By default, the Shipment Line Items table does not have any formatting. A formatting option can be inserted into the list of columns displayed to draw grid lines around the list of items: {{ shipment.line_items | columns: 'sku|qty|item name|price|total|format_grid' }}

Another option is to display alternating rows of the list of line items on a shaded background: {{ shipment.line_items | columns: 'sku|qty|item name|price|total|format_shade' }}

Alternative Line Item Variables

Similar to the {{ shipment.line_items }} variable, there are two other variables that will display a list of shipment line items:

Both of these variables include the following columns values: item name, qty, price, and total.

These variables cannot be modified. We recommend using these variables when additional customization of the {{ shipment.line_items }} variable is not needed.

As you experiment with different content and formatting options, we recommend periodically sending yourself an example email message. This way, you can see what your template looks like.

Notes about test emails: