Add email templates for emails you send from Xero

Add email templates for different types of emails you send from Xero. Email templates are messages you can set up to use again, when you send emails from Xero.

About email templates

You can set up 10 email templates for each template type, for your organisation. Template types are:

    • Credit notes
    • Purchase orders
    • Quotes
    • Receipts
    • Remittance advices
    • Repeating invoices
    • Sales invoices (which is also the template type Xero uses for prepayments)
    • Statements

Default email templates are already set up for you, for each email template type. You can identify them in Email Settings by their name 'Basic'. Default email templates, and ones you add, contain pre-filled:

    • Subjects
    • Message text
    • Placeholders

Invoice reminders use email templates, but you add and edit them when you set up the reminders.

Add an email template

  1. In the Settings menu, select General Settings.
  2. Under Features, click Email Settings.
  3. Click Edit next to Templates.
  4. Click + Add email template.

    Image showing email template menu

  5. Select the type of email template to set up. This determines the default text and placeholders Xero enters for you. Then select and enter information in the email template.

    Fields in email template explained

    Image of the Add Email Template window, and the Type selection.

  6. Save.

Fields in email template explained

Information about the fields in the email template:

  • Type (Add template only)

    Select an email template type:

    • Credit Note
    • Purchase Order
    • Quote
    • Sales Invoice (which is also the template type Xero uses for prepayments)
    • Remittance Advice
    • Repeating Invoice
    • Statement
    • Receipt

    Based on the type you select, Xero fills the subject and message fields with default text and placeholders.

  • Name

    Enter a unique name for your template.

  • Default

    Check this box to make the template the default template for this email template type.

    If you're editing the template, you cannot uncheck the box if you don't want this template as the default.

    How to choose a new default email template

  • (Only for the Repeating Invoice template) Replace existing repeat invoice messages

    Check this box to replace email messages that accompany repeating sales invoices you have set to approve and send.

    Approve and send repeating sales invoices

  • Message

    Change the email subject and message. Insert placeholders for other content you want to include in the subject and body of the email.

Insert placeholders

Placeholders are named markers, where content from Xero displays when you send the email. Placeholders have square brackets around them, for example [Contact Name].

Insert placeholders into the subject and message by selecting from the placeholder list. You can also type them in, but you'll need to enter square brackets around the placeholder name, for example [Trading Name]. (Xero will insert the placeholder into the template wherever your cursor is.)

Placeholders you can use for each email type

Credit note

PlaceholderDescription of the placeholder
Contact First NameThe first name of the contact stored in your contact's details.
Contact Last NameThe last name of the contact stored in your contact's details.
Contact NameThe name of the contact stored in your contact's details.
Credit Total Without CurrencyThe total credit note value, including tax, without the currency code.
Credit TotalThe total credit note value, including tax, with the currency code included.
Currency CodeThe 3-letter code that represents the currency type.
Currency SymbolThe symbol representing the currency type.
Invoice NumberThe number of the credit note.
Month YearThe current month and year, for example, October 2014. You can edit this placeholder to display earlier or later dates. For example, if the current month is December 2014, [Month Year+1] will display January 2015.
MonthThe current month of the year, for example, October. You can edit this placeholder to display earlier or later months. For example, [Month+1] will display the month after the invoice date.
Online Invoice LinkThe link to the online credit note.
ReferenceThe reference from the credit note.
Remaining Credit Without CurrencyThe amount due on the invoice, or remaining credit on the prepayment, including tax, without the currency code.
Remaining CreditThe amount due on the invoice, or remaining credit on the prepayment, with the currency code included.
Trading NameYour organisation's legal/trading name set up in Organisation Settings.
Week YearThe current week and year, for example, 46 2014. Weeks start on Monday. You can edit this placeholder to display earlier or later dates. For example, if the current week is 46 2014, [Week Year+1] will display 47 2014.
WeekThe current week of the calendar year, for example, Week 8. Weeks start on Monday. You can edit this placeholder to display earlier or later weeks. For example, [Week+1] will display the week after the invoice date. Week calculations follow the ISO 8601 standard. Week 1 starts on Monday and always includes the first Thursday of the new year. The last week of the year will be either 52 or 53.
YearThe current year. You can edit this placeholder to display earlier or later years. For example, [Year-1] will display the year before the invoice date.

Purchase order

