HomeBlog › Jira Onboarding Template

Jira Onboarding Template: Epic, Sub-tasks, and Automation

TL;DR: A Jira onboarding template is an Automation rule with one trigger ("Epic created, label = new-hire") and one "Create issue" branch action per sub-task. Set each action's due date as a Smart Value expression relative to the Epic's start date — {{issue.startDate}} for Day 1, {{issue.startDate.plusDays(30)}} for the 30-day check-in, {{issue.startDate.minusDays(7)}} for pre-arrival IT tasks. Expressions keep due dates correct when a hire date shifts; hard-coded dates do not.

A Jira onboarding template is the Automation rule configuration that turns one trigger — an Epic created with the label "new-hire" — into a fully-formed onboarding structure: per-hire Epic, 20 sub-tasks, department Component assignment, and due dates keyed to the hire start date. PPLX Software (maker of TeamOps, our Atlassian app) built and iterated on this setup across hundreds of hires; the field values and wiring steps below replicate it without any additional tooling.

Two decisions determine whether the template holds up at scale. First, every sub-task's due date must be expressed relative to the hire date, not a fixed calendar date — otherwise a single reschedule requires manually editing 20 tasks. Second, use Jira Components (not labels) for department ownership, because Components support default assignees, which routes each task to the right person automatically.

The template: 20 sub-task actions

Each row is one "Create issue" branch action in the Automation rule. Set Issue type to Sub-task and Parent to {{issue.key}} (auto-links to the triggering Epic) on every action. The Due date column shows the Smart Value expression to paste into the Due date field.

# Summary (task name) Component Due date expression Field note
1 Provision laptop and confirm ship address IT {{issue.startDate.minusDays(7)}} 7 days before start. Shipping lead time means this task closes late more than any other. Pull it earlier than you think you need to.
2 Create Atlassian account and grant project access IT {{issue.startDate}} Set permission to Developer, not Admin. Developer access is sufficient for all onboarding work; Admin lets new accounts change workflow configurations.
3 Provision VPN credentials IT {{issue.startDate}} Add the secrets manager link in the task description, not the credentials themselves. Jira comments are visible to all project members.
4 Create badge and building access request Security {{issue.startDate}} Assign to Facilities or Security. A separate Component means their tasks filter cleanly from IT's queue without hiding either set.
5 Set Jira notification preferences IT {{issue.startDate}} Walk the new hire through Project Settings → Notifications on Day 1. Default notification schemes email on every project event; new hires disable Jira email entirely within a week when that happens.
6 Add to Slack workspace and required channels IT {{issue.startDate}} List specific channels in the task description. "Slack access" without a channel list gets the new hire into #general only.
7 I-9 and right-to-work documentation HR {{issue.startDate}} Track completion here; store the actual documents in your HRIS or a restricted Confluence space, not as Jira attachments.
8 Benefits enrollment form sent HR {{issue.startDate.plusDays(3)}} Day 3, not Day 1. Benefits enrollment requires thought; Day 1 is processing paperwork and getting set up. Use the actual carrier deadline (often 30 days from hire) as the due date on a second verification sub-task.
9 Emergency contacts and policy acknowledgment HR {{issue.startDate.plusDays(2)}} Link the Confluence policies page in the task description. This is the most frequently missed Day 1 compliance item.
10 Welcome meeting and team introductions Manager {{issue.startDate}} The Jira task tracks completion; the calendar invite is separate. Link the Confluence meeting notes page as a resource on the task.
11 Buddy assigned and introduced by name Manager {{issue.startDate}} Name the buddy in the task description. Tasks that say "assign a buddy" without a name close as Done without action at a much higher rate than tasks with a specific person named.
12 Security training assigned Security {{issue.startDate}} Two separate sub-tasks: one to assign the training (Day 1) and one to verify completion (Day 5). A single task marked Done when assigned means no one checks if the training was actually finished.
13 Security training completion verified Security {{issue.startDate.plusDays(5)}} Check the training platform for completion status, not a self-reported checkbox. Separate from task 12.
14 Dev environment set up and verified Engineering {{issue.startDate.plusDays(5)}} Specify the verification steps in the description: clone the primary repo, run the test suite, confirm at least one test passes locally. "Set up dev environment" closes without verification.
15 First sprint task assigned Manager {{issue.startDate.plusDays(5)}} 1–2 low-stakes tasks from the existing backlog. The goal is for the new hire to complete the full Jira workflow before Week 2, which surfaces any permission gaps before they block real work.
16 Principle-of-least-privilege access review IT {{issue.startDate.plusDays(7)}} Review which Jira projects were inherited from project membership during onboarding. Remove any that don't apply to the role. Onboarding typically over-provisions.
17 30-day check-in and feedback Manager {{issue.startDate.plusDays(30)}} Add a field in the task for notes on checklist gaps. The 30-day check-in is also the primary signal for what the template is missing.
18 Goals and OKRs documented and linked Manager {{issue.startDate.plusDays(30)}} Link to the Confluence OKR page. Verbal goal-setting at Month 1 check-ins without a written record creates misalignment at the 90-day review.
19 Full access audit IT {{issue.startDate.plusDays(90)}} Enumerate every Jira project and third-party tool the new hire can access. Remove anything not explicitly granted for the role. Add a "completed-YYYY-MM-DD" label when done.
20 Onboarding Epic closed HR {{issue.startDate.plusDays(90)}} Transition Epic status to Done, add a "completed-YYYY-MM-DD" label, and link the 90-day review notes. The label lets you query "how many onboardings closed this quarter" via Jira's issue search.

Wiring the Automation trigger

Open Jira → Project Settings → Automation → Create rule. Use these exact settings:

  1. Trigger: Issue created. Scope it to the HR Operations project (not global), unless you need tasks created in multiple projects — in which case a global rule and Premium tier are required.
  2. Condition: Issue type = Epic AND Label = new-hire. Without the label condition, the rule fires for every Epic created in the project, including non-onboarding Epics. Add the label manually when creating each new hire's Epic, or create a second rule that adds the "new-hire" label automatically when the Epic summary starts with "Onboarding –".
  3. Action: Branch rule / related issues → Create issue. Add one branch action per sub-task in the 20-action template. Set Issue type to Sub-task on each. The Parent field is pre-filled to the triggering Epic; leave it as is.
  4. Component field: Add the Component field to each "Create issue" action and set it to the value in the Component column above (IT, HR, Manager, Security, or Engineering). Components must already exist in the project before the rule fires — create them under Project Settings → Components before deploying the automation rule.

Component default assignees must be set before the rule runs. Go to Project Settings → Components. Set the default assignee for IT, HR, Manager, Security, and Engineering. When the Automation rule creates a sub-task with a Component but no explicit Assignee, Jira assigns it to the Component's default. If the default is unset, the task lands unassigned with no notification.

Component vs label for department ownership

Labels route tasks visually but do not support default assignees. A sub-task labeled "IT" lands unassigned unless someone manually sets the assignee. Components support default assignees at the project level, which means IT tasks route to the IT admin automatically when the rule fires.

The practical consequence: with labels, every IT sub-task needs its Assignee field filled in manually during task creation — either in the automation rule (where you must hard-code a specific user, breaking when that person changes) or after the fact (where it frequently gets skipped). Components eliminate that choice. Set the default assignee once per Component, and the routing holds for every future hire without touching the automation rule.

Use labels as secondary classification if you need them (for example, "engineering-onboarding" as a label on role-specific tasks), but make Components the department ownership mechanism.

Role-specific field changes

The 20 tasks above apply to every hire. Role-specific tasks extend the base template without duplicating it.

Engineering additions (6 tasks)

Add these after task 14, with due dates as shown:

Sales additions (5 tasks)

HR / People Ops additions (4 tasks)

Two field configurations that break silently

The Assignee field versus Component default. If you set a specific Assignee in the "Create issue" action, you are hard-coding a person into the Automation rule JSON. When that person leaves or changes roles, every future hire gets their tasks routed to the wrong place, with no error message. Leave the Assignee blank in the action and rely on the Component default assignee. Update the Component default when someone changes roles; the Automation rule needs no edit.

The Due date field must be a Smart Value, not a static date. Jira's "Create issue" action in Automation accepts both static dates and Smart Value expressions in the Due date field. Static dates work for the first hire. By the third reschedule, you have 20 sub-tasks with due dates that no longer match the hire date and need a bulk edit. Smart Value expressions like those in the 20-action template resolve correctly whenever the rule fires, regardless of when that is.

At teams hiring three or more people per month, maintaining the Automation rule JSON as the onboarding task list evolves becomes its own overhead — new tasks, changed owners, updated due date windows. TeamOps ships the per-hire Epic, the Component-based ownership split, and these 20 sub-tasks as an editable role template inside Jira itself: you update the task list in the TeamOps admin screen rather than in Automation rule JSON, and the changes propagate to the next hire automatically. Free for teams up to 10 users.

Frequently asked questions

Do I need Jira Automation Premium to use this template?
Not if the onboarding project is self-contained. Jira Automation's multi-action rules run on the Free and Standard plans for team-managed projects. Premium is only required for global rules that create tasks across multiple projects simultaneously. If you want IT tasks in a separate IT project and HR tasks in an HR project, that cross-project action requires Premium. The straightforward alternative: keep all 20 sub-tasks inside one dedicated HR Operations project with Components for department filtering — single-project rules work on Free.
What happens if a hire date changes after the Automation rule has created the sub-tasks?
Smart Value expressions resolve at the moment the "Create issue" action fires. After that, each sub-task's due date is a fixed calendar date. Changing the parent Epic's start date does not cascade. Fix it with a bulk edit: from the Epic's sub-task list, select all, choose Bulk Change → Edit Fields → Due Date and set the corrected phase date per group. For teams that reschedule frequently, a second Automation rule triggered by "Epic start date changed" can bulk-update linked sub-tasks automatically.

Onboarding access granted is offboarding access revoked — the offboarding checklist maps directly onto the Components and task structure set up here.

If maintaining the Automation rule JSON is the bottleneck, TeamOps runs this inside Jira as an editable role template — no JSON required. Free for up to 10 users