> For the complete documentation index, see [llms.txt](https://docs.xorosoft.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.xorosoft.com/xoroerp-1/utilities/data-imports/upload-email-template.md).

# 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
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## 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, and the optional `goal` query parameter:

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

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.