Customize your email templates in Klaviyo
When you send through Klaviyo, you design the email in Klaviyo's own editor rather than STOQ's built-in one. STOQ passes the product details, customer data, and links on each event, and you drop them into the template as variables.
Before you begin
| Requirement | Detail |
|---|---|
| A paid plan | The Klaviyo integration is a paid feature. |
| Klaviyo connected and a verified flow | Set Klaviyo as your provider and verify the flow. See Send back in stock alerts through Klaviyo. |
Open your flow's email
Open the flow in Klaviyo
In your Klaviyo dashboard, open the flow triggered by the STOQ metric, for example Back in stock alert (STOQ) or Preorder confirmed (STOQ). If you used STOQ's automatic setup, these flows already exist.
Edit the email
Click the Email action, then Edit Email to open the template designer.
Build the email
- Subject and preview text: insert variables with the format
{{ event.variable_name }}, for example{{ event.product_title }} is back in stock! - Product image: add an Image block with the source set to
{{ event.image_url }}. - Product details: add a Text block using variables like
{{ event.product_title }},{{ event.price }}, and{{ event.variant_title }}. - Call-to-action button: add a Button block with the URL set to
{{ event.checkout_link }}for direct checkout, or{{ event.product_page_link }}for the product page. - Unsubscribe link: add a text link to
{{ event.unsubscribe_link }}.
The STOQ unsubscribe link only removes a customer from STOQ notifications, not from your Klaviyo lists.
For the complete variable lists, see back in stock variables and preorder variables. Back in stock and preorder flows use different variables, so use the set that matches the flow.
Test your template
Send a test event from STOQ
In STOQ, open the alert's Customize email > Klaviyo settings and click Send test event. This pushes a test event into Klaviyo with real data.
Preview in Klaviyo
In the Klaviyo email editor, click Preview & Test to see the template populated, then send a test to yourself to confirm the final result.
Troubleshooting
Variables show as blank or as literal text
Check the variable path. Use {{ event.product_title }}, and send a test event so Klaviyo has real data to render. A misspelled property name prints as-is.
The product image is missing
The product has no image in Shopify. Add one, or design the block to tolerate an empty image_url.
The email never triggers
The flow is likely in Draft. Set it to Live in Klaviyo. If the test event doesn't reach Klaviyo at all, re-check the connection.
FAQ
Can one template serve the alert and the reminder?
They're separate flows on different metrics, but the event data is the same shape, so you can duplicate a template design across both.
Can I use conditional logic in the template?
Yes. Klaviyo supports template logic, for example {% if event.is_reminder %} for reminder-specific wording, or a language check for translated copy.
Do I need to update my template when STOQ adds a variable?
No. New properties are added to the event automatically, and your existing template keeps working.
Does STOQ's built-in editor still apply?
No. When Klaviyo is selected, all design happens in Klaviyo. STOQ's built-in email editor is used only when STOQ sends the email.
Related guides
Send back in stock alerts through Klaviyo
Connect Klaviyo and verify the flow first.
Personalize with back in stock variables
The full back in stock event property reference.
Personalize with preorder variables
The full preorder event property reference.
Emails not sending after verification?
Fix a flow that verifies but doesn't deliver.