PlaceholderDescription of the placeholder
Contact First NameThe first name of the contact stored in your contact's details.
Contact Last NameThe last name of the contact stored in your contact's details.
Contact NameThe name of the contact stored in your contact's details.
Currency CodeThe 3-letter code that represents the currency type.
Currency SymbolThe symbol representing the currency type.
Delivery AddressThe delivery address selected for the purchase order.
Delivery ContactThe Attention field from the purchase order.
Delivery DateThe delivery date from the purchase order.
Delivery DetailsIncludes purchase order delivery address, instructions, contact and phone.
Delivery InstructionsThe delivery instructions from the purchase order.
Delivery Phone NumberThe Telephone field from the purchase order.
Month YearThe current month and year, for example, October 2014. You can edit this placeholder to display earlier or later dates. For example, if the current month is December 2014, [Month Year+1] will display January 2015.
MonthThe current month of the year, for example, October. You can edit this placeholder to display earlier or later months. For example, [Month+1] will display the month after the invoice date.
Purchase Order NumberThe order number from the purchase order.
Purchase Order Total Without CurrencyThe total purchase order value, including tax, without the currency code.
Purchase Order TotalThe total purchase order value, including tax, with the currency code included.
ReferenceThe reference from the purchase order.
Trading NameYour organisation's legal/trading name set up in Organisation Settings.
Week YearThe current week and year, for example, 46 2014. Weeks start on Monday. You can edit this placeholder to display earlier or later dates. For example, if the current week is 46 2014, [Week Year+1] will display 47 2014.
WeekThe current week of the calendar year, for example, Week 8. Weeks start on Monday. You can edit this placeholder to display earlier or later weeks. For example, [Week+1] will display the week after the invoice date. Week calculations follow the ISO 8601 standard. Week 1 starts on Monday and always includes the first Thursday of the new year. The last week of the year will be either 52 or 53.
YearThe current year. You can edit this placeholder to display earlier or later years. For example, [Year-1] will display the year before the invoice date.

Invoice reminders

PlaceholderDescription of the placeholder
Amount Due Without CurrencyThe amount due on the invoice, or remaining credit on the prepayment, including tax, without the currency code.
Amount DueThe amount due on the invoice, or remaining credit on the prepayment, with the currency code included.
Contact First NameThe first name of the contact stored in your contact's details.
Contact Last NameThe last name of the contact stored in your contact's details.
Contact NameThe name of the contact stored in your contact's details.
Currency CodeThe 3-letter code that represents the currency type.
Currency SymbolThe symbol representing the currency type.
Due DateThe due date from the invoice.
Invoice NumberThe invoice number from the invoice.
Invoice Total Without CurrencyThe total invoice amount, including tax, without the currency code.
Invoice TotalThe total invoice amount, including tax, with the currency code included.
Month YearThe current month and year, for example, October 2014. You can edit this placeholder to display earlier or later dates. For example, if the current month is December 2014, [Month Year+1] will display January 2015.
MonthThe current month of the year, for example, October. You can edit this placeholder to display earlier or later months. For example, [Month+1] will display the month after the invoice date.
Online Invoice LinkThe link to the online invoice.
ReferenceThe reference from the invoice.
Trading NameYour organisation's legal/trading name set up in Organisation Settings.
Week YearThe current week and year, for example, 46 2014. Weeks start on Monday. You can edit this placeholder to display earlier or later dates. For example, if the current week is 46 2014, [Week Year+1] will display 47 2014.
WeekThe current week of the calendar year, for example, Week 8. Weeks start on Monday. You can edit this placeholder to display earlier or later weeks. For example, [Week+1] will display the week after the invoice date. Week calculations follow the ISO 8601 standard. Week 1 starts on Monday and always includes the first Thursday of the new year. The last week of the year will be either 52 or 53.
YearThe current year. You can edit this placeholder to display earlier or later years. For example, [Year-1] will display the year before the invoice date.

Quote

PlaceholderDescription of the placeholder
Currency CodeThe 3-letter code that represents the currency type.
Currency SymbolThe symbol representing the currency type.
Customer First NameThe first name of the customer stored in your contact's details.
Customer Last NameThe last name of the customer stored in your contact's details.
Customer NameThe name of the customer stored in your contact's details.
ExpiryThe expiry date of the quote.
Online Quote LinkThe link to the online quote.
Quote NumberThe quote number from the quote.
Quote Total Without CurrencyThe total quote amount, including tax, without the currency code.
Quote TotalThe total of the quote, with the currency code included.
ReferenceThe reference from the quote.
SummaryThe summary from the quote.
TermsThe terms from the quote.
TitleThe title from the quote.
Trading NameYour organisation's legal/trading name set up in Organisation Settings.

Receipts

PlaceholderDescription of the placeholder
Contact First NameThe first name of the contact stored in your contact's details.
Contact Last NameThe last name of the contact stored in your contact's details.
Contact NameThe name of the contact stored in your contact's details.
Currency CodeThe 3-letter code that represents the currency type.
Currency SymbolThe symbol representing the currency type.
Customer Total Without CurrencyThe total amount received, including tax, without the currency code.
Customer TotalThe amount received, with the currency code included.
Trading NameYour organisation's legal/trading name set up in Organisation Settings.

Remittance advice

PlaceholderDescription of the placeholder
Contact First NameThe first name of the contact stored in your contact's details.
Contact Last NameThe last name of the contact stored in your contact's details.
Contact NameThe name of the contact stored in your contact's details.
Currency CodeThe 3-letter code that represents the currency type.
Currency SymbolThe symbol representing the currency type.
Supplier Total Without CurrencyThe total amount paid, including tax, without the currency code.
Supplier TotalThe amount paid, with the currency code included.
Trading NameYour organisation's legal/trading name set up in Organisation Settings.

