# Email Templates

## <span style="color: rgb(245, 89, 64);">**Overview**</span>

We take immense pride in a standout feature – the Email Template Creation capability. This feature empowers you to craft a limitless array of personalised and pre-designed templates, which are invaluable for sending notifications to your customers regarding their shipments via Voila .

This document is your comprehensive guide to the suite of tools for crafting bespoke email templates. In essence, we'll walk you through creating an email template and demonstrate how to incorporate text, images, GIFs, HTML code, and more into your templates.

### <span style="color: rgb(245, 89, 64);">**Accessing the Email Templates Page**</span>

To access the Email Templates page, click the "Notification" button in the left-hand menu and then choose the "Email Templates" tab from the top-right corner of the page.

<video controls="controls" height="489" src="https://shipping-documentation.despatchcloud.app/attachments/238?open=true" style="width: 869px; height: 489px;" width="869"></video>

<p class="callout info">**Click to Play or Pause the Video**</p>

### <span style="color: rgb(245, 89, 64);">**Creating a Template**</span>

To initiate the creation of a new template, click on the "Create Template" button in the top-right corner of the page. This action will lead you to a fresh, blank template page. Your initial step should be naming your template, which can be done through the page's top-left corner.

<video controls="controls" height="432" src="https://shipping-documentation.despatchcloud.app/attachments/239?open=true" style="width: 856px; height: 432px;" width="856"></video>

<p class="callout info">**Click to Play or Pause the Video**</p>

### <span style="color: rgb(245, 89, 64);">**Variables &amp; Usage**</span>

You'll access a JSON-structured list of variables by clicking the "Variables &amp; Usage" button, conveniently located next to the naming field. This functionality enables you to incorporate shipment data seamlessly into your template content by inserting these variables. For practical guidance on utilising variables and implementing loops, refer to the provided examples in the "Usage" tab.

- **Example Variable:**
    - `Your Tracking Code with {$courier} is {$trackingCode}. It will arrive at {$shipment->ship_to->postcode}.`

- **Example Loop:**
    - `{foreach $items as $item}    You ordered {$item->quantity} of {$item->description}{/foreach}`

It's important to note that we employ Smarty 3 as the template engine for this process. For a more in-depth understanding, you can find further details in the [Smarty 3 Documentation](https://www.smarty.net/docs/en/).

<video controls="controls" height="433" src="https://shipping-documentation.despatchcloud.app/attachments/240?open=true" style="width: 841px; height: 433px;" width="841"></video>

<p class="callout info">**Click to Play or Pause the Video**</p>

### <span style="color: rgb(245, 89, 64);">**Email Editor**</span>

<span data-preserver-spaces="true">Observing the multitude of tools and elements available on the right-hand side of the page, it becomes evident that these resources are instrumental in simplifying crafting your email content. Let's delve into how to harness these tools to construct your preferred template.</span>

<span data-preserver-spaces="true">You have two options for utilising these elements:</span>

1. **<span data-preserver-spaces="true">Drag &amp; Drop:</span>**<span data-preserver-spaces="true"> You can drag and drop one of the elements from the "Content" section into the blue box.</span>
2. **<span data-preserver-spaces="true">Select &amp; Add:</span>**<span data-preserver-spaces="true"> Alternatively, click the blue box and choose the desired element from the available options.</span>

<video controls="controls" height="467" src="https://shipping-documentation.despatchcloud.app/attachments/242?open=true" style="width: 830px; height: 467px;" width="830"></video>

<p class="callout info">**Click to Play or Pause the Video**</p>

### <span style="color: rgb(245, 89, 64);">**Content**</span>

<span data-preserver-spaces="true">The "Content" section comprises two categories: "Basic" and "Pre-made" blocks, each offering various elements for crafting your email templates.</span>

**<span data-preserver-spaces="true">Basic:</span>**

- **<span data-preserver-spaces="true">Text:</span>**<span data-preserver-spaces="true"> This element adds a text box to your template, enabling text input and editing via the tools displayed atop the text box and within the right-hand "Content" section.</span>
- **<span data-preserver-spaces="true">Image:</span>**<span data-preserver-spaces="true"> You can incorporate images into your email template using this element. After adding it, customise the image box by uploading it from your computer or selecting a free stock image from Pexels. Options include creating folders, selecting and deleting images in the file manager, and additional settings in the "Content" section.</span>
- **<span data-preserver-spaces="true">GIF:</span>**<span data-preserver-spaces="true"> This element allows you to add GIFs to your email template. You can change the default GIF by clicking on the image box and choosing from options like GIPHY or providing a custom source URL.</span>
- **<span data-preserver-spaces="true">Button:</span>**<span data-preserver-spaces="true"> Use this element to add clickable buttons linked to URLs. Button text, link, shape, and colour options are available in the "Content" section.</span>
- **<span data-preserver-spaces="true">Divider:</span>**<span data-preserver-spaces="true"> Add dividers to separate content within your template. Customise line style, colour, and background colour by clicking on the divider element.</span>
- **<span data-preserver-spaces="true">Spacer:</span>**<span data-preserver-spaces="true"> This element inserts space between other template elements. You can adjust the spacer height and background colour.</span>
- **<span data-preserver-spaces="true">Social:</span>**<span data-preserver-spaces="true"> This element incorporates social media icons into your email template. You can customise icon styles, sizes, and padding and even upload custom icons. The "Is Share URL" option streamlines social media sharing by pre-populating messages and images.</span>
- **<span data-preserver-spaces="true">Video:</span>**<span data-preserver-spaces="true"> Add videos from YouTube or Vimeo by entering the respective links.</span>
- **<span data-preserver-spaces="true">HTML:</span>**<span data-preserver-spaces="true"> Embed HTML code into your email template using this element. Access the HTML Content section for code input.</span>

