Quick answer
When ICIMS onboarding tasks are not assigning, the task usually exists but cannot reach the new hire. The three causes we see most: the task was created in the Task Library without an Onboarding Workflow association, so it cannot be added from the Onboard Status tab; the task is not on the Suggested Tasks tab of the New Hire Category, so the Onboarding Wizard never pre-selects it; and a prerequisite task is holding it, so the assignee cannot complete it and a third-party assignee is not even emailed yet.
Onboarding is where a recruiting win turns into a first-day experience, and a missing task is the first thing a new hire or a hiring manager notices. When a People team tells us ICIMS onboarding tasks not assigning is their recurring complaint, the tasks are almost never lost. They are configured in a way that keeps them from reaching the right person at the right moment.
This post covers the seven causes we check, in order, when onboarding tasks fail to appear for new hires, hiring managers, or HR owners in ICIMS Onboarding. Each follows the problem, impact, example, and fix pattern. It is the diagnostic companion to our ICIMS onboarding setup guide, and every product behavior described here was verified against the ICIMS Community documentation.
How ICIMS Onboarding assigns tasks
Task assignment in ICIMS Onboarding has three moving parts, and a gap in any of them produces the same symptom. First, the Task Library: tasks intended for onboarding are created there with an Onboarding Workflow association, which is what lets them be tied to New Hire Categories and assigned through the Onboarding Wizard. Second, the New Hire Category: it represents the Onboarding Workflow, and its Suggested Tasks tab decides which tasks the wizard pre-selects. Third, the hire event: a recruiter advances the candidate to the Hired status, completes the Onboarding Wizard (including the Start Date in Employee Fields), submits the new hire to a New Hire Category, adds tasks, and sends the Onboard Welcome Letter that gives the new hire portal access.
After that, additional Onboarding Workflow tasks can be added from the Onboard Status tab of the new hire’s Person profile, and the task’s assignee type (Associated Person, Specific Person, or Relational Person) decides who actually receives it. Every notification is sent automatically by the system but appears to come from the user who assigned the task.
NOTE
Only tasks with an Onboarding Workflow association can be added from the Onboard Status tab. Tasks with a Person association are assigned from the Tasks tab instead. If a task is in the wrong place, it is almost always an association problem, which is Cause 1.
Cause 1: The task has the wrong association
1
Wrong Task Library association
Problem
The task exists in the Task Library, but it does not appear in the Onboarding Wizard or in the Add Tasks list on the Onboard Status tab.
Impact
Admins rebuild tasks that already exist, or assign them from the Tasks tab where they never show in the new hire portal, and reporting splits across two task types.
Example
A benefits enrollment task was created with a Person association so an HR coordinator could add it from the Tasks tab. It works there, but it never appears for the Onboarding Workflow, so new hires in the portal do not see it.
Fix
Open Library > Task and filter by association. A task’s Association cannot be edited after it is created, and neither can its Type, so the fix is to create the task again with Onboarding Workflow as the association, then mark the old one Hidden so nobody assigns it by mistake. By default only user admins have full permissions to create and edit library tasks; if the person doing this work cannot, that permission change goes through a case to ICIMS Technical Support.
Cause 2: The task is not a suggested task on the New Hire Category
2
Not on the New Hire Category’s Suggested Tasks
Problem
The wizard runs, but the tasks the team expects are not pre-selected, so recruiters either miss them or hunt for them category by category.
Impact
Inconsistent onboarding. One recruiter adds the I-9 and the handbook; another adds only what the wizard showed. New hires start with different task lists for the same role.
Example
The team added three new compliance tasks to the Task Library in September but never added them to the Suggested Tasks tab of the Corporate Full-Time New Hire Category. The wizard still pre-selects the old list.
Fix
Suggested tasks are determined by the task list on the Suggested Tasks tab of the associated New Hire Category, so update that tab, not the recruiter. Also check which New Hire Category is being chosen: if a category is associated with the Job, it is pre-selected in the wizard, and the wrong job association means the wrong task set every time. When a task is missing after the fact, add it from the Onboard Status tab; if multiple Onboarding Workflows exist, the Add Tasks button shows a dropdown and the recruiter must pick the right workflow. Our ICIMS training work usually starts here, because this is a process gap as much as a configuration gap.
Cause 3: A prerequisite task is holding it
3
A prerequisite task is holding it
Problem
The task is assigned and visible, but the new hire cannot complete it, or the hiring manager says they never received the email for their task.
Impact
Tasks look stalled. Teams assume notifications are failing when the system is doing exactly what the dependency told it to do.
Example
The IT equipment task is assigned to a Specific Person on the IT team with the signed offer acknowledgment as a prerequisite. The new hire has not completed the acknowledgment, so IT has not been emailed, and the start date is Monday.
Fix
Open the task in the Task Library (filter by Onboarding Workflow, select Edit) and review the Prerequisite Task(s) section. When prerequisites are set, the task cannot be completed by its assignee until all prerequisites are complete, and non-new-hire assignees are not emailed until each prerequisite is done. Two details matter: prerequisites selected after a new hire has already been assigned tasks are not applied retroactively to that individual, and a task assigned without its prerequisites has none enforced. So the fix for an in-flight new hire is to complete or remove the blocking task on their Onboard Status tab, and the fix for the next hire is to re-sequence the library.
Cause 4: The assignee type resolves to nobody
4
The assignee type resolves to nobody
Problem
The task is assigned to the new hire when it should have gone to the hiring manager, or to the same named person for every hire regardless of department.
Impact
Hiring managers are not involved in onboarding at all, or one coordinator receives every task in the company and becomes the bottleneck.
Example
The ‘take your new hire to lunch’ task was built with Associated Person as the assignee type, so it lands on the new hire’s own task list. The team wanted the hiring manager on the associated job.
Fix
Check the Assignee Type on the library task. Associated Person assigns the task to the Person profile being viewed, Specific Person assigns it to one named individual every time, and Relational Person assigns it based on a relationship, for example Fields (Workflow) Tab > Associated Job > Hiring Manager. Relational Person is only available if the Relational Persons feature is enabled for your system, which is a case to ICIMS Technical Support. If you rely on a relational assignee, the job’s Hiring Manager field must be populated at hire time, which is worth a line in your ICIMS system audit checklist.
Onboarding tasks missing for every new hire?
Book a discovery call and we will walk your Task Library, New Hire Categories, and notification templates with you and tell you which of these seven causes applies to your instance. Clients have cut HR support tickets by 90% in 90 days with configuration fixes like these.
Book a discovery callCause 5: The notification went to the wrong template or portal
5
Wrong notification template or portal
Problem
Tasks are assigned correctly in ICIMS but the new hire or the third-party stakeholder says no email arrived, or the email that arrived had no task details.
Impact
Assignees do not act on tasks they do not know about. Overdue counts climb and the People team starts chasing by hand.
Example
A company runs two new hire portals, Corporate and Hourly. During the wizard the recruiter left the Assign Onboard Portal field on the wrong portal, so the new hire received the notification templates configured for the other portal, which had been stripped down during a redesign.
Fix
There are two notification systems and they are configured in different places. New hire Onboard task notifications are configured under System Configuration > Onboarding > Notifications on a per-portal basis for new, upcoming, and overdue tasks, and the Assign Onboard Portal field in the wizard decides which set a new hire gets. Tasks assigned to third parties such as hiring managers, and tasks assigned from the Tasks tab, use the templates under System Configuration > System > Notifications instead. Check that the right template is populated with the task variables (Task: Task Definition: Name, Task: Association, Task: Due Date) and that the new hire’s portal matches. If no ICIMS email is arriving at all, start with ICIMS email notifications not working first.
Cause 6: The task is hidden or was created outside the library
6
Hidden task or non-library task
Problem
A task that used to be assignable has disappeared from the list, or a one-off task was created ad hoc and does not behave like the others.
Impact
Recruiters assume the task was deleted and recreate it, creating duplicates. Ad hoc tasks also complicate reporting with the Task Search.
Example
An admin ticked the Hidden checkbox while editing the drug screen task during a vendor change and never unticked it. Separately, a coordinator created the same task as a non-library task from the Onboard Status tab, so it exists for one new hire only.
Fix
Edit the library task and check the Hidden checkbox; it hides the task from being assigned, and tasks already assigned are unaffected, which is why existing hires still show it. For ad hoc tasks, the ability to create non-library tasks is granted per user group, and the Community recommends adding most tasks to the library and reusing them. Keep non-library tasks to true one-offs. If this keeps recurring, a monthly library review is the kind of hygiene our ICIMS managed services team runs for clients.
Cause 7: Due dates and reminders are keyed to a missing start date
7
Due dates keyed to a missing start date
Problem
Tasks assign, but the due dates are wrong or empty, reminders never fire, and overdue notifications arrive in a confusing batch.
Impact
New hires see no urgency, and the compliance tasks that have a real deadline (forms before day one) slip into week one.
Example
The recruiter skipped the Start Date in the Employee Fields section of the Onboarding Wizard because the date was ‘still being confirmed.’ Every task with a due date relative to start date now has nothing to anchor to.
Fix
Enter or update the new hire’s Start Date in the wizard; the Community notes it is commonly used for task due dates and some integrations. Then review the library task: the due date is set relative to either when the task was assigned or the new hire’s start date, and reminders can fire when assigned, a number of days before the due date, or when past due. Two expectations to set with the team: reminder and overdue notices for Onboard tasks are batched into one email, and informational tasks have no due dates and therefore no reminders. Informational tasks also appear in the Documents section of the new hire portal rather than the Tasks list, which is a frequent ‘the task is missing’ false alarm.
The 10 minute diagnostic checklist
Run this in order the next time someone reports ICIMS onboarding tasks not assigning. It mirrors our audit sequence and resolves most tickets without a support case.
- Open the new hire’s Person profile and the Onboard Status tab. Is the task listed at all? If not, continue; if yes, skip to step 5.
- Open Library > Task, filter by Onboarding Workflow. Is the task there with that association? If it has a Person association, recreate it (Cause 1).
- Open the New Hire Category used for this hire and check its Suggested Tasks tab (Cause 2). Confirm the right category was chosen in the wizard.
- Edit the task and check the Hidden checkbox (Cause 6).
- Check the task’s Prerequisite Task(s) and whether the prerequisite is complete on this new hire’s profile (Cause 3).
- Check the Assignee Type and, for Relational Person, whether the job’s Hiring Manager field is populated (Cause 4).
- Check the new hire’s assigned portal and the matching notification templates under Onboarding > Notifications, or System > Notifications for third-party tasks (Cause 5).
- Confirm the Start Date is populated and the due date rule on the task (Cause 7). To re-open a task, edit it on the Onboard Status tab and set its status to Open.
TIP
If the new hire cannot see any tasks at all, confirm the Onboard Welcome Letter was sent. That email is what gives the new hire access to the portal, and it can be resent from the email address link at the top of their Person profile. If the portal itself will not load, that is a different problem, covered in our ICIMS onboarding portal not working post.
FAQ: ICIMS onboarding tasks not assigning
Make day one predictable
A short discovery call is enough to tell you whether the fix is a library rebuild, a New Hire Category cleanup, or a notification template. We will show you what we would change first and how to keep it that way.
Book a discovery call
