1) Mapping Common PM Artifacts to Jira Concepts
Jira represents work as issues inside a project. Each issue has an issue type (what kind of work it is), fields (metadata like owner, dates, estimates), a status (where it is in the process), and it moves through a workflow (the allowed path between statuses). Project managers translate real-world project artifacts into these building blocks so work is visible, searchable, and reportable.
Project scope and deliverables
- Scope / deliverables → Epics (large outcomes) and Stories/Tasks (work items that produce the outcome)
- Work breakdown structure (WBS) → Epic → Story/Task → Sub-task hierarchy (where appropriate)
- Acceptance criteria → Issue description sections or dedicated fields (e.g., Acceptance Criteria) depending on your configuration
Milestones, phases, and dates
- Milestones → Often best represented as Versions/Releases (e.g., “Release 1.0”, “Pilot Launch”), sometimes as a dedicated Milestone issue type if your team uses one
- Target dates → Due date field on issues, and/or Fix Version (the version the work is intended to ship in)
- Phases (Discovery, Build, UAT) → Usually represented by workflow statuses or boards (separate boards per phase) rather than creating “phase” issues
Risks, issues, decisions (RAID)
- Risks → A dedicated Risk issue type (if available) or a standard issue type with a “Risk” label and fields like Probability/Impact/Mitigation
- Issues (impediments) → Bug (if product defect) or Task (if operational blocker); track owner, due date, and next action
- Decisions → A dedicated Decision issue type (if available) or a Task with a “Decision” component/label; include decision statement, options, and approvers in the description
Dependencies and cross-team coordination
- Dependencies → Issue links such as
blocks/is blocked by,relates to; for delivery sequencing use versions and roadmap views (if enabled) - External dependencies (vendors, other departments) → Track as issues in a shared project or as linked issues across projects; assign an internal owner and due date
Ownership, accountability, and reporting
- RACI / ownership → Assignee (who does the work) and Reporter (who raised it); some teams add custom fields for “Accountable” vs “Responsible”
- Status reporting → Use statuses for process state, and fields like Fix Version, Components, and Labels for slicing reports
Quick reference table: PM artifact → Jira building block
| PM artifact | Recommended Jira representation | Notes |
|---|---|---|
| Scope / deliverable | Epic | Name epics as outcomes, not activities |
| Work package | Story or Task | Prefer Story when there is user value; Task for internal work |
| Checklist steps | Sub-tasks | Use when multiple people/hand-offs are needed |
| Milestone | Version/Release | Use Fix Version to group work for the milestone |
| Risk | Risk issue type / labeled Task | Track mitigation as linked tasks |
| Dependency | Issue links (blocks) | Make dependency direction explicit |
| Team area | Component | Useful for routing and reporting |
2) Guided Tour: Where to Find Work, Filters, and Search
As a project manager, your day-to-day navigation usually revolves around: (a) the project view, (b) the board/backlog, and (c) search and saved filters. The goal is to quickly answer: “What’s in scope?”, “What’s in progress?”, “What’s at risk?”, and “What changed since last check-in?”
Find the project and understand its structure
Step-by-step:
- Open Jira and go to Projects → select your project.
- Scan the left navigation for key areas (names vary by Jira setup): Backlog, Board, Issues, Releases (Versions), Components, Reports.
- Open Project settings (if you have access) to see configured issue types, workflows, and fields. This helps you avoid inventing new conventions that conflict with the configuration.
Where to see “all work” vs “work in motion”
- Project Issues list: best for a complete inventory. You can sort, group, and bulk-edit (permissions permitting).
- Board: best for work in motion. Columns map to statuses (or groups of statuses). Use it for standups and flow discussions.
- Backlog (Scrum): best for upcoming work, prioritization, and sprint planning. It typically shows Epics, the backlog list, and sprints.
Using search effectively (basic and advanced)
Jira search is your fastest way to build repeatable views for status reporting. Most instances support both a visual query builder and an advanced query language (JQL).
Step-by-step: build a useful filter for weekly status
- Listen to the audio with the screen off.
- Earn a certificate upon completion.
- Over 5000 courses for you to explore!
Download the app
- Go to Filters → Advanced issue search (or Issues → Search).
- Start with project scope: select your project.
- Add constraints that match your reporting need: status, assignee, fix version, component, updated date.
- Save the filter with a clear name (e.g., “PM: Weekly status – Project X”).
Example JQL patterns (adapt field names to your Jira):
-- All open work in the project (excluding Done category statuses if configured that way is better, but status list works too) project = PROJ AND status not in (Done, Closed, Resolved) ORDER BY priority DESC, updated DESC -- Items updated in the last 7 days (great for “what changed?”) project = PROJ AND updated >= -7d ORDER BY updated DESC -- Work planned for a milestone/release project = PROJ AND fixVersion = "Release 1.0" ORDER BY rank ASC -- Risks (if you use an issue type) project = PROJ AND issuetype = Risk ORDER BY priority DESC -- Blocked work (dependency management) project = PROJ AND issueLinkType = "is blocked by" AND status not in (Done) Understanding fields that PMs use most
- Issue type: determines how the item behaves (e.g., can it have subtasks, does it appear in backlog).
- Status: current state; should reflect process, not a person’s opinion.
- Assignee: who is doing the work now; avoid leaving critical items unassigned.
- Fix Version: planned release/milestone bucket; powerful for milestone reporting.
- Component: functional area or subsystem; useful for routing and reporting.
- Labels: flexible tags; use sparingly and only with agreed conventions.
- Priority: urgency/importance; align meaning with stakeholders.
- Due date: date commitment; clarify whether it is a target or a hard deadline.
Boards, backlogs, and sprints: what they mean operationally
- Board: a visualization of work filtered by a query (board filter). If an issue doesn’t match the filter, it won’t appear—this is a common source of confusion.
- Backlog: prioritized list of work not yet in progress (and often includes future sprint candidates). Epics help group backlog items by outcome.
- Sprint: a timeboxed iteration. Issues are committed into a sprint and tracked until completion or removal. For PMs, sprint scope changes should be explicit and visible.
Versions/Releases and Components: two different grouping tools
- Version/Release answers: “What milestone does this ship with?” Use it for release readiness and milestone burn-up/down reporting.
- Component answers: “What area does this belong to?” Use it for ownership routing (e.g., Backend, Mobile, Data) and impact analysis.
3) Exercise: Epic vs Story/Task vs Sub-task
This exercise helps you classify work so your backlog stays readable and reporting stays consistent. Use the rule of thumb: Epics describe outcomes, Stories/Tasks describe deliverable work, and Sub-tasks describe execution steps that are only meaningful within a parent item.
Classification rules you can apply quickly
- Epic: too large to complete in one sprint (or within your team’s normal planning horizon); contains multiple Stories/Tasks; represents a capability, deliverable, or major milestone outcome.
- Story: delivers user or stakeholder value; can be completed within a sprint; has clear acceptance criteria.
- Task: discrete piece of work that may not be user-facing (e.g., environment setup, data migration), but still deliverable and trackable.
- Sub-task: a step to complete a Story/Task; typically owned by one person; not used for cross-team commitments.
Scenario: “Customer Onboarding Improvement” initiative
Classify each item as Epic, Story/Task, or Sub-task. Then check the suggested answer.
- A) “Reduce onboarding time from 5 days to 2 days by automating account provisioning.”
- B) “Add self-serve ‘Upload documents’ page to onboarding portal.”
- C) “Create API endpoint for document upload.”
- D) “Update copy on onboarding emails to reflect new steps.”
- E) “Write unit tests for document upload endpoint.”
- F) “Coordinate legal review of updated onboarding terms.”
Suggested classification:
- A → Epic (outcome with multiple workstreams)
- B → Story (user-facing value, can be accepted)
- C → Story or Task (depends on whether your team writes technical work as Stories; either is fine if consistent)
- D → Task (content change; still deliverable)
- E → Sub-task under C (execution step tied to the parent)
- F → Task (cross-functional work item with owner and due date)
Step-by-step: turn the scenario into a clean Jira structure
- Create the Epic for item A and ensure the summary is outcome-based.
- Create Stories/Tasks for B, C, D, F and link them to the Epic using the Epic field.
- Create Sub-task E under the parent item (C) so testing is visible but not cluttering the top-level backlog.
- Add Fix Version if these are intended for a specific milestone (e.g., “Q2 Onboarding Release”).
- Add Components to route ownership (e.g., Portal, Backend, Legal/Compliance if your Jira supports it).
- Add dependency links if needed (e.g., B
is blocked byC).
4) Team Alignment Checklist: Terms to Standardize to Avoid Inconsistent Usage
Misalignment in Jira terminology creates noisy boards, misleading reports, and stakeholder confusion. Use this checklist in a 15–30 minute working session with the delivery team and key stakeholders.
Issue types and when to use them
- What qualifies as an Epic in this team? (size threshold, outcome wording, expected lifetime)
- When do we create a Story vs a Task? (user value vs internal work)
- When are Sub-tasks required vs optional? (handoffs, testing, documentation)
- How do we represent Risks and Decisions? (dedicated issue types vs labels/components)
Status and workflow meaning
- What does each status mean in observable terms? (entry/exit criteria)
- Which statuses indicate work in progress vs waiting vs done?
- Do we use a specific status for blocked work, or do we rely on a flag/field?
- Who is allowed to transition issues (anyone vs specific roles)?
Fields and conventions
- Fix Version: is it mandatory for milestone-tracked work? Who sets it and when?
- Due date: is it a target or a commitment? What happens when it changes?
- Components: what is the official component list? Who maintains it?
- Labels: which labels are approved (e.g.,
risk,dependency,customer-commitment) and which are discouraged? - Priority: what does each level mean (SLA, business impact)? Who can change it?
- Estimation: what field is used (story points, time estimate) and what is it used for (capacity planning vs forecasting)?
Boards, backlogs, and scope visibility
- What is the board filter and what does it include/exclude? (projects, issue types, statuses)
- Where should stakeholders look for the “official” scope: backlog, releases, or a saved filter?
- How are sprint scope changes handled and communicated?
Dependencies and cross-project work
- Which issue link types are standard for dependencies (e.g.,
blocks)? - How do we track dependencies on other teams: linked issues, shared components, or a dedicated dependency issue type?
- What is the escalation path when a dependency is at risk (who updates Jira, who communicates externally)?