**<span data-preserver-spaces="true">Pre-made:</span>**

- **<span data-preserver-spaces="true">Header:</span>**<span data-preserver-spaces="true"> Drag and drop the "Headline" to insert a headline, allowing HTML code input for customising the header.</span>
- **<span data-preserver-spaces="true">Content:</span>**<span data-preserver-spaces="true"> This option provides predefined Title, Paragraph, Buttons, and Divider elements for easy inclusion in your template.</span>
- **<span data-preserver-spaces="true">Footer:</span>**<span data-preserver-spaces="true"> By dragging and dropping "Company Footer," you can add a predefined footer to your template.</span>

<span data-preserver-spaces="true">Additionally, there are "Structure" and "Setting" sections. The "Structure" option lets you choose from predefined design structures, such as one, two, three, or four elements in a row, simplifying the placement of your desired elements.</span>

<span data-preserver-spaces="true">In the "Setting" section, you can access a list of settings applicable to the entire template, not just specific elements, streamlining global adjustments to your template's appearance and behaviour.</span>

<video controls="controls" height="482" src="https://shipping-documentation.despatchcloud.app/attachments/241?open=true" style="width: 857px; height: 482px;" width="857"></video>

<p class="callout info">**Click to Play or Pause the Video**</p>

### <span style="color: rgb(245, 89, 64);">**Options**</span>

<span data-preserver-spaces="true">Located on the top bar, you'll find essential buttons to enhance your template design experience:</span>

- **<span data-preserver-spaces="true">Redo &amp; Undo:</span>**<span data-preserver-spaces="true"> These buttons empower you to redo or undo your actions, ensuring precise control over your template's evolution.</span>
- **<span data-preserver-spaces="true">Preview:</span>**<span data-preserver-spaces="true"> By clicking this button, you can visualise your template in a rendered state, precisely as it would appear to your customers.</span>
- **<span data-preserver-spaces="true">Save:</span>**<span data-preserver-spaces="true"> The save button is crucial on the far right side of the bar. Your template changes remain unsecured until you click this button. Once saved, you can revisit your templates anytime to view your creation.</span>
- **<span data-preserver-spaces="true">Options:</span>**<span data-preserver-spaces="true"> Once you're back at the templates page, clicking the options button reveals a menu offering choices like copying, editing, and deleting your template. Copying simplifies template creation by allowing you to retain the parts you need for your new template, saving you valuable time and effort.</span>

<video controls="controls" height="475" src="https://shipping-documentation.despatchcloud.app/attachments/243?open=true" style="width: 844px; height: 475px;" width="844"></video>

<p class="callout info">**Click to Play or Pause the Video**</p>

### <span style="color: rgb(245, 89, 64);">**An Example Email Template**</span>

<span data-preserver-spaces="true">We've designed a basic email template example that can provide you with valuable insights. Below, we'll break down the elements used and their order to simplify replicating or creating a similar email template with a comparable structure.</span>

**<span data-preserver-spaces="true">1. Header with Company Logo:</span>**

- <span data-preserver-spaces="true">We've incorporated a picture field at the top, where you can insert your company's logo and adjust its size.</span>

**<span data-preserver-spaces="true">2. Divider:</span>**

- <span data-preserver-spaces="true">We've added a divider below the company logo to create a visual separation between sections.</span>

**<span data-preserver-spaces="true">3. Personalised Message Text Field:</span>**

- <span data-preserver-spaces="true">In the next section, you'll find a text field. It is where you can include a meaningful message using available variables. These variables fetch data for each order, enabling you to craft personalised emails for each customer.</span>

**<span data-preserver-spaces="true">4. Divider:</span>**

- <span data-preserver-spaces="true">Another divider follows the personalised message section, maintaining visual clarity.</span>

**<span data-preserver-spaces="true">5. Social Media Links and Additional Text Field:</span>**

- <span data-preserver-spaces="true">The subsequent section combines both text and social media fields. Here, we've customised the social media links for our company. You can easily modify this field to include as many platforms as possible. Furthermore, if you wish to include a platform unavailable in the presets, you can upload a custom logo and tailor it to your needs.</span>

<span data-preserver-spaces="true">With just a few straightforward steps, our user-friendly graphical interface empowers you to create visually appealing and personalised emails that resonate with your customers.</span>

[![testing.webp](https://shipping-documentation.despatchcloud.app/uploads/images/gallery/2025-03/scaled-1680-/ck7testing.webp)](https://shipping-documentation.despatchcloud.app/uploads/images/gallery/2025-03/ck7testing.webp)