Repeating Invoice

PlaceholderDescription of the placeholder
Amount Due Without CurrencyThe amount due on the invoice, or remaining credit on the prepayment, including tax, without the currency code.
Amount DueThe amount due on the invoice, or remaining credit on the prepayment, with the currency code included.
Contact First NameThe first name of the contact stored in your contact's details.
Contact Last NameThe last name of the contact stored in your contact's details.
Contact NameThe name of the contact stored in your contact's details.
Currency CodeThe 3-letter code that represents the currency type.
Currency SymbolThe symbol representing the currency type.
Current MonthThe current month of the year, for example, October. You can edit this placeholder to display earlier or later months. For example, [Month+1] will display the month after the invoice date.
Due DateThe due date from the invoice.
Invoice NumberThe invoice number from the invoice.
Invoice Total Without CurrencyThe total invoice amount, including tax, without the currency code.
Invoice TotalThe total invoice amount, including tax, with the currency code included.
Month YearThe current month and year, for example, October 2014. You can edit this placeholder to display earlier or later dates. For example, if the current month is December 2014, [Month Year+1] will display January 2015.
MonthThe current month of the year, for example, October. You can edit this placeholder to display earlier or later months. For example, [Month+1] will display the month after the invoice date.
Online Invoice LinkThe link to the online invoice.
ReferenceThe reference from the invoice.
Trading NameYour organisation's legal/trading name set up in Organisation Settings.
Week YearThe current week and year, for example, 46 2014. Weeks start on Monday. You can edit this placeholder to display earlier or later dates. For example, if the current week is 46 2014, [Week Year+1] will display 47 2014.
WeekThe current week of the calendar year, for example, Week 8. Weeks start on Monday. You can edit this placeholder to display earlier or later weeks. For example, [Week+1] will display the week after the invoice date. Week calculations follow the ISO 8601 standard. Week 1 starts on Monday and always includes the first Thursday of the new year. The last week of the year will be either 52 or 53.
YearThe current year. You can edit this placeholder to display earlier or later years. For example, [Year-1] will display the year before the invoice date.

Sales Invoice

PlaceholderDescription of the placeholder
Amount Due Without CurrencyThe amount due on the invoice, or remaining credit on the prepayment, including tax, without the currency code.
Amount DueThe amount due on the invoice, or remaining credit on the prepayment, with the currency code included.
Contact First NameThe first name of the contact stored in your contact's details.
Contact Last NameThe last name of the contact stored in your contact's details.
Contact NameThe name of the contact stored in your contact's details.
Currency CodeThe 3-letter code that represents the currency type .
Currency SymbolThe symbol representing the currency type.
Due DateThe due date from the invoice.
Invoice NumberThe invoice number from the invoice.
Invoice Total Without CurrencyThe total invoice amount, including tax, without the currency code.
Invoice TotalThe total invoice amount, including tax, with the currency code included.
Month YearThe current month and year, for example, October 2014. You can edit this placeholder to display earlier or later dates. For example, if the current month is December 2014, [Month Year+1] will display January 2015.
MonthThe current month of the year, for example, October. You can edit this placeholder to display earlier or later months. For example, [Month+1] will display the month after the invoice date.
Online Invoice LinkThe link to the online invoice.
ReferenceThe reference from the invoice.
Trading NameYour organisation's legal/trading name set up in Organisation Settings.
Week YearThe current week and year, for example, 46 2014. Weeks start on Monday. You can edit this placeholder to display earlier or later dates. For example, if the current week is 46 2014, [Week Year+1] will display 47 2014.
WeekThe current week of the calendar year, for example, Week 8. Weeks start on Monday. You can edit this placeholder to display earlier or later weeks. For example, [Week+1] will display the week after the invoice date. Week calculations follow the ISO 8601 standard. Week 1 starts on Monday and always includes the first Thursday of the new year. The last week of the year will be either 52 or 53.
YearThe current year. You can edit this placeholder to display earlier or later years. For example, [Year-1] will display the year before the invoice date.

Statements

PlaceholderDescription of the placeholder
Balance with Currency and SymbolIf you're emailing a statement, use this placeholder to show the customer's current statement balance with both the currency symbol and currency type included in the email.
Balance with SymbolIf you're emailing a statement, use this placeholder to show the customer's current statement balance with the currency symbol included in the email.
Contact First NameThe first name of the contact stored in your contact's details.
Contact Last NameThe last name of the contact stored in your contact's details.
Contact NameThe name of the contact stored in your contact's details.
Statement BalanceIf you're emailing a statement, use this placeholder to show the customer's current statement balance with the currency code included in the email.
Statement Date RangeThe period covered by the statement.
Trading NameYour organisation's legal/trading name set up in Organisation Settings.