ICIMS Email Templates Setup: A Consultant’s Complete Guide
Where templates live, how merge variables behave, how workflow rules use them, and the five mistakes we find on almost every audit.
If ICIMS email templates are configured well, recruiters move faster, candidates get a consistent experience, and compliance teams sleep at night. If they’re configured poorly, recruiters copy-paste from Notepad, candidates get the wrong job title in the greeting, and someone in legal eventually finds out.
This guide walks through ICIMS email templates setup the way we run it for clients: where templates actually live, how merge variables behave, how to wire templates into workflow rules without breaking auto-send expectations, and the five mistakes we see on almost every audit.
What “ICIMS email templates setup” actually means
ICIMS email templates setup is the process of building reusable email content inside the ICIMS Talent Cloud so recruiters and workflow rules can send branded, merge-field-driven messages to candidates, employees, and hiring managers. Templates live in System Configuration, are tied to specific profile types (like Person or Recruiting Workflow), and are referenced by workflow rule actions, auto-launch actions, and direct recruiter sends.
That’s the short version. The long version is that ICIMS has more than one place where “email” content lives, and confusing them is the single biggest reason teams call us.
Table of Contents
- Email templates vs offer letters vs Connect campaigns
- Where ICIMS email templates live
- Building your first email template
- Merge variables (what works, what breaks)
- Multi-language and multi-brand templates
- Wiring templates into workflow rules
- The recruiter prompt vs auto-send distinction
- Governance, approvals, and version control
- The 5 most common email template mistakes
- FAQ
1. Email templates vs offer letters vs Connect campaigns
Before you build a single template, get the taxonomy right. ICIMS uses the word “template” in three different places.
Email templates in System Configuration are the recruiter-facing templates used for one-to-one or one-to-few sends. These are the ones we cover in this guide.
Offer letter templates are a separate object inside ICIMS Offer Management. They live in their own library, use their own merge variables, and are sent through the offer workflow, not the email workflow. If your offer letter template variables aren’t populating, that’s a different troubleshooting path. We covered that in our ICIMS offer letter template not populating guide.
Connect (formerly ICIMS Marketing Automation) campaigns use their own templates for bulk nurture emails to talent pools and CRM contacts. Those templates live inside Connect, not System Configuration, and are tuned for marketing-grade sends, not transactional recruiter messages.
2. Where ICIMS email templates live
Email templates live under System Configuration, accessed by users with the appropriate System Administrator login group permissions. The exact path can shift slightly between ICIMS UCD configurations, but the canonical location is System Configuration, then the Communications area, then Email Templates.
A few things to know before you start clicking.
You’ll see templates organized by profile type. The most common are Person, Recruiting Workflow, and Job. The profile type controls which merge variables are available. A template tied to the Recruiting Workflow profile gives you access to job-related fields like requisition title and hiring manager. A template tied to the Person profile only gives you candidate-level fields.
Templates can be filtered by template type. Common types include Email, Letter, and Auto-Notification. Pick the right type up front because you can’t change it later without rebuilding.
Some templates ship with ICIMS as out-of-the-box defaults. You can usually copy them but not delete them, which is helpful when you want a known-good starting point.
3. Building your first email template
The basic flow looks like this:
- Navigate to System Configuration, then Email Templates
- Click Add (or Copy on an existing template you want to start from)
- Choose a profile type (Person, Recruiting Workflow, or Job)
- Choose a template type (typically Email for recruiter-facing sends)
- Name the template using a convention your team can scan in a long list
- Set the From address, Reply-To, Subject line, and Body
- Save and test
That’s the surface. Underneath, every one of those fields has a few decisions that matter.
Naming convention
Templates show up in long alphabetical lists for recruiters. A name like “Confirmation” is useless. A name like “Interview Confirmation, Phone Screen, English, 2026” tells the recruiter exactly what they’re picking. Adopt a convention: stage, subject, language, version. Stick to it across all templates.
From and Reply-To
The From address is what candidates see in their inbox. The Reply-To is where their replies go. If you want recruiters to receive replies in their personal inbox, set Reply-To to a dynamic recruiter variable. If you want everything to land in a shared TA mailbox, hardcode it.
Get this wrong and replies disappear into a black hole. We see this every audit.
Subject line
The subject line is itself a merge field surface. You can pull job title, candidate first name, and company name into the subject. Just don’t get cute. Subject lines that feel personalized and clear convert better than ones that try to be clever.
Body
The body editor supports rich text, images, links, and merge variables. Most clients use a header image (logo or banner) and a footer signature block, then put dynamic content in the middle.
Two things break a lot of templates here. First, copy-pasting from Microsoft Word brings invisible formatting characters that fight the editor. Always paste as plain text and reformat. Second, inline styles can override your CSS in some email clients. Keep formatting simple and test on Outlook, Gmail, and a phone before you ship.
4. Merge variables (what works, what breaks)
Merge variables (ICIMS sometimes calls them “tokens” or “merge fields”) are the placeholders that pull live data into the template at send time. They’re what makes a template feel personal instead of robotic.
ICIMS provides merge variables for any field on the profile types you’ve selected. So a Recruiting Workflow template can pull from candidate fields, job fields, and workflow fields. A Person template only pulls from candidate fields.
According to ICIMS documentation on email variables, merge variables resolve at send time based on the profile context the recruiter is sending from. That last part matters. If a recruiter sends a Recruiting Workflow template from a candidate’s job profile, all the variables resolve. If they accidentally try to send it from a Person profile, the job-level variables come back blank.
What works well
- Candidate first name, last name, email, phone
- Job title, requisition number, location
- Hiring manager name and email
- Recruiter name and email
- Workflow status and date
What breaks
- Custom fields that aren’t enabled for the merge variable picker
- Variables that reference data not yet populated on the profile (interview times, offer salary)
- Variables pulling from a different profile type than the one being sent from
- Free-text fields with HTML or special characters
- Variables that look correct but reference deprecated field IDs after a system change
What we tell clients
Build a merge variable cheat sheet for your team. Five lines, max. Here’s a candidate variable, here’s a job variable, here’s how to test before sending. Recruiters who know the difference don’t ship “Hi {first_name}, congratulations on your interview for {job_title}” emails to actual humans.
5. Multi-language and multi-brand templates
If you hire across countries or operate multiple brands, you’ll need parallel template structures.
For multi-language sends, the cleanest pattern is one template per language per use case. So an interview confirmation might exist as English, French, Spanish, and German versions. Some teams try to use conditional logic inside a single template, but conditional logic in ICIMS email templates is limited compared to a marketing automation platform. One template per language per use case is faster to build, easier to debug, and less likely to ship the wrong language.
For multi-brand setups (think a parent company with multiple subsidiaries), use the same approach. Different header images, different footer signatures, different reply-to addresses. The naming convention earns its keep here.
A common pattern we deploy: [Brand]_[Language]_[Stage]_[Use Case]_[Version]. Example: Acme_EN_Interview_Phone_Screen_v3. Recruiters can filter the dropdown and find what they need fast.
6. Wiring templates into workflow rules
Email templates earn their keep when they’re tied into workflow automation. ICIMS workflow rules can reference an email template in two main ways.
Auto-launch actions
An auto-launch action prompts the recruiter to take an action when a candidate hits a specific workflow status. One common pattern is a Send Email action that opens a pre-selected template with the merge variables already filled in. The recruiter reviews and clicks send.
This is the most common way workflow rules and email templates connect. It’s fast, visible, and gives the recruiter a chance to personalize before sending.
Auto-notification rules
Auto-notification rules send templates without recruiter intervention. These are typically used for system-generated messages, like “Your application has been received” or workflow alerts to the hiring manager.
The trade-off is control. Auto-notifications are fully automated, which is great for transactional confirmations but risky for anything that needs a human eye. Most clients we work with restrict auto-notifications to a small set of low-risk, high-volume confirmations and route everything else through auto-launch actions.
For a deeper walkthrough of how workflow rules behave (and why they fail), see our ICIMS workflow rules not triggering guide.
7. The recruiter prompt vs auto-send distinction
This trips up almost every team migrating from another ATS. Coming from a system where “send email when status changes” actually sends, recruiters expect ICIMS to behave the same way.
Most ICIMS email templates fired through workflow rules are recruiter-prompted, not auto-sent. The system surfaces the template at the right moment, but a human still clicks Send. ICIMS designed it this way for a reason: in regulated hiring, every candidate-facing message needs a human accountable for it.
If you genuinely need fully automated sends (no recruiter in the loop), you have a few options:
- Use auto-notification template types for low-risk system messages
- Use ICIMS Connect campaigns for nurture sequences
- Use a middleware integration (Make, Workato) to listen for status changes and send via a transactional email service
We almost always recommend keeping the recruiter in the loop for anything candidate-facing in a competitive hiring market. The 30 seconds it takes to click send is the difference between a templated email and a personal one.
Need a hand cleaning up your ICIMS template library?
Our certified ICIMS team audits, rebuilds, and governs email template libraries for mid-market and enterprise TA teams. We start with a 30-minute discovery call.
Book a Discovery Call8. Governance, approvals, and version control
Email templates are content. Content needs governance. Without it, your library degrades into chaos within 18 months.
The patterns that work:
A template owner role. One person (often the ICIMS admin or TA Operations Manager) owns the library. New templates and edits route through them. They handle naming, deprecation, and the inventory.
Quarterly cleanup. Once a quarter, run a report on which templates have been used in the last 90 days. Anything stale gets archived or deleted. We’ve cut client libraries from 200+ templates to 60 active ones in a single afternoon.
Test sends before launch. Every new template gets a test send to a non-production candidate (a recruiter’s personal email or a sandbox account) before recruiters use it on real candidates. This catches merge variable failures, broken images, and formatting issues.
Change log. Even a simple Google Sheet works. Date, template name, change description, who approved. When a recruiter says “this template used to work,” you have an answer.
For mid-market and enterprise teams, this is exactly the kind of operational discipline our ICIMS managed services team handles inside the system, so the TA team can stay focused on hiring.
9. The 5 most common email template mistakes
We audit a lot of ICIMS instances. These five mistakes show up almost every time.
1 Wrong profile type
Recruiters build a template attached to the Person profile, then try to send it from a Recruiting Workflow context expecting job variables to resolve. The job variables come back blank, the email goes out broken.
2 Hardcoded values that should be merge fields
Someone hardcodes “Position: Senior Engineer” into the body because it was a one-time send. Two months later, recruiters copy that template for every job. Now every candidate gets told they’re applying for Senior Engineer.
3 Reply-To pointing to a dead inbox
Templates were built two years ago with Reply-To set to a generic recruiting@ alias. The alias was retired in a Microsoft 365 reorg. Candidate replies bounce. Recruiters never know.
4 No test send before deployment
A template ships on Friday afternoon. Monday morning, the merge variable for hiring manager email is broken because the field was renamed. 200 candidates get an email with “Hi {hiring_manager_name}” in the body.
5 Library bloat
Three years in, the template dropdown has 240 entries. Recruiters can’t find what they need. They build a 241st template instead of using the existing one. The cycle compounds.
A faster, calmer email template library
Done right, ICIMS email templates feel like an extension of your recruiters: fast, branded, correct, and consistent. Done wrong, they’re a daily source of friction and the occasional compliance scare.
If you’re staring at a template library that grew organically and nobody owns, that’s a great moment for an ICIMS system audit. We map every active template, every workflow rule that references one, every merge variable, and every gap. Then we hand you a 30-day cleanup plan.
Ready to fix your ICIMS email templates for good?
Our certified ICIMS implementation team helps mid-market and enterprise TA teams get more from their ICIMS investment. We rebuild template libraries, audit configurations, and stay on as fractional admins when you need us.
Book a Discovery Call