Products, coupons and the cart

With your shop’s products and orders in Emailit (see Commerce), campaign and automation emails can show products, give each recipient their own coupon code, list what’s in their cart and use their purchase history. Every tag on this page works in the subject, the HTML and the plain-text version, and is filled in for each recipient when the email is created.

Add a block in the editor

In the campaign wizard’s Content step, select Products & coupons. Pick products, a coupon, the cart or customer data, adjust the options, select Copy and paste the tag into your content. In the rich-text and Dragit editors, the variables menu also lists ready-made commerce tags.

The rest of this page describes the tags themselves, for the HTML editor, the API and automation templates.

Product grids

{{products}} inserts a grid of product cards with an image, the title, the price (with the old price struck through when the product is on sale) and a button:

{{products source="best_sellers" limit="3"}}
{{products source="recently_viewed" limit="4" fallback="best_sellers" button="View"}}
{{products "on_sale"}}

A leading quoted word is a short form for source.

Feeds skip archived products and products with an inventory of 0, except last_order.

Sources

Your own layout

To design the cards yourself, loop over a feed with {{#each}}. Inside the loop, use the product fields:

{{#each products.recommended limit="3" fallback="best_sellers"}}
  <a href="{{url}}"><img src="{{image_url}}" alt="{{title}}" width="180"></a>
  <p>{{title}}: {{price_formatted}}{{#if on_sale}} <s>{{compare_at_price_formatted}}</s>{{/if}}</p>
{{/each}}

Use {{#if products.recently_viewed}}...{{/if}} to show a section only when a recipient has products in a feed. Product data is HTML-escaped, so a product title can’t break your email.

Coupon codes

{{coupon "key"}} inserts a code from the coupon with that key:

<p>Here's 10% off your next order: <strong>{{coupon "welcome10"}}</strong></p>

• A unique codes coupon gives each recipient their own code from its pool. A recipient keeps the same code in every email of the same campaign or automation, including the web version.
• A one code for everyone coupon inserts its code for everyone.
• When a unique coupon’s pool is empty or the coupon has expired, recipients get its fallback code, or nothing if it has none.
• Previews and test sends show a sample such as WELCOME10-PREVIEW and don’t use up codes.
• An unknown key renders nothing.

{{coupon.welcome10}} is the same code as a variable, for example in {{#if coupon.welcome10}}.

The cart

{{cart}} inserts the recipient’s open cart: each item with its image, quantity and price, the total and a Return to your cart button linking to the cart’s checkout URL. Set button and button_color like on product grids. When the recipient has no open cart, it renders nothing.

For your own layout, use the cart variables:

{{#if cart}}
  <p>You left {{cart.item_count}} items ({{cart.total_formatted}}) in your cart.</p>
  {{#each cart.items}}<p>{{quantity}} × {{title}}: {{line_total_formatted}}</p>{{/each}}
  <a href="{{cart.checkout_url}}">Complete your order</a>
{{/if}}

cart has id, total, total_formatted, currency, checkout_url, item_count and items. Each item has the product fields above plus quantity, line_total and line_total_formatted. The cart is the contact’s most recent active or abandoned cart, so in an abandoned cart automation it’s the cart that was abandoned.

Customer data

{{#if customer.is_customer}}Thanks for being a customer since {{customer.first_order_at}}.{{else}}Your first order ships free.{{/if}}

Web version

{{webview_url}} links to a web version of the email, rendered for that recipient with the same products, cart and coupon code. Use it for a “View in browser” link.

Related