---
title: "Customizing Your Review Emails Using the Email Template Editor"
slug: "customizing-your-email"
tags: ["Reviews ", "Shopify Plus", "Shopify", "Adobe Commerce (Magento)", "WooCommerce", "BigCommerce", "Volusion", "Salesforce Commerce Cloud", "Custom"]
updated: 2025-05-08T13:10:06Z
published: 2025-05-08T13:10:06Z
canonical: "support.yotpo.com/customizing-your-email"
---

> ## Documentation Index
> Fetch the complete documentation index at: https://support.yotpo.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Customizing Your Review Emails Using the Email Template Editor

Products

  

Reviews

###### Supported plans

Premium, Enterprise

###### eCommerce Platform

Shopify, Shopify Plus, Adobe Commerce (Magento), BigCommerce, WooCommerce, Volusion, Salesforce Commerce Cloud, Custom

Customize Yotpo-generated emails to match the native look and feel of your brand.

## Getting started

To access the Email Template Editor:

1. [**Log in**](https://yap.yotpo.com/) to Yotpo Reviews
2. Go to **Emails > Email Template Editor**

## Customizing email templates

> [!WARNING]
> Please note:
> 
> We strongly recommend proficiency with **HTML and CSS** when customizing email templates. Yotpo Support will be happy to assist with functionality issues related to Yotpo code, however, issues related to the validity and customization of custom code are not supported.

> [!NOTE]
> Interested in having email templates tailor-made for you?
> 
> Reach out to your Yotpo representative to learn more about how our in-house Professional Services team can help you design beautiful on-brand email templates.

To customize your email template:

1. Select the file you want to edit in the list on the left-hand side of the editor.
2. If necessary, expand the **Templates** or **Snippets** list to view a full list of files.
3. Edit the code within the editor workspace according to your requirements.
  - The editor workspace includes in-line syntax validation to automatically highlight code errors and anomalies. **If your code includes errors, you will not be able to preview or save your changes until the errors are resolved.**
4. Changes made within the editor workspace are automatically saved so you can easily switch between template files without losing your work.
5. Each template includes optional placeholders you may use to display dynamic content such as user name, product name, store name, store URL, and header text.
6. Click **Save Changes**.

Once your changes are saved, customization is applied to your live Yotpo-generated emails, and a new template version instance is created.

> [!CAUTION]
> Important:
> 
> The templates and snippets outlined below represent Yotpo's new and improved templates (released in August 2018). As such, your templates may appear differently.
> 
> To get the new templates, you must first reset your templates by clicking the **Reset Templates** button in the upper right-hand corner.
> 
> **Resetting templates will replace all your existing templates and customizations with the latest default files.**

| General Templates | Description |
| --- | --- |
| email_layout.liquid | The email layout |
| custom_overrides.css | Your custom CSS overrides for Yotpo-generated emails |
| yotpo(readonly).css | Yotpo's emails CSS stylesheet |
| brand_logo.liquid | Your brand's logo |
| email_footer.liquid | Appears at the bottom of your email and includes unsubscribe link |
| email_header(readonly).liquid | Text that appears at the top of your emails |
| product_image(readonly).liquid | The product image |
| tracking_pixel(readonly).liquid | Email conversion tracking pixel |
| unsubscribe_section.liquid | Unsubscribe section that appears in the email footer |
| unsupported_email_client.liquid | Directs to landing page form if the in-mail form is not supported by the email client |

> [!CAUTION]
> Important:
> 
> - Read-only files cannot be customized or modified in any way
> - Subject lines cannot be customized for the following emails:
>   - Coupon notification
>   - Site review request
>   - Reviewer verification
>   - Question verification

| Reviews Templates | Description | Subject line |
| --- | --- | --- |
| comment_notification.liquid | Email notification sent when a review is commented on | Can edit |
| manual_product_review_request.liquid | An email requesting a product review | Can edit |
| manual_site_review_request.liquid | An email requesting a site review | Can edit |
| product_review_request_14.liquid | Post-purchase email requesting a product review | Can edit |
| resend_product_review_request.liquid | Resend email requesting a product review | The title can be edited when [clicking the resend button in the Moderation section](/v1/docs/resending-an-automatic-review-request-email) |
| reviewer_verification.liquid | Verification email is sent to the reviewer after they submit their review using on-site widgets, such as the Reviews Widget. | Cannot edit |
| site_review_after_invoice.liquid | A post-invoice email requesting a site review | Can edit |
| site_review_after_service.liquid | Post-service email requesting a site review - (Help Desk Integration) | Can edit |
| site_review_request.liquid | Post-purchase email requesting a site review | Cannot edit |

| Reviews Snippets | Description |
| --- | --- |
| base_choice_custom_field.liquid | Custom field for single-choice radio buttons vs. multiple choice checkboxes |
| custom_review_form_fields(readonly).liquid | Custom review form fields |
| free_text_custom_field.liquid | Custom field for free-text answers (text box) |
| link_to_landing_page_form.liquid | Clickable star rating links to landing page form |
| promoted_products.liquid | Shows promoted products in emails |
| rating_custom_field.liquid | Custom field for rating-related questions (horizontal bars) |
| review_form.liquid | Review form that appears in review request emails |
| review_request(readonly).liquid | Determines whether to display review form in-mail or landing page |
| review_score_input.liquid | Customize the icon of review score input e.g. star-rating |
| size_custom_field.liquid | Custom field for size-related questions (horizontal bars) |

| Coupons Templates | Description | Subject line |
| --- | --- | --- |
| coupon_notification.liquid | "Thank You" email and coupon sent to reviewers after submitting a review **Please note - this template's subject line cannot be customized** | Cannot edit |
| coupon_reminder.liquid | Reminder to claim coupon before coupon expiration | Can edit |

| Coupons Snippets | Description |
| --- | --- |
| coupon_info.liquid | The coupon, expiration date, and link to store |

| Questions & Answers Templates | Description |
| --- | --- |
| answer_notification.liquid | A notification for a customer who wrote a question through the reviews widget that the question has been answered |
| answer_request.liquid | A request from a past shopper to answer another customer’s question regarding the product they had purchased |
| question_verification.liquid | Verification email sent to the reviewer after submitting their question through the widget |

| Questions & Answers Snippets | Description |
| --- | --- |
| answer_form.liquid | The form for the answer request from past shoppers |

## Email template placeholders

Include dynamic placeholders in your email templates and subject lines to improve your open rate with personalized emails. Placeholder values are taken from your [Email Settings](/v1/docs/defining-the-email-settings-for-your-review-requests)

> [!WARNING]
> Please note:
> 
> To edit the subject lines of coupon emails, you must first configure your [coupon settings](/v1/docs/adding-coupons-to-your-review-requests).

| Placeholder | Description |
| --- | --- |
| {{answer_content}} | Your answer |
| {{comment_content}} | Content of the comment |
| {{confirmation_url}} **Required** | The confirmation link |
| {{coupon_code}} | The coupon code |
| {{coupon_discount}} | The coupon discount |
| {{coupon_thank_you}} | The coupon thank you message |
| {{expiration_date}} | The expiration date for the coupon |
| {{landing_page_link}} | Link to a landing page if this email is broken |
| {{link_didnt_get_product_yet}} | Link for customers who haven’t yet received the product. |
| {{order_date}} | The date of the order |
| {{order_id}} | The ID of the order |
| {{product_name}} | The product name |
| {{promoted_products}} | Placeholder for the promoted product section (only added if the feature is enabled) |
| {{question_date}} **Required** | The date the question was asked |
| {{question_content}} **Required** | The content of the question |
| {{store_logo}} | Your store's logo |
| {{store_logo_url}} | The URL of the logo on your store's homepage |
| {{store_name}} | The name of your store |
| {{store_url}} | The URL of your store's website |
| {{url_params}} **Required** | Hidden form fields that are needed for processing |
| {{user}} | The reviewer's full name. To display only the first name and first letter of the last name, replace {{user}} with: {{user \| truncatewords: 1, "" }} This will display as such: e.g. John S., Sally M., etc. **Note:** First names comprised of two names will appear truncated as well. For example, "Anna Marie Jones" will be shown as "Anna M." |
| {{verification_link}} **Required** | The verification link |
| {{product_picture_url}} | Reviewed Product Image in high quality/ dimensions |
| {{product_picture_thumb_url}} | Reviewed Product Image in small dimensions (thumbnail size). Can be used to prevent the image from expanding to its original size in Outlook |

## Previewing emails

To preview email templates:

1. Click **Preview**
  1. Your template file appears in a new browser tab

> [!WARNING]
> Please note:
> 
> If your code includes errors, you will not be able to **preview or save your changes** until the errors are resolved

## Test emails

In addition to previewing emails in your browser, we strongly recommend sending a few test emails to ensure optimal compatibility across devices and email clients. We recommend testing emails on email clients like Gmail, Outlook, etc. as well as testing responsiveness on mobile devices and tablets.

## Email template file versioning

Click the **Browse Versions** dropdown to quickly roll back to previously saved template versions or revert to the original default template.

To load a previous template:

1. Click the **Browse Versions** dropdown
2. Select the relevant template file
3. Click **Default Version** to restore the template to the original default template
4. Don't forget to click **Save Changes** when you're ready to apply your changes to live emails

## Reset templates

> [!WARNING]
> Please note:
> 
> - Resetting templates will **replace all your existing templates and customizations** with the latest default files.
> - When resetting the editor, template names may change. Make sure to **update the template names** where relevant

To reset all templates:

1. Click **Reset Templates** in the upper right-hand corner. Please note that resetting templates is not available for all accounts. If you can't see the button, please contact your Yotpo representative.
2. Click **Reset Now**