# Upload Email Template

The email templates are pre-defined structures for the email content. They serve as the foundation for sending out consistent emails each time.  These templates typically include placeholders for customizable elements like recipient names, company details, and specific content, allowing users to tailor messages.

You can either create an email template from the Email Template module or Batch Upload from the “**Upload Email Template”** module using the steps mentioned below:

* Download the latest CSV template from the “Batch Upload Email” module.
* Copy the template information into the CSV template.
* Upload the CSV template into Xoro.

### Downloading the CSV template

* Navigate to the “**Batch Upload Email Template**” module using the search menu.
* Click on "**Download Template".**

  <figure><img src="/files/c2H8qoIGhRLYi4YrDHFt" alt=""><figcaption></figcaption></figure>

### **Copying the information into the template**

Once you’ve downloaded the template file, you can copy your data using any spreadsheet software. There are columns that you must complete and others that are optional. Mandatory fields are marked with a double asterisk (\*\*) prefix.

* The file must be a CSV (Comma-separated values) file. The name of your file must end with csv.
* Make sure you don’t change any column headings from row 1 in the template; these are needed for the file to import correctly.

#### Email Template File Fields

<table><thead><tr><th width="234">Field</th><th width="149">Data Type</th><th>Description</th></tr></thead><tbody><tr><td>**DocumentName </td><td>Text</td><td>Enter the name of the module for which you want to add the template, e.g. Sales Order/Invoice/Estimate/Purchase Order, etc.</td></tr><tr><td>**ActionName</td><td>Text</td><td>Enter the name of the document for which you are uploading the template, e.g. Order Confirmation/Deposit Link/general, etc.</td></tr><tr><td>PdfTemplateName</td><td>Text</td><td>Enter the name of the pdf template.</td></tr><tr><td>EmailTemplateBody </td><td>Text</td><td>Enter the that body of the email here.</td></tr><tr><td>SendFromEmailTemplate </td><td>Text</td><td>Choose if you want to send the email from the User Email or Company Email.</td></tr><tr><td>EntityType</td><td>Text</td><td>Please indicate if the email is meant for a "Customer" or a "Vendor".</td></tr><tr><td>EntityName </td><td>Text</td><td>Enter the name of the customer or the vendor here. This should exactly match the customer or vendor name registered in Xoro.</td></tr><tr><td>EntityEmail </td><td>Text</td><td>Enter the email address to which the email will be sent.</td></tr><tr><td>EntityCurrencyCode</td><td>Text</td><td>Enter the currency code of the entity (customer/vendor).</td></tr><tr><td>ImportError</td><td>Text</td><td>If there are any errors from an upload, they will be listed in this column.</td></tr></tbody></table>

### Uploading the template

Once you have filled the CSV file with your data, you can follow the steps below to upload it into Xoro:

* Click **Browse** to select the saved CSV template file.

  <figure><img src="/files/FItT1w4uytlnu2yZ4vIu" alt=""><figcaption></figcaption></figure>
* After the file has been selected, click on **Upload** to start importing.

  <figure><img src="/files/1JKfoOoH0JojXQD8he1j" alt=""><figcaption></figcaption></figure>
* While the import is in progress, the summary of the progress will be displayed at the bottom of the screen with the progress bar.
* After the import has been completed, the result will be displayed with the message for success or error (if any).
* Products will only get uploaded into the system if there are no errors in the file. If there are errors in the file, you can download the error file, fix the errors in the **original file** and upload it back into Xoro.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.xorosoft.com/xoroerp-1/utilities/data-imports/upload-email-template.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.