Variables

Some variables can be defined at the beginning of your order email to change the look of the outgoing email. Both hexadecimal (#FFFFFF) and valid named (red, white) values are accepted. If you do not define these variables the default values shown below will be used.

• [% VAR_order_even_color:COLORVALUE %] - Text color of the even numbered invoice data rows (default #333333).
• [% VAR_order_odd_color:COLORVALUE %] - Text color of the odd numbered invoice data rows (default #333333).
• [% VAR_order_even_background_color:COLORVALUE %] - Background color of the even numbered invoice data rows (default #FFFFFF).
• [% VAR_order_odd_background_color:COLORVALUE %] - Background color of the odd numbered invoice data rows (default #FFFFFF).
• [% VAR_th_color:COLORVALUE %] - Text color of the item table header row (default #333333).
• [% VAR_th_background_color:COLORVALUE %] - Background color of the item table header row (default #FFFFFF).
• [% VAR_tr_even_color:COLORVALUE %] - Text color of the even numbered item table rows (default #333333).
• [% VAR_tr_odd_color:COLORVALUE %] - Text color of the odd numbered item table rows (default #333333).
• [% VAR_tr_even_background_color:COLORVALUE %] - Background color of the even numbered item table rows (default #FFFFFF).
• [% VAR_tr_odd_background_color:COLORVALUE %] - Background color of the odd numbered item table rows (default #F9F9F9).
• [% VAR_tr_link_color:COLORVALUE %] - Text color of item page links (default #0000EE).

Placeholders

The following values will be replaced by the relevant order information when sending your order email:

Custom subject lines

These three placeholders can be used in your custom subject lines:

• [% catalog_name %] - Store name.
• [% display_order_id %] - Order id including custom prefix (e.g. mystorename485).
• [% order_number %] - Order number (e.g. 485).

Merchant Information

• [% catalog_name %] - Store name.
• [% domain_name %] - Main domain associated with account.
• [% company_logo_url %] - The URL to your company logo if defined in checkout settings (http).
• [% sec_company_logo_url %] - The URL to your company logo if defined in checkout settings (https).
• [% inv_logo_image %] - Logo uploaded to print order settings (as <img> tag) .
• [% inv_logo_url %] - URL (with no http:// or https://) of logo uploaded to print options settings.
• [% logo_image %] - A full <img> tag for the logo uploaded to the email settings page.
• [% logo_url %] - The URL to the logo uploaded to the email settings page.
• [% store_id %] - Store id.

Shipping Information

• [% ship-firstname %] - Shipping address first name.
• [% ship-lastname %] - Shipping address last name.
• [% ship-name %] - Shipping address full name.
• [% ship-company %] - Shipping address company name.
• [% ship-address1 %] - Shipping address line one.
• [% ship-address2 %] - Shipping address line two.
• [% ship-city %] - Shipping address city.
• [% ship-state %] - Shipping address state.
• [% ship-zip %] - Shipping address zip code.
• [% ship_citystatezip %] - Shipping address city, state, and zip code formatted as a single line.
• [% ship-country %] - Shipping address country.
• [% ship-countryCode %] - Shipping address country code.
• [% ship-email %] - Shipping address email.
• [% ship-phone %] - Shipping address phone number.
• [% shipto_box %] - Full shipping information formatted as a table.
• [% tracking_number %] - The tracking number for the order if entered into the order manager.
• [% shipping_method %] - The shipping method being used.

Billing Information

• [% bill-firstname %] - Billing address first name.
• [% bill-lastname %] - Billing address last name.
• [% bill-name %] - Billing address full name.
• [% bill-company %] - Billing address company name.
• [% bill-address1 %] - Billing address line one.
• [% bill-address2 %] - Billing address line two.
• [% bill-city %] - Billing address city.
• [% bill-state %] - Billing address state.
• [% bill-zip %] - Billing address zip code.
• [% bill_citystatezip %] - Billing address city, state, and zip code formatted as a single line.
• [% bill-country %] - Billing address country.
• [% bill-countryCode %] - Billing address country code.
• [% bill-email %] - Billing address email.
• [% bill-phone %] - Billing address phone number.
• [% card_type %] -  Payment method.
• [% billto_box %] - Full billing information formatted as a table.

Item Information

If you would like to build your own item table rather than use [% items_table %] or [% items_table_no_opts %], you can use the following iterators and placeholders:

• [@ items_start @] .... [@ items_end @] - Use these to mark the beginning and end of your item table. Any markup and placeholders between them will be output for each individual item associated with the order.
• [% item_row_start %] ... [% item_row_end %] - Use these to mark the beginning and end of an item row. Any markup and placeholders between them will be output for the current item.
• [% item_name %] - Name of current item.
• [% item_code %] - Code of current item.
• [% item_qty %] - Quantity of current item.
• [% item_options %] - Options for current item as an unordered list. <ul> tag has class of order_item_options. <li> tags have class of order_item_option.
• [% item_noinc_options %] - Options for current item without incremental pricing displayed. <ul> tag has class of order_item_options. <li> tags have class of order_item_option.
• [% item_price %] - Unit price of current item.
• [% item_total_price %] - Total price of current item ( item_price * item_qty ).
• [% item_thumb %] - Item thumbnail (as <img> tag).
• [% item_trackshipstate %] - Shipping state of item if using split shipments.
• [% item_trackdomain %] - Tracking domain (UPS,FedEx,DHL,etc) of item if using split shipments.
• [% item_tracknum %] - Tracking number of item if using split shipments.
• [% item_subtotal %] - The subtotal of all items in the order.
• [% order_total %] - The total price of the order.

Gift certificates

• [@ gc_items_start @] ... [@ gc_items_end @] - Use these to mark the beginning and end of your gift certificates table. Any markup and placeholders between them will be output for each individual gift certificate in the order.
• [% item_gift_cert_amt %] - Dollar amount of gift certificate.
• [% item_gift_cert_codes %] - The gift certificate code.
• [% item_gift_cert_codes_nobullet %] - The gift certificate code, but unbulletted.
• [% gc_recipient %] - The gift certificate recipient.

Additional Order Information

• [% display_order_id %] - Order id including custom prefix (e.g. mystorename485).
• [% order_mark_message %] - Message shown to customer for customized order mark (ideal for order status emails).
• [% order_id %] - Order id including store id (e.g. yhst123456789485).
• [% date %] - Order date (e.g. Thu Jan 1 12:00:00 2015).
• [% short_date %] - Abbreviated date (e.g. Jan 01 2015).
• [% display_date %] - Alternate date format (e.g. Thursday January 01, 2015).
• [% items_table %] - Full invoice information formatted as a table.
• [% items_table_no_opts %] - Displays item table without an options column.
• [% comments %] - Buyer comment.
• [% coupon_amount %] - Coupon discount amount.
• [% coupon_code %] - Coupon code.
• [% coupon_desc %] - Coupon description.
• [% giftcert_amount %] - Gift certificate amount redeemed.
• [% giftcert_code %] - Gift certificate code.
• [% gift_wrap_charge %] - Gift wrap charge.
• [% gift_wrap_message %] - Gift wrap message.
• [% order_number %] - Order number (e.g. 485).
• [% order_status_url %] - Order status URL.
• [% shipping_amount %] - Shipping charge.
• [% shipping_method %] - Shipping method.
• [% tax_amount %] - Tax amount.
• [% mmddyy %] - Order date as mm/dd/yy.
• [% mmddyyyy %] - Order date as mm/dd/yyyy.
• [% yyyymmdd %] - Order date as yyyy/mm/dd.
• [% ddmmyyyy %] - Order date as dd/mm/yyyy.
• [% ddmmyy %] - Order date as dd/mm/yy.
• [% date_month %] - 2-digit month of order date.
• [% date_day %] - 2-digit day (1-31) of order date.
• [% date_year %] - 4-digit year of order date.
• [% date_short_year %] - 2-digit year of order date.
• [% repeats_list %] - A list of repeat orders from the current customer.
• [% ip_address %] - The buyer's IP address.

Custom Fields

If you have defined any custom fields in your checkout manager settings these can also be displayed in order emails. The placeholders for these custom fields would be in the format [% CF_<field> %] where <field> is the the ID you defined for that field during the setup process. For example, if you have a field that appears as modelnumber in the Order Manager that data could be added to emails with the placeholder [% CF_modelnumber %].