Articles on: Integrations

How to send back in stock and preorder emails in the customer’s language using Klaviyo

When you use Klaviyo as your email provider in STOQ, you can send back in stock emails in multiple languages through Klaviyo by using customer locale data and conditional flow splits. STOQ automatically syncs each customer's language preference to their Klaviyo profile, so you can build flows that deliver restock alerts, back in stock reminders, and preorder confirmation emails in the right language. This guide walks you through the setup from connecting Klaviyo to creating multi-language flows for all notification types


Overview


STOQ records each customer's locale when they sign up for a back in stock alert or place a preorder. When you connect Klaviyo as your email provider, STOQ syncs this locale data to the customer's Klaviyo profile — both as a standard locale field and as a custom StoqLocaleCountry property. You can then use Klaviyo's conditional split feature to route customers into different email branches based on their language. Each branch sends a translated version of your email. This approach works for back in stock alerts, back in stock reminders, and preorder confirmation emails.


Prerequisites


Make sure the following are in place before you set up multi-language back in stock emails through Klaviyo.


  • You have a paid STOQ plan. Klaviyo as an email provider is a paid feature.
  • You have a Klaviyo account with access to create flows and email templates.
  • Your Klaviyo app is connected in STOQ. Go to Back in stock > Integrations > Klaviyo and connect the app.
  • Klaviyo is selected as your email provider in STOQ. Go to Back in stock > Notifications > Customize > Email > Send emails through and select Klaviyo.
  • Your Klaviyo flow is created and verified in STOQ using the metric Back in stock alert (STOQ).


How STOQ Sends Language Data to Klaviyo


STOQ automatically sends customer language information to Klaviyo every time a customer signs up for a back in stock alert. Understanding this data helps you build accurate multi-language flows.


Profile Properties Synced to Klaviyo


When STOQ syncs a customer to Klaviyo, the following language-related data is included on the customer profile:


  • locale — The customer's language code as recorded by Shopify (e.g., en, fr, de, ja). This is set as a standard Klaviyo profile property.
  • StoqLocaleCountry — A combined locale and country code (e.g., en-US, fr-CA, de-DE). This custom property gives you more granular control for regional language variations.


Event Data Sent with Notifications


When STOQ triggers a metric in Klaviyo, the event payload includes customer locale data. This applies to all notification types:


  • Back in stock alert (STOQ) — Triggered when a product comes back in stock.
  • Back in stock reminder 1 (STOQ) — Triggered for reminder notifications.
  • Preorder confirmed (STOQ) — Triggered when a customer places a preorder.


Each event payload includes:


  • customer.locale — The customer's language preference.
  • customer.country — The customer's country code.


You can reference these values in your Klaviyo flow using conditional splits or in your email template using dynamic variables.



Set Up a Multi-Language Flow in Klaviyo


To send back in stock emails in multiple languages through Klaviyo, you create a single flow triggered by STOQ's metric and add conditional splits based on the customer's locale.


Step 1: Open Your Back in Stock Flow


  1. Log in to your Klaviyo account.
  2. Go to Flows in the left navigation menu.
  3. Open the flow that is triggered by the Back in stock alert (STOQ) metric. This is the flow you connected and verified in STOQ.



Step 2: Add a Conditional Split


  1. In the flow editor, click the + button below the trigger to add a new step.
  2. Select Conditional Split.
  3. Set the condition to check the customer's language. Use one of these options:
  • Profile property > locale > equals > enter the language code (e.g., fr for French).
  • Profile property > StoqLocaleCountry > equals > enter the locale-country code (e.g., fr-CA for Canadian French).
  1. Click Save.



Tip: Use the locale property for broad language matching (e.g., all French speakers). Use StoqLocaleCountry when you need to distinguish between regional variations (e.g., French in France vs. French in Canada).


