Templates API

A template is a reusable email design stored as full HTML. Templates created through the API appear under Templates in the app, can be edited in the HTML editor, and can be used as the starting point for campaigns and automation emails. Merge tags such as {{firstName}} and {{coupon_code}}, and product blocks using template syntax like {% for item in line_items %}, are rendered per recipient at send time. Dynamic product feeds use the same syntax with feed.<slug> as the collection, for example {% for item in feed.recently_viewed limit:4 %} wrapped in {% if feed.recently_viewed %}. Built-in slugs are recently_viewed, cart, recommended, best_sellers and new_arrivals; custom feeds are defined under Integrations, Product feeds in the app. Items expose name, url, image, price, compare_at_price, currency, vendor, category and product_id (plus quantity and line_total for cart). For multilingual catalogs each item is rendered in the recipient's language (subscriber language field, then the language they browsed in, then the store default); add a lang modifier to fix it, for example {% for item in feed.best_sellers limit:4 lang:en %}.

Use the optional category field to organize designs, for example welcome, newsletter or custom (the default).

• Push designs from your own design pipeline or repository into the platform.
• Keep one master template in sync across several accounts or environments.
• Fetch a template’s HTML to render previews in your own tools.
• Create seasonal variants of a base template programmatically.