Creating and managing email templates
How to create, edit and preview the email, reminder, system and SMS templates your organisation sends.
How to create, edit and preview the email, reminder, system and SMS templates your organisation sends.
Every automatic email and text that Recruit sends to candidates, referees, approvers and staff comes from a template you can edit. This article covers where templates live, how to create and change one, and what the editor checks when you save. The other template topics each have their own article, listed at the end.
Who can manage templates
System Admin and HR users can open Communication Templates, and create, edit, preview and delete templates. Members, hiring managers, interviewers and agencies do not see the page. If they reach it by a link they are told that only admins and HR can manage communication templates.
The same two roles are the only ones who can send emails and texts to candidates by hand. Members and hiring managers do not see the send options on a candidate, and the button for sending a rejection email from the pipeline is for System Admin and HR users only.
Open the page from Settings, then Automations & Communication, then Communication Templates. The page shows a list of templates on the left and an editor on the right. Tabs across the top group the templates: Email Templates, Reminders, System Emails and SMS. The SMS tab appears only if your organisation has the SMS add-on.
Create a template
- Open the tab that matches the kind of message.
- Select the add button at the bottom of the list: + Add Email Template, + Add Reminder Template, + Add System Email Template or + Add SMS Template.
- In the New Email Template window, choose a Category and select Confirm. The window offers only the categories that belong to the tab you are on, and you can change the category later.
- The template is created straight away. Its name is "Untitled" followed by the category and "template", for example "Untitled Rejection template", and the subject and body hold starter text. Some categories, such as Application Started, Application Form Reminder and Agency Assigned, start with a short ready-made body that already contains the link they need. Replace the name, subject and body, then select Save.
If Recruit cannot create the template you see "Couldn't create the template" and the New Template window stays open, so you can try again. Because the template exists as soon as you confirm, do not leave the starter wording in place. Anything that uses the template would send it as it stands.
Your organisation normally already has a template in the categories that need a link, so edit that one rather than adding another. The categories are explained in "Email template categories and when each is sent".
The editor
Select a template in the list to open it. Use the search box above the list to find a template by name, category or subject (SMS templates search by name only). On the Email Templates tab, Filter by category narrows the list to one category. Templates are listed by category and then alphabetically.
- Template Name: up to 255 characters. This is the name you see in Recruit, not the recipient.
- Category: decides where the template is used and which merge fields are available. Templates with a Default badge have a fixed category.
- Subject Line: up to 500 characters. Not used for SMS.
- Body (labelled Content for SMS): the message itself.
- Attachments: on the Email Templates tab only. Select Attach a file to add files that go out with every email sent from the template. You can attach up to 10 files, each up to 8 MB. PDF, Word, Excel, PowerPoint and image files are accepted. Remove a file with the remove control beside its name, then save.
Save stays disabled until the name, subject and body are filled in. It also stays disabled while the body of a Reference Request, Application Started, Application Form Reminder or Agency Assigned template is missing the link that category requires. Invitation and Reactivation templates are refused on save in the same way. "Using merge fields in email templates" lists the links.
Formatting the body
The body opens in a rich text editor. The toolbar has Bold, Italic, Underline, Link, Image, Bullet list, Ordered list and left, centre and right alignment. Link and Image ask for a web address. Above the editor, the Editor and Raw HTML tabs let you switch to the underlying HTML if you need finer control or want to paste a designed layout.
When you save, Recruit checks the HTML and rejects it with a message that names the problem and the line number. Emails cannot contain script, iframe, object, embed, form, input, button, textarea, select, style, link or meta tags, event attributes such as onclick, or links and images that do not start with http, https or mailto. Unclosed or mismatched tags are also rejected. Tags and attributes outside the supported set are removed when the template is saved. SMS templates use a plain text box, not the rich text editor.
Preview a template
On the Email Templates, Reminders and System Emails tabs, select Preview to see the subject and body with sample values in place of the merge fields. Preview shows the saved version, so save your changes first. Links that are created separately for each recipient show a sample, and the window lists which ones. If a template contains a field Recruit has no sample for, it appears in the preview as written. There is no preview on the SMS tab.
Organisations in a group
If you administer a group, a company selector appears at the top right of the page. Choose a company to manage its templates. When a parent company shares its communication templates under Library sharing, the templates appear in the subsidiary with a Shared from badge. They can be used but not edited or deleted from the subsidiary, and the editor has no Save or Delete buttons.
Errors you may see
- A message such as "contains an unsupported HTML tag" or "unclosed tag (line 4)": fix the HTML on the line given, or switch back to the Editor tab and rebuild the formatting there.
- An attachment message such as "is larger than 8 MB" or "is not a file type that can be emailed": use a smaller file, or a PDF, Word, Excel, PowerPoint or image file.
- "These files are too large to send together": remove one attachment or use smaller files.
Errors about merge fields and required links are covered in "Using merge fields in email templates".