Step 3: Create Translated Email Templates


  1. On the YES branch of the conditional split (where the locale matches), add an Email action.
  2. Design the email template in the target language — translate the subject line, preview text, body copy, and button text.
  3. On the NO branch, add another conditional split for the next language, or add a default email in your store's primary language.
  4. Repeat for each language you want to support.



Step 4: Set the Flow to Live


  1. Review each branch to confirm the correct language is assigned to each conditional split.
  2. Set each email action to Live (or set the entire flow to Live).
  3. Click Review and turn on to activate the flow.


Use Dynamic Variables in Translated Templates


When designing your Klaviyo email templates, you can use STOQ's event variables to personalize each translated email. These variables are available in every language branch.


  • {{ event.product.title }} — The product title.
  • {{ event.product.variant_title }} — The variant title.
  • {{ event.product.price }} — The product price.
  • {{ event.product.image_url }} — The product image URL.
  • {{ event.links.checkout_link }} — The direct checkout link.
  • {{ event.links.product_page_link }} — The product page link.
  • {{ event.shop.name }} — Your store name.
  • {{ event.customer.locale }} — The customer's locale (useful for conditional content within a single template).


Note: Product titles and variant titles are sent in your store's default language from STOQ. If you need translated product names in Klaviyo, you can add them manually to your Klaviyo templates or use Klaviyo's catalog features.


Set Up Multi-Language Reminder Notifications


If you use back in stock reminder notifications in STOQ, you can apply the same multi-language approach to your reminder flow.


  1. In STOQ, the reminder metric is Back in stock reminder 1 (STOQ).
  2. Create a separate flow in Klaviyo triggered by this metric (or add it as a time delay within your existing flow).
  3. Add conditional splits based on locale or StoqLocaleCountry, just like the primary notification.
  4. Create translated email templates for each language branch.


Note: Here's our detailed guide on How to send back in stock email reminders through Klaviyo


Set Up Multi-Language Preorder Confirmation Emails


You can also send preorder confirmation emails in multiple languages through Klaviyo. STOQ sends the same locale data when a customer places a preorder.


Step-by-Step Instructions


  1. In STOQ, go to Preorders > Notifications > Customize > Email > Send emails through and select Klaviyo.
  2. Connect and verify your Klaviyo flow using the metric Preorder confirmed (STOQ).
  3. In Klaviyo, open the flow triggered by Preorder confirmed (STOQ).
  4. Add a Conditional Split based on Profile property > locale (or StoqLocaleCountry).
  5. On the YES branch, add an email action with the translated preorder confirmation template.
  6. On the NO branch, add another conditional split for the next language or a default-language email.
  7. Set the flow to Live.


Note: If you use additional preorder flows for shipping updates and payment failures, you can apply the same conditional split approach. The metrics are Preorder shipping update (STOQ) and Preorder payment failed (STOQ).''


Here's our detailed guide on how to send preorder confirmation emails through STOQ


Known Limitations


  • Templates are managed in Klaviyo. You design and translate all email content in Klaviyo's template editor, not in STOQ. STOQ's built-in translation page does not apply when Klaviyo is the email provider.
  • Product titles are not automatically translated. STOQ sends product data in your store's default language. You need to handle product title translations separately in Klaviyo if needed.
  • Each language requires its own flow branch. You need to add a conditional split and a separate email template for every language you support. This applies to back in stock, reminder, and preorder flows individually.
  • Locale depends on customer browser or Shopify settings. STOQ records the locale from the customer's browser language or Shopify account preference at the time they sign up. If a customer changes their language later, the stored locale may not update.
  • Paid STOQ plan required. Using Klaviyo as the email provider requires a paid STOQ plan.
  • StoqLocaleCountry may be blank. If the customer's locale or country is not available, the StoqLocaleCountry property may not be set. Your default flow branch should handle customers with missing locale data.
  • Each notification type needs its own flow. Back in stock alerts, reminders, and preorder confirmations are triggered by separate metrics. You need to set up conditional splits in each flow individually.


Troubleshooting


Symptom

Likely Cause

Fix

Customers all go through the default branch

The locale property is empty on their Klaviyo profile

Check that STOQ is syncing customers to Klaviyo. Go to Back in stock > Integrations > Klaviyo and verify the connection

Conditional split does not match the expected language

The split uses the wrong property or value

Verify you are checking the locale profile property (not an event property) and using the correct language code (e.g., fr, not French)

Translated emails are not sending

The flow or email action is in Draft mode

Set each email action and the flow to Live in Klaviyo

StoqLocaleCountry is missing from the profile

The customer signed up before STOQ added this property

The property is set on new signups. Existing customers update when they sign up again or when STOQ re-syncs them

Flow is not triggering at all

The Klaviyo flow is not connected to the correct metric

Verify the flow trigger is set to the correct metric: Back in stock alert (STOQ), Back in stock reminder 1 (STOQ), or Preorder confirmed (STOQ)

Product titles appear in the wrong language

STOQ sends titles in the store's default language

Add translated product names manually in your Klaviyo template or use Klaviyo's catalog features

Preorder confirmation emails are not multi-language

Conditional splits are not set up in the preorder flow

Open the flow triggered by Preorder confirmed (STOQ) in Klaviyo and add conditional splits based on locale


FAQs


Q: Where do I translate the email content when using Klaviyo?

A: All email content — subject line, body, button text — is designed in Klaviyo's template editor. STOQ's built-in Languages for notifications page only applies when STOQ is the email provider. When Klaviyo is selected, you create separate email templates in Klaviyo for each language.


Q: What locale format does STOQ send to Klaviyo?

A: STOQ sends the customer's locale as a two-letter language code (e.g., en, fr, de). The StoqLocaleCountry property combines the locale and country code (e.g., en-US, fr-CA). Use the format that best matches your needs.


Q: Can I use a single Klaviyo template with dynamic content instead of multiple branches?

A: Yes. Instead of conditional splits, you can use Klaviyo's template language to show or hide content blocks based on {{ person.locale }}. For example, use {% if person.locale == "fr" %} to render French content. This approach works well if your translations are short.


Q: Do I need to enable multi-language support in STOQ's settings?

A: Enabling multi-language support in STOQ's Settings is not required for Klaviyo flows to receive locale data. STOQ always syncs the customer's locale to Klaviyo. However, enabling multi-language in STOQ is needed if you also want the "Notify me" button and signup form translated on your storefront.


Q: Can I send preorder confirmation emails in multiple languages through Klaviyo?

A: Yes. STOQ sends the same locale data when triggering the Preorder confirmed (STOQ) metric. Set up conditional splits in your preorder flow the same way you would for back in stock alerts. You can also apply this to Preorder shipping update (STOQ) and Preorder payment failed (STOQ) flows.


Q: Do I need separate flows for back in stock alerts, reminders, and preorder confirmations?

A: Yes. Each notification type uses a different Klaviyo metric, so each one requires its own flow. You need to add language-based conditional splits in each flow individually.


Q: What happens if a customer's locale is not set?

A: If the locale is empty, the conditional split falls through to the NO branch. Make sure your default branch (the last one in the chain) handles customers without a locale by sending the email in your store's primary language.


Q: Can I send SMS notifications in multiple languages through Klaviyo too?

A: Yes. If you use Klaviyo for SMS, you can apply the same conditional split approach to SMS flows. Use the locale or StoqLocaleCountry profile property to route customers to translated SMS messages.


Q: How do I test my multi-language flow before going live?

A: In STOQ's email settings, click Send test event to trigger a test event in Klaviyo. Then check your Klaviyo flow to see which branch the test event follows. You can also create a test profile in Klaviyo with a specific locale value and preview the email for that profile

Updated on: 29/04/2026

Was this article helpful?

Share your feedback

Cancel

Thank you!