How to design an email template
A template is the design of a mailing email: its subject, the text the inbox shows next to the subject, and the body, with variables that are filled in with each recipient’s details. The body is written in one of three ways: as a normal email, with blocks you drag in (texts, images, buttons, catalogue items…) or by pasting the HTML code of an email made in another tool. You design it in Mailing → Templates, and what you see in Preview and test is exactly what will be sent.
What do I need before I start?
- Permission on Templates in mailing: to see them, view permission is enough; to create or change them you need permission to add or edit.
- To send a test, a sender set up in Mailing → Senders: the test goes out through your company’s email account, just like real newsletters.
Which templates come with the program?
Eight factory templates:
- Designed with blocks: Newsletter, Item offer and Notice, which are sales templates; Invoice email, which is a document template; and Subscription confirmation, the one for the email that asks for consent (double opt-in).
- Written with the text editor, the easiest to change: Simple newsletter, News item and Offer (they are covered in the three ways to write an email).
They appear on their own the first time you go into Templates. The list shows How it’s made for each one: designed with blocks, written with the editor or in HTML code.
A factory template cannot be changed: you open it, look at it in the preview and press Duplicate. The copy is yours, it is called ‘Copy of…’ and you design it like any other. That way the factory one is still there as a starting point.
What is the difference between a sales template and a document template?
- Sales: newsletters, offers, notices. They always include the unsubscribe link and respect the unsubscribes and consent of each address.
- Document: the email that goes with an invoice, a delivery note or a quote. It has the document variables (number, date, total, due date) and has no unsubscribe link, because it is email about your relationship with your customer.
The type is chosen in the template header. When you change it, the variables and blocks on offer change, and the template warns you about anything that is no longer valid in the new type.
How do I create a template?
- In Templates, press New template.
- Type the Name (only you see it) and the Subject (what is read in the inbox).
- If you want, type the Preview text: the sentence many inboxes show next to the subject before the email is opened.
- In the Design tab, choose under How do you want to write it?: Write, Design with blocks or Paste HTML code.
- Write or design the body. With blocks, drag them from the panel on the right and double-click a text to write in it.
- Press Save.
A new template starts with blocks: a header with your logo, a greeting with the recipient’s name, a text and the legal footer. Change them, delete them or add whatever you need. If you switch to Write before touching it, it starts with the greeting and one line. How to write an email without blocks and how to paste one made in another tool is in the three ways to write an email.
AI can help you with the subject and the texts: Suggest subject proposes three subjects with their preview text and Write with AI writes a text block with whatever you ask for. This is covered in AI in the template designer.
What blocks are there?
In the Blocks panel of the design, when the template is designed with blocks:
| Block | What it is for |
|---|---|
| 1 column, 2 columns, 3 columns | A strip of the email; the texts, images and buttons go inside each column |
| Text | A paragraph. Double-click to write; it allows bold, italics and links |
| Image | A photo or a graphic (see how to upload images) |
| Button | A highlighted link (‘See offers’). Its address is written in the block settings |
| Divider and Spacer | A line and a gap, to organise the email |
| Social networks | Icons linking to your social networks; the address of each one goes in its settings |
| Header with logo | Your company’s logo centred, or its name if it has no logo: these are two elements, each with its own condition |
| Greeting | ‘Hello’ with the recipient’s name, and ‘customer’ if there is none |
| Catalogue item | The photo, name and price of an item (sales templates only) |
| Document | Type, number, date, total and due date of the document (document templates only) |
| Legal footer | Your company’s details and, in sales templates, the unsubscribe and preferences links |
Once you drop a block you can select it and move it with the mouse, copy it or delete it with the buttons that appear above it. Undo and Redo are in the top bar of the design.
How do I add the customer’s name or any other detail?
With a variable: a detail the program fills in on each email with that recipient’s own. In the design it appears as a pill with its name —‘Contact name’—, and the email shows ‘Ana López’ in Ana’s and ‘Luis Pérez’ in Luis’s.
- Double-click the text in the design where you want it and leave the cursor in place.
- In the Insert variable bar, click the detail (by group: Contact, Customer, Your company, Links…). Hovering over it tells you what it inserts and gives an example.
The pill is a single piece: typing around it does not break it, and it is deleted whole with the delete key. If it has a default text for anyone who does not have the detail, it says so: ‘Contact name (or ‘customer’)’.
Link variables (Unsubscribe, Preferences, View in browser, Web) go in as a link: if you had a word selected, that word becomes the link.
An image whose address is a detail (your company’s Logo, an item’s photo) appears in the design as a sample image, ‘Image from a field’: the real one is added when sending. In the preview the real one is already shown.
How do I make something appear only if there is a detail?
Every element of the design —a section, a column, a text, an image, a button— can have a condition:
- Click the element to select it.
- Open the Settings in the right-hand panel (the slider controls icon).
- In Show only if, choose the detail; in The field, whether it must have a value or be empty.
In the design, anything with a condition has a dashed amber border and, when you hover over it, it says what the condition is. To remove it, choose Always (no condition). The template header already includes an example: the logo has ‘only if there is Your company’s logo’ and the name, ‘only if there isn’t’.
A piece inside a text can also have a condition (for example, ‘or call us on…’ only if there is a phone number): it is shown with an amber background and dotted underline, and hovering over it shows the condition.
In the Subject and the Preview text, the + variable drop-down on their right adds it at the end. What each variable means, how to set a default text for anyone without the detail and which ones a document template has is covered in the variables of a template.
How do I add a catalogue item?
- Drag the Catalogue item block to the place in the email where you want it.
- In the Which catalogue item? window, search by code or name and choose the item.
The block shows the item’s main photo, its name and its sales price including VAT. Those details are read from the record when each email is sent: if you change the item’s price, the next newsletter goes out with the new price. In the design the block is shown with its pills (‘Item name A001’, ‘Item price A001’) and a sample image, which only appears if the item has a photo; in the preview, with the details from the record.
How do I upload an image?
- Drag in an Image block (or double-click an image that is already in the design).
- In the Select image window, drag the file into the box or click it to browse for it.
- Click the uploaded image to put it in the block.
JPG, PNG and GIF are accepted. These are the formats all email programs display; a WebP image, for example, is not shown by Outlook. For an email, 600 pixels wide is enough.
If a JPG or PNG is over 1 MB, it is saved smaller (1200 pixels wide) and you are told. A GIF over 1 MB or any image over 8 MB is not uploaded.
The image is stored in your installation and the email carries it by its address, not inside the message: that way the email is light and arrives complete. You can also use the address of an image that is already on the internet: type it in the box at the top of the window and press Add image.
How do I know if the template is correct?
Below the header, the template tells you its state every time you change something:
- The template is correct and how much the email weighs.
- In red, the errors, with the line of the template where they are: a variable that does not exist or is not valid in that type of template, an image embedded in the email, a misplaced block, a mark from another tool in a pasted email. With errors the template is still saved: what you cannot do is send it until there are none left (see Can I leave a template half-finished?).
- In amber, the warnings: they are worth reading, but they do not stop anything from being sent. For example, an email over 90 KB (Gmail cuts emails over 102 KB and hides the end, which is where the unsubscribe link goes), or what will be removed from a pasted email when it is sent.
If the error can be fixed automatically, its button appears below: Upload the embedded images or Treat as text. They are explained in the three ways to write an email.
Can I leave a template half-finished?
Yes. Laying out an email takes time, and the work you have done is not lost because you do not finish it that day: press Save and tomorrow you open it where you left it, with its errors in red just as they were.
The only things needed to save it are what identifies it: the name (which you use to find it again) and the subject. The body can stay as it is.
What you cannot do with a half-finished template is send it:
- Send test refuses and says there are errors.
- A newsletter based on it takes those same errors with it, and cannot be launched while any remain.
- The same applies if an automatic send chooses it (a document by email, a subscription confirmation): it stops and says which template it is and what it is missing.
Just as with saving the template, Duplicate works even if it is half-finished: the copy starts with the same content.
What is the preview and how do I use it?
The Preview and test tab shows the email exactly as the recipient will receive it: with the variables already filled in, adapted to mobile and with the legal footer if needed. It is not drawn by the design: it is put together by the same engine that sends the emails.
- Empty data: the email of someone you know nothing about. Useful for checking the default texts (‘Hello customer’).
- A customer…: the email with the details of one of your customers, whom you choose in the search window.
- A document… (document templates only): the email with a real invoice, delivery note or quote, from any financial year, which you search for by its number or its customer. Its number, date, total and due date appear, along with its customer’s details. With Add another document… you can see several, like an email that groups a customer’s invoices: the first one fills in the document variables and all of them appear in the list. Each chosen document is removed with its cross.
- The computer icon and the mobile icon change the width, so you can see how it looks on each screen.
- Refresh puts it together again with the latest changes you have made.
The unsubscribe and preferences links have their real form in the preview, but they do not lead anywhere.
How do I send myself a test?
- In Preview and test, type your address in Send a test to.
- If your company has several senders, choose which one it goes out through.
- Press Send test.
The test arrives with [Test] before the subject and with empty data. Its unsubscribe links do not unsubscribe anyone. A template with errors is not sent.
Why does the email always have a legal footer?
Because the law requires it for every commercial email: it has to say who is sending it (your company’s name, Tax ID (NIF) and address) and offer a simple way to unsubscribe. If your sales template already has the Legal footer block (or a link with the unsubscribe variable), the email goes out as it is. If it does not, the program adds a footer with your details and the unsubscribe link at the end of each email, and the template warns you.
Document templates do not have an unsubscribe link: an invoice is sent even if its recipient does not want advertising.
Can I change a template while someone else has it open?
Yes, but only the first save is kept. If someone else saved the template while you were editing it, when you press Save it tells you and does not overwrite their changes: open it again to see how it has ended up. If you want to keep your version, press Duplicate first: the copy has exactly what you see on screen.
If something goes wrong
| What you see | What is happening | What to do |
|---|---|---|
| ‘Double-click a text in the design…’ when you click a variable | No text was open for writing | Double-click the text, put the cursor in place and click the variable again |
| An element with a dashed amber border | It has a condition: it only appears if the condition is met | Select it and look at Show only if in the Settings |
| Yellow pills (‘If there is…’, ‘End’) in a text | An older or copied template with conditions written by hand in the middle of the text | They work the same. To make it clearer, put that piece in its own text and give it the condition in Settings |
| An error in red with a line | The template has something that cannot be sent (you can still save it) | Read the message: it says which variable or block it is |
| The image does not upload | It is not JPG, PNG or GIF, it is a GIF over 1 MB, or it is over 8 MB | Save it in another format or smaller |
| ‘There’s no active sender…’ when sending the test | The company has no sending account | Set up a sender in Mailing → Senders |
| You cannot change anything in the template | It is a factory template, or you do not have permission to edit | Press Duplicate, or ask for the permission |
What you can put in a template, variable by variable, is in the variables of a template. Who receives each newsletter and why it does not reach someone, in the mailing index.
More about Mailing
- Newsletters and lists from your customers, suppliers and contacts
- Mailing campaigns
- Consent and legal basis of each address
- Newsletter control: progress, pausing, resuming and cancelling
- Managing mailing addresses
- The ERP sending service: sending your newsletters without your own email account
- Sending invoices and other documents by email
- Importing mailing addresses from a file
- Mailing: newsletters, lists and who you can write to
- The quality of an email address
- Mailing settings: quality, consent, tracking and retention
- Asking for consent by email: double opt-in