Review Requests: Liquid Tips

With Liquid support, you can personalize review request emails well beyond the standard templates: greet customers by name, switch languages automatically, and show different copy or offers depending on what was purchased. Personalized review requests regularly drive substantially higher response rates.

In this guide

• Liquid goes in Settings > Customize > Reviews > Email Sequence. You must click the HTML button in the message editor first; otherwise, your code is treated as plain text.
• Only the variables in our Liquid Variable Reference are supported. Anything else fails silently and renders blank.
• {{customer.locale}} and {{order.locale}} are Shopify only. On other platforms, branch on {{customer.country}} or {{order.country}} instead.
• Use straight quotes (" and ') in your code. Curly quotes pasted in from Word or Google Docs will break the condition.

Shopify Liquid documentation: https://shopify.github.io/liquid/

In this guide

• Send review requests in the customer's language
• Translate the subject line
• Add product-specific messages in email
• Placing the codes in the email sequence message
• Test your Liquid
• Troubleshooting
• What Liquid does not translate

Send review requests in the customer's language

For Multi-lingual support, localizing a review request email has two layers, and you need both:

1. The standard labels (buttons, headers, footer text) are translated under Settings > Customize > Reviews > Localization. See Customize the Localization of Review Requests. 
2. Your own message copy is switched with the Liquid conditions below.

Recommended: branch on the customer's locale

On Shopify, and especially with Shopify Markets, customer.locale is the more reliable signal: it follows the language the customer actually bought in, rather than where they are located.

Using the customer's locale:

{% if customer.locale contains "fr" %}
	Bonjour {{customer.first_name}},
	Vous avez récemment acheté {{order.featured_product_title}}
	Obtenez un code de réduction de 10% en soumettant votre avis.
{% else %}
	Hello {{customer.first_name}},
	You recently purchased {{order.featured_product_title}}
	Get a <strong>10% discount code</strong> by submitting your review today.
{% endif %}

Alternative: branch on the customer's country

Use this if you are not on Shopify, or if you would rather target by market than by language. The country name must match exactly.

{% if customer.country == "France" %}
	Bonjour {{customer.first_name}},
	Vous avez récemment acheté {{order.featured_product_title}}
	Obtenez un code de réduction de 10% en soumettant votre avis.
{% else %}
	Hello {{customer.first_name}},
	You recently purchased {{order.featured_product_title}}
	Get a <strong>10% discount code</strong> by submitting your review today.
{% endif %}

Translate the subject line

Liquid works in the Subject field of the email sequence too, so the subject can be localized the same way as the body:

{% if customer.locale contains "fr" %}
    Nous aimerions vos commentaires
{% else %}
    We'd love your feedback
{% endif %}

Keep the whole condition on one line so the subject does not render with line breaks.

Add product-specific messages in the review request email

You can vary the message based on the order's featured product, using either its ID or its title.

Which product is the "featured" product? Each review request features one product from the order. If a customer buys several items, the featured product may not be the one you are targeting. On Shopify, add the product tag review-prioritize to the products you want featured, and Stamped will favour them when building the request.

Using Product ID:

{% if order.featured_product_id  == "4389960548401" %}

You recently purchased {{order.featured_product_title}}
Get a <strong>15% discount code</strong> by submitting your review today.

{% else %}

You recently purchased {{order.featured_product_title}}
Get a <strong>10% discount code</strong> by submitting your review today.

{% endif %}

Using Product Title:

 {% if order.featured_product_title == ‘raw asparagus’%}
You recently purchased {{order.featured_product_title}}
Get a <strong>15% discount code</strong> by submitting your review today.
{% else %}
You recently purchased {{order.featured_product_title}}
Get a <strong>10% discount code</strong> by submitting your review today.
{% endif %}

Add the code to your email sequence

You can place the above code snippets in any review request message as follows:

1. In the Stamped dashboard, go to Settings > Customize > Reviews > Email Sequence

2. Click on the HTML button to change the message input to accept HTML code:
    

   
   
    

3. Paste your copied code into the message, edit accordingly, and click Save once you're done
4. You can preview what the review request will look like in your inbox by clicking Send Test and emailing yourself a test email

Test your Liquid

Send Test emails using your saved template to yourself; it is the fastest way to confirm the layout, spelling, and that nothing is broken.

Important: a test email is not a real order, so conditions that depend on order or customer data (locale, country, featured product) will not necessarily resolve the way they will in production. To confirm a language or product condition end-to-end, place a real test order that matches the condition, for example, an order placed in the target locale, and check the request generated for it.

Troubleshooting

• A variable renders blank. Check it against the Liquid Variable Reference. Unsupported variables do not error; they simply render as nothing.
• The code shows as text in the email. The message was saved without first switching the editor to HTML. Click HTML, paste again, and save.
• The condition never fires. Most often this is curly quotes copied in from a document, a locale value that does not match (use contains "fr" rather than == "fr", which will not match fr-CA), or a multi-item order where a different product was featured.
• Nothing changes after saving. Confirm you edited the email that is actually scheduled in your sequence, then resend a test from an incognito window.

What Liquid does not translate

• The review widget. Widget labels and buttons follow the data-widget-language attribute, not your email Liquid. See Translating the Main Widget Language.
• Review content written by customers. Reviews stay in the language in which they were submitted. Translating them requires a third-party translation app such as Weglot or Langify. Shopify's Translate & Adapt cannot translate review text because reviews render client-side from Stamped's database.

To surface reviews in the shopper's language on a multilingual storefront, see Translating the Main Widget Language.