The Email Template Editor - General Guide

Userlevel 4
Badge +3

The Email Template Editor allows the user to edit and customize Yotpo emails that are being sent out to the customers. 

1. A List of Templates Available for Editing

General Templates

Editing these templates will affect all email types

  • Email_layout.liquid - The email layout - the outermost template in the editor
  • Custom_overrides.css - File for CSS overrides, this is where we write our CSS
  • Custom_media_queries.css - media query overrides file to ensure mobile responsiveness 
  • yotpo(readonly).css - Yotpo's default CSS stylesheet - not editable
  • Brand_logo.liquid - The brand's logo
  • Email_footer.liquid - Appears at the bottom of the email and includes unsubscribe link 
  • Email_header(readonly).liquid - Text that appears at the top of the emails 
  • Product_image(readonly).liquid - The product image (for product review requests)
  • Tracking_pixel(readonly).liquid - Email conversion tracking pixel
  • Unsubscribe_section.liquid - Unsubscribe section that appears in the email footer
  • Unsupported_email_client.liquid - Link that redirects to landing page form if the in-mail form is not supported by the email client

Reviews Templates

  • Comment_notification.liquid - Email notification sent when a review is commented on by store owner
  • Manual_product_review_request.liquid - Manual email requesting a product review
  • Manual_site_review_request.liquid - Manual email requesting a site review
  • Product_review_request_x.liquid - Automatic post-purchase email requesting a product review 
  • Resend_product_review_request.liquid - Resend email requesting a product review
  • Reviewer_verification.liquid - Verification email sent to the reviewer after submitting their review through the widget
  • Site_review_after_invoice.liquid - Post-invoice email requesting a site review
  • Site_review_after_service.liquid - Post-service email requesting a site review (Help Desk Integration)
  • Site_review_request.liquid - Automatic post-purchase email requesting a site review

Reviews Snippets

  • Base_choice_custom_field.liquid - Custom field for single-choice and multiple choice customer related questions
  • Custom_review_form_fields(readonly).liquid - General template for all custom 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 (Outlook/mobile/formless)
  • Promoted_products.liquid - Promoted Products section (populates automatically)
  • Rating_custom_field.liquid - Custom field for rating (1-5) product related questions (horizontal bars)
  • Review_form.liquid - Review form that appears in review request emails (both site and product)
  • Review_request(readonly).liquid - Determines whether to display review form in-mail or landing page form.
  • Review_score_input.liquid - Customize icon of review score input e.g. star-rating
  • Size_custom_field.liquid - Custom field for fit product related questions (horizontal bars)

Coupon Templates

  • Coupon_notification.liquid - “Thank You" email and coupon sent to reviewers after submitting a review
  • Coupon_reminder.liquid - Reminder to claim coupon before coupon expiration

Coupon Snippets

  • Coupon_info.liquid - The coupon, expiration date, and link to store

Questions & Answers Templates

  • 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

  • Answer_form.liquid - the form for the answer request from past shoppers.

2. Email Template Placeholders

dynamic placeholders that can be added to the templates. 


Note that not all placeholders are available in all templates - make sure to use the right ones.   

List of placeholders

  • {{answer_content}} - content of answer given by either store owner or another shopper.
  • {{comment_content}} - content of comment given by store owner on the customer’s review
  • {{confirmation_url}} - url for confirming email address after leaving a question onsite. 
  • {{coupon_code}} - code in the coupon form to be used by the customer as set in the coupon setup
  • {{coupon_discount}} - the amount of discount as set in the coupon setup
  • {{coupon_thank_you}} - coupon email text as set in the coupon setup
  • {{expiration_date}} - the date in which the coupon expires as set in the coupon setup
  • {{landing_page_link}} - link to a landing page that is equivalent to the email
  • {{link_didnt_get_product_yet}} - a link the customer can click, which notifies the store owner that they have not received their product. 
  • {{order_date}} - the date in which the order was placed.
  • {{order_id}} - the order’s id
  • {{product_name}} - name of the product that was purchased
  • {{promoted_products}} - links to the promoted products as set in the promoted products setup
  • {{question_date}} (required) date in which question was posted.
  • {{question_content}} (required) content of the question that was asked by the customer onsite
  • {{store_logo}} - link to the image of the store’s logo
  • {{store_logo_url}} - the url to which clicking the store’s logo will lead
  • {{store_name}} - the name of the store. 
  • {{store_url}} - link to the store’s site.
  • {{url_params}} (required)
  • {{user}}/{{ user_name }} - name of the customer
  • {{verification_link}} (required) url for confirming email address after leaving a review onsite. 
  • {{product_picture_url}} - link to the product picture
  • {{product_picture_thumb_url}} - thumbnail for when there is no picture 

3. Email Subject Line

for some emails you can edit the subject line directly in the editor. Once you click the subject line, it will open a dropdown with the list of parameters you can use. Other than that you can use any text or emoji.

4. Testing and Versioning

This is where you can preview test and revert any changes made. 

  • Preview - when you are in a template for one of the emails (not a snippet) you can preview that email. Clicking the Preview button will open the email in a new tab. This is very useful for small changes, but at some point it is important to also test emails in your Inbox and/or Litmus, since the preview does not take into account email client limitations.
  • Test Email - clicking the Test Email button will open a text box to enter an email address, and will send a test email to that address. This is important to view any possible differences between the preview and an actual email.
  • Browse Versions - This enables you to revert changes for a certain template up to 5 versions back. Any saved version will be added here. 
  • Save Changes - saves the changes to a specific template being worked on. 

Error Handling

The Editor Can Handle 2 types of errors:
1. Syntax Errors - errors in the relevant language (liquid/html/CSS) - There are different markers to alert to these types of errors. Additionally, if such error is made, the preview, test and save buttons become disabled

2. Logical Errors - These are errors that are only detected during compilation - the email fails to compile. This can happen, for example, if we use a placeholder in the wrong place. In that case, the preview, test and save buttons are not disabled, but if we click one of them we will get the following message the indicates where and what the error is.

2 replies

Userlevel 2

Thank you for sharing! 😊

Userlevel 6
Badge +4

Thank you for sharing! 😊


Thank you for being an active Yotpo Community member! 😊