Editing mail notifications
Email notifications are messages sent to store owners and customers to inform users of various events that happen in the store: an order is placed, order status changes, a product’s stock is getting low, etc. Apart from transactional emails, your store can also send automated marketing emails that timely remind customers of your business and nudge them to purchase from you.
All the emails have universal ready-to-go texts, which can fit any business. You can use them straight away or customize their texts and appearance. It is possible to brand the emails with your business-specific colors, rework their layouts, remove or add text blocks, etc.
Each email notification has its own template which you can edit in your Ecwid admin, Settings → Mail.
Understanding email templates
Each admin or customer email notification has its own template. When an email is sent, the email template is filled in with the info from your store settings (store name, contact info, store link, etc.) and from the order details (customer’s name, shipping address, list of products bought, etc.) Thus, each email sent from your store is individual and contains all the information about a particular order and customer.
Here is an example of an abandoned cart recovery email that’s sent to a customer who doesn’t complete an order and leaves items in their cart. The customer will see the email this way:
The template for this email in the Ecwid admin looks like this:
You can make small changes like adding a coupon code or a message about an upcoming sale without any knowledge of coding. The easiest way to edit the template is to add text – you can add a custom text instead of the plain text that displays in black in the template.
More serious changes, like changing the design and the layout of the template, will require the knowledge of HTML and Freemarker.
Let’s dive deep into understanding the different parts of an email template and how to edit them: plain texts, variables, and markups.
Message keys
If you open an automated marketing email for editing, you will see that there are actually no texts. Instead, you can see such text labels as <@rosetta.message key="FeedbackRequest.subject" />, <@rosetta.message key="FeedbackRequest.text" />, etc. When an actual email is sent, these rosetta message keys are replaced with texts. You can see an email with default texts if you click Preview template.
To add a custom text instead of the default one, you need to find the necessary rosetta label (its name is usually self-explanatory) and replace the whole rosetta label with your text, then preview the result and save the changes:
Favorite Products Reminder email template
Plain text
Some email templates may contain texts in black which is plain text. Text here is sent in the emails in exactly the same way as you see it in the template.
You can easily edit plain texts (that you see in black) in the templates: simply edit or remove the text. For example, if you sell customized products, you can replace “will process it shortly” in the order confirmation template with something like “your order will be processed within a week.” Also, if you want to inform customers about ongoing promos or sales, you can add a message about it near the black text — that’s the easiest way to add custom messages to email templates:
Order confirmation email template
Editing text in the “Abandoned Cart Recovery” email template is even easier as its plain text is presented in a special area of the template. You can type your message in the “Default message for customers” area. For example, you can include a coupon code in recovery emails to encourage customers to complete the purchase.
Variables
Variables are placeholders that are replaced in the email with the actual information from either the order details (customer’s name, list of products, etc.) or from the store info (store name, contact info, etc.). For example, you can see variables like ${store.name} or ${customer.name}. As you can guess by their names, they will be replaced in email notifications with the store name taken from your store profile settings and with the customer’s name taken from the order details.
See the list of variables used in the email templates.
Markup
The text in blue, green and red is called markup. These are rules that tell the email client how to display the text in the email: font color, size, padding, etc. You can change the markup rules if you want to change the layout and the design of your email.
Changing company info in emails
The company info (store name, store link, physical address, etc.) that you see in email notifications is taken from your store settings.
Company info in the order confirmation email template
To change or update the company info displayed in emails:
- From your Ecwid admin, go to Settings → General → Store Profile
- Edit your company details.
- Save the changes.
After you save the changes, the updated info will display in new email notifications.
Adding a logo to emails
To upload or change a logo in your mail notifications:
- From your Ecwid admin, go to Settings → Mail.
- Scroll down to the bottom of the page to Your logo for mail notifications.
- Click Upload logo.
- Upload your store logo and save the changes.
This logo will be used in all customer notifications.
Changing your email notification language
When you create a new Ecwid account, the language used in your email notification templates is the same as the language of your Control Panel. That means that plain texts, order payment and fulfillment states, etc. in email notifications for you and your customers will be in this language. Product details, your company address, and the customer’s info will also be in this same language.
If you use your Ecwid admin in a language that email notifications are not translated into yet, they will be translated into English — that’s the default language.
You can change the language of your email notifications at anytime. For example, if your customers are from Italy, but you prefer viewing the Ecwid admin in English, you can set Italian for emails and keep using the admin in English.
In Ecwid, email notification templates can be translated into:
- English
- Russian
- German
- French
- Italian
- Spanish
- Portuguese
- Dutch
- Danish
- Finnish
- Norwegian
- Swedish
- Polish
- Estonian
- Hungarian
- Romanian
- Slovenian
- Turkish
- Vietnamese
- Indonesian
- Macedonian
To change the language of your email notifications:
- From your Ecwid admin, go to Settings → Mail.
- Click Edit next to the notification that you want to change the language of.
- Switch the language in your Ecwid Control Panel: click on the Language drop-down at the bottom of any page and choose the language in which you want notifications to be sent.
- (If you are using the default email template): Make any change in the template, e.g. add a blank space.
(If you are using a custom email template): Click Revert to default link at the bottom of the template. Your previous edits to the template will be lost. You can add them after you save the template in the new language. - Click Save.
Repeat these steps for all the email templates you want to change the language of. After that, customers will always get emails in the language that you set.
Editing notification template
To add custom messages to the email template or to customize it in any other way, you should edit its template. Email templates use variables to refer to the store or customer information - you can remove, edit, or add variables that are supported in emails. Ecwid uses Freemarker to replace variables with actual values and for their conditional rendering while HTML tags define the structure of the email templates and how they look in inboxes.
To edit an email template:
- From your Ecwid admin, go to Settings → Mail.
- Click Edit next to the template you want to change.
- In the HTML template, make the desired changes.
- Before saving any changes, click the Preview template link on top to see what the email will look like.
- If you don’t like the result, click the Revert to default link at the bottom of the template to restore the default email template.
- Once you are satisfied with the result, click Save.
To check how email notifications will look with your changes, place a test order in your store. A test order is the best way to test email template changes as the preview shows demo products and data. Use your real email address at checkout as this is where the email will be sent. You should also change the order payment and fulfillment status in the control panel to receive a preview of different email notifications (order status changed, order shipped, etc.).
Examples of template modifications
Example 1. If you’ve specified your company phone number in the store settings, this number is included into Order Confirmation emails by default via the ${store.officeAddress.phone} variable. In case you want to remove your phone number from Order Confirmations sent to your customers while keeping it in the store settings, delete the following piece of code from the Order Confirmation template:
<#if (store.officeAddress.phone)?has_content>
or call <b>${store.officeAddress.phone}</b></#if>
After that, the phone number won’t be displayed in Order Confirmations sent by your store to buyers.
Example 2. If you want to show another company address in emails (not the one that you specified in your store profile), you can replace the ${store.officeAddress} variable with the address that you want to show in emails by adding the latter as a plain text.
Example 3. If you need to specify a list of elements in a template, use this construction:
<#list order.items as orderItem>
${orderItem.name}
</#list>
Translating email notifications into a new language
In Ecwid, email templates are translated into more than 20 languages. If you don’t see the language that you want to use for emails, you can add your own custom translation for mail notifications.
To translate mail notifications into a new language:
- From your Ecwid admin, go to Settings → Mail.
- Click Edit next to the notification that you want to translate.
- Translate the plain text that you see in black to the desired language.
- Add translations for order statuses. These are set by variables in the email template. Find the following variables:
Order payment statuses:
${order.paymentStatus}
Order fulfillment statuses:
${order.fulfillmentStatus} - Replace them with the following translation code where you add your translation. Here is an example of the code for translation into Portuguese:
Order payment statuses:
<#if order.paymentStatus = 'Paid'> Pago
<#elseif order.paymentStatus = 'Awaiting Payment'> Aguardando Pagamento
<#elseif order.paymentStatus = 'Cancelled'> Cancelado
<#elseif order.paymentStatus = 'Refunded'> Reembolsado
</#if>
Order fulfillment statuses:
<#if order.fulfillmentStatus = 'Processing'> Processando
<#elseif order.fulfillmentStatus = 'Awaiting processing'> Aguardando Processamento
<#elseif order.fulfillmentStatus = 'Shipped'> Enviado
<#elseif order.fulfillmentStatus = 'Delivered'> Entregue
<#elseif order.fulfillmentStatus = 'Will not deliver'> Não será entregue
<#elseif order.fulfillmentStatus = 'Returned'> Devolvido
</#if> - Save the changes.
After that, customers will get email notifications in the language that you’ve translated them into.