Shopify Guides

Mastering Shopify Email Notifications: Customize Your Return Approved Emails with Liquid

As a Shopify store owner, you know that effective communication is the backbone of a great customer experience. This is especially true when it comes to post-purchase interactions, like returns. A clear, informative "Return Approved" email can turn a potentially frustrating situation into a smooth, trust-building experience. However, customizing these essential notifications in Shopify can sometimes feel like navigating a labyrinth.

Recently, a common challenge surfaced in the Shopify Community forums, perfectly illustrating this point. A store owner, 'offroadjim', was trying to achieve a seemingly simple goal: display the actual order number within the return information section of their "Return Approved" email. Despite the order number already appearing elsewhere in the email, a generic "Return #####" placeholder stubbornly remained in the desired spot. As 'offroadjim' candidly shared, they "spent hours today trying to figure it out." This scenario is incredibly common, highlighting a specific nuance of Shopify's email template system that many merchants encounter.

Editing Shopify 'Return Approved' email template to display order number using Liquid.
Editing Shopify 'Return Approved' email template to display order number using Liquid.

The "Why" Behind the Head-Scratcher: Liquid Variables in Email vs. Theme

The core of 'offroadjim's' dilemma, and indeed many Shopify email customization challenges, lies in a critical distinction articulated by 'gracetech1' in the forum thread: "Shopify’s notification templates can be a little confusing at first since they use separate Liquid variables from the actual theme files."

For those unfamiliar, Liquid is Shopify's open-source template language, used to load dynamic content into your storefront and emails. While you might be adept at using Liquid variables to customize your product pages or collection layouts (e.g., {{ product.title }}), the set of available objects and properties in email notification templates often differs. Email templates operate within a specific context, meaning they have access to a distinct set of data related to the order, customer, or return event itself, rather than the broader store or product catalog data available to your theme.

Understanding this distinction is not just helpful; it's essential. It means that a variable you might expect to work from your theme's product.liquid file might not be available or might have a different name in your order_confirmation.liquid or return_approved.liquid email template. This is precisely why 'offroadjim' was seeing {{ order.name }} at the top of the email, but needed a specific fix for the body.

Putting the Order Number Where It Belongs: A Step-by-Step Guide

Let's walk through how to implement the solution provided by the community experts, 'PaulMartin_1' and 'gracetech1', to dynamically display the order number in your "Return Approved" email. This method ensures consistency and clarity for your customers.

Step 1: Access Your Email Notification Templates

  1. From your Shopify admin, go to Settings > Notifications.
  2. Scroll down to the Customer notifications section.
  3. Find and click on Return approved. This will open the Liquid template editor for that specific email.

Step 2: Locate the Placeholder Text

Within the Liquid code, you'll need to find the specific line containing the placeholder. In 'offroadjim's' case, it was:

Return #####

This line was nested within a larger paragraph block:

Below is the return information for you.

Please include a copy of this e-mail in with the return and use a trackable shipping method (e.g., UPS Ground).

Return #####

Our return policy can be found in the following section of our website.

pages/atlantic-jet-sports-return-and-exchange-policy

Please pack the return well so that nothing is damaged in shipping.

****** IMPORTANT: Please do not place address labels on the item box or package. If the box that the item came in is defaced, it can not be returned.

Step 3: Replace with the Correct Liquid Variable

The solution is to replace the static placeholder with the dynamic Liquid variable for the order name. The most common and effective variable for this is {{ order.name }}.

Change this:

Return #####

To this:

Return {{ order.name }}

So, the full section would look like this:

Below is the return information for you.

Please include a copy of this e-mail in with the return and use a trackable shipping method (e.g., UPS Ground).

Return {{ order.name }}

Our return policy can be found in the following section of our website.

pages/atlantic-jet-sports-return-and-exchange-policy

Please pack the return well so that nothing is damaged in shipping.

****** IMPORTANT: Please do not place address labels on the item box or package. If the box that the item came in is defaced, it can not be returned.

Step 4: Test Your Changes Thoroughly

This is a crucial step! Shopify provides a "Send test email" button within the notification editor. Always use this feature to send a test email to yourself and verify that the order number appears correctly in the desired location. As 'gracetech1' wisely noted, "One thing to watch though is that some return notification templates use return.name instead of order.name depending on how the return was created, so it may be worth testing both variables in preview mode." If {{ order.name }} doesn't work, try {{ return.name }}.

Why Clear Return Notifications Boost Customer Trust and Efficiency

Beyond simply fixing a placeholder, ensuring your "Return Approved" email is accurate and comprehensive offers several significant benefits for your e-commerce business:

  • Enhanced Customer Experience: Providing all necessary information, including the order number, upfront reduces confusion and stress for your customers during the return process. This fosters a sense of transparency and reliability.
  • Reduced Customer Service Inquiries: When customers have all the details they need, they are less likely to contact your support team with basic questions about their return, freeing up your staff to handle more complex issues.
  • Brand Consistency: Customized emails that align with your brand's voice and visual identity reinforce professionalism and attention to detail across all customer touchpoints.
  • Streamlined Operations: Clear instructions and readily available order numbers help both your customers and your internal team process returns more efficiently, minimizing errors and delays.
  • Building Trust: A smooth, well-communicated return process can significantly impact customer loyalty. Even if a customer is returning an item, a positive experience can encourage them to shop with you again in the future.

Best Practices for Shopify Email Customization

As you venture into customizing more of your Shopify email notifications, keep these best practices in mind:

  • Always Backup: Before making any significant changes, copy and paste the original template code into a text editor or document. This way, you can easily revert if something goes wrong.
  • Understand Liquid Syntax: Familiarize yourself with basic Liquid syntax, including variables, objects, and control flow tags (if, else, endif). Shopify's Liquid documentation is an excellent resource.
  • Test, Test, Test: Always send test emails to various email clients (Gmail, Outlook, Apple Mail) to ensure your changes render correctly and look good across different platforms.
  • Keep it Simple: While customization is powerful, avoid over-complicating your email templates. Focus on clarity and essential information.
  • Consider Professional Help: If you're dealing with complex Liquid logic, integrations, or simply don't have the time, don't hesitate to reach out to Shopify experts or agencies like Shopping Cart Mover. We specialize in Shopify store setup, optimization, and migrations, and can assist with intricate customizations.

Customizing your Shopify email notifications, like the "Return Approved" email, is a small but impactful way to enhance your store's professionalism and customer experience. By understanding the nuances of Liquid variables in email templates and following a systematic approach, you can ensure your communications are always clear, accurate, and on-brand. Don't let a simple placeholder cost you hours of frustration – empower your emails with dynamic data!

If you're looking to optimize your Shopify store further, streamline your operations, or need expert assistance with migrations and complex customizations, the team at Shopping Cart Mover is here to help. Visit shoping-cart-mover.com to learn more about our services.

Share:

Use cases

Explore use cases

Agencies, store owners, enterprise — find the migration path that fits.

Explore use cases