Klaviyo example email templates

The following examples contain JSON payloads that can be sent to Klaviyo instead of email. See Using Klaviyo for how to link Klaviyo for sending notification emails. You can extend these examples yourself using the Liquid tags Firmhouse provides.

Confirmation email

{%- capture ProductnamesListString -%}
 {%- for product in subscription.products -%}
 {"title": "{{product.title}}", "ProductImage": "{{product.product_image_url}}", "ProductPrice": "{{product.price}}"};
 {%- endfor -%}
{%- endcapture -%}
{% assign ProductnamesList = ProductnamesListString | split:';' | join:"," %}

{
 "Name": "{{subscription.name}}",
 "ProductnamesList": [{{ProductnamesList}}],
 "MarketingConsent": "{{subscription.marketing_opt_in_accepted?}}",
 "InvoiceAmount": "{{invoice.amount_price}}",
 "LoginUrl": "{{subscription.login_url}}"
}

Upcoming order notice

{%- capture ProductnamesListString -%}
 {%- for product in subscription.next_upcoming_products -%}
 {"title": "{{product.title}}", "quantity": "{{product.quantity}}", "shipmentdate": "{{product.shipment_date}}", "outofstock": {{product.out_of_stock}}, "replaceurl": "{{product.replace_url | ssc_hotlink}}"};
 {%- endfor -%}
{%- endcapture -%}
{% assign ProductnamesList = ProductnamesListString | split:';' | join:"," %}
{% assign OutOfStockProducts = subscription.next_upcoming_products | where: "out_of_stock" %}

{
 "Name": "{{subscription.name}}",
 "UpcomingProductsList": [{{ProductnamesList}}],
 "HasOutOfStockProducts": {% if OutOfStockProducts.size > 0 %}true{% else %}false{% endif %},
 "SelfServiceCenterUrl": "{{project.self_service_center_url}}"
}

The per-product outofstock field and the HasOutOfStockProducts flag are only true when Shopify stock levels are enforced, so Klaviyo flows can branch on them to warn customers about products that would cause their renewal to be skipped. subscription.next_upcoming_products also includes active Next order only products. Their shipmentdate is empty because they inherit the next order’s shipment date. After the order containing them is created, they are removed from the subscription and no longer appear in this collection. The per-product replaceurl field links straight to the swap flow for that product in the customer portal. Piped through ssc_hotlink, it logs the customer in automatically, so one click in the Klaviyo email takes them to picking a replacement product. The hotlink is valid for one week from the moment the event is sent.

Cancellation initiation email

{
 "Name": "{{subscription.name}}"
}

Cancellation confirmation email

{
 "Name": "{{subscription.name}}"
}

Billing cycle notification

{%- capture ProductnamesListString -%}
 {%- for product in subscription.products -%}
 {"title": "{{product.title}}", "ProductImage": "{{product.product_image_url}}", "ProductPrice": "{{product.price}}"};
 {%- endfor -%}
{%- endcapture -%}
{% assign ProductnamesList = ProductnamesListString | split:';' | join:"," %}

{
 "Name": "{{subscription.name}}",
 "ProductnamesList": [{{ProductnamesList}}],
 "InvoiceAmount": "{{invoice.amount_price}}",
 "Paymentmethod": "{{subscription.payment_method}}",
 "InvoiceUrl": "{{invoice.pay_now_url}}"
}

Failed payment

{% assign failed_invoices = outstanding_invoices %}
{% assign failedInvoicesCount = failed_invoices | size %}

{%- capture failedInvoicesString -%}
 {%- for invoice in failed_invoices -%}
{"number": "{{invoice.number}}", "amount": "{{invoice.amount_price}}", "statusCode":
"{{invoice.status_code}}", "statusTranslated": "{{invoice.status_translated}}",
"pendingRetriesBoolean": {{invoice.pending_retries?}},
"payNowUrl": "{{invoice.pay_now_url}}" };
 {%- endfor -%}
{%- endcapture -%}

{% assign failedInvoicesList = failedInvoicesString | split:';' | join: ", " %}

{
 "Name": "{{subscription.name}}",
 "paymentAmount": "{{payment.amount_price}}",
 "paymentPayNowUrl": "{{payment.pay_now_url}}",
 "failedInvoicesCount": "{{failedInvoicesCount}}",
 "failedInvoicesList": [{{failedInvoicesList}}]
}

Manual charge notification

{%- capture ProductnamesListString -%}
 {%- for product in subscription.products -%}
 {"title": "{{product.title}}", "ProductImage": "{{product.product_image_url}}"};
 {%- endfor -%}
{%- endcapture -%}
{% assign ProductnamesList = ProductnamesListString | split:';' | join:"," %}

{
 "Name": "{{subscription.name}}",
 "ProductnamesList": [{{ProductnamesList}}],
 "Amount": "{{payment.amount_price}}",
 "Description": "{{payment.description}}"
}

Outstanding invoices

{% assign failed_invoices = outstanding_invoices %}
{% assign failedInvoicesCount = failed_invoices | size %}

{%- capture failedInvoicesString -%}
 {%- for invoice in failed_invoices -%}
{"number": "{{invoice.number}}", "amount": "{{invoice.amount_price}}", "statusCode":
"{{invoice.status_code}}", "statusTranslated": "{{invoice.status_translated}}",
"pendingRetriesBoolean": {{invoice.pending_retries?}},
"payNowUrl": "{{invoice.pay_now_url}}" };
 {%- endfor -%}
{%- endcapture -%}

{% assign failedInvoicesList = failedInvoicesString | split:';' | join: ", " %}

{
 "Name": "{{subscription.name}}",
 "failedInvoicesList": [{{failedInvoicesList}}]
}

statusCode is stable across subscription locales and is intended for conditions or merchant-owned translations in Klaviyo. statusTranslated is display text localized using the subscription’s locale.

Invoice reminder

{
 "Name": "{{subscription.name}}",
 "InvoiceAmount": "{{invoice.amount_price}}",
 "InvoiceNumber": "{{invoice.number}}",
 "InvoiceUrl": "{{invoice.pay_now_url}}",
 "FinalReminder": "{{invoice_reminder.final_reminder}}",
 "ReminderNumber": "{{invoice_reminder.reminder_number}}"
}

{
 "Name": "{{subscription.name}}",
 "Login": "{{subscription.login_url}}"
}

Get Started

Get Started on Shopify

Continue your project setup

Customer Portal v2

Self Service Center v1

Manage

Reporting & Metrics

Configure

Billing and Account

Explained

Troubleshooting

Enterprise

Klaviyo example email templates

Confirmation email

Upcoming order notice

Cancellation initiation email

Cancellation confirmation email

Billing cycle notification

Failed payment

Manual charge notification

Outstanding invoices

Invoice reminder

​Confirmation email

​Upcoming order notice

​Cancellation initiation email

​Cancellation confirmation email

​Billing cycle notification

​Failed payment

​Manual charge notification

​Outstanding invoices

​Invoice reminder

​Self service center login

Confirmation email

Upcoming order notice

Cancellation initiation email

Cancellation confirmation email

Billing cycle notification

Failed payment

Manual charge notification

Outstanding invoices

Invoice reminder

Self service center login