Issues
Issue Types
EpicLarge body of work; contains stories
StoryUser-facing feature or requirement
TaskUnit of work (technical or non-technical)
BugDefect or unexpected behavior
Sub-taskChild of story/task; cannot exist alone
Issue Fields
SummaryShort title (required)
DescriptionDetails, acceptance criteria
AssigneePerson responsible
PriorityHighest / High / Medium / Low / Lowest
LabelsFreeform tags for grouping
ComponentsProject subsections (e.g., Backend, UI)
Fix VersionRelease this issue targets
Story PointsEffort estimate (Scrum)
Issue Links
blocks / is blocked byDependency relationship
clones / is cloned byDuplicate tracking
relates toGeneral association
is caused by / causesRoot cause linkage
JQL Search
Basic Syntax
project = MYPROJ AND status = "In Progress" assignee = currentUser() AND resolution = Unresolved priority in (High, Highest) ORDER BY created DESC
Operators
=Exact match
!=Not equal
in (a, b)Match any in list
not in (a, b)Exclude list
~ "text"Contains (text search)
!~ "text"Does not contain
is EMPTYField has no value
is not EMPTYField has a value
> < >= <=Comparison (dates, numbers)
Date Functions
created >= -7d # last 7 days due <= endOfWeek() # due this week updated >= startOfMonth() # updated this month created >= "2025-01-01" # since specific date
Useful JQL Patterns
# Stale issues status != Done AND updated <= -30d # My open bugs assignee = currentUser() AND type = Bug AND resolution = Unresolved # Sprint scope sprint in openSprints() AND project = MYPROJ
Workflows
Default Workflow
To DoNot started
In ProgressWork underway
DoneCompleted
Extended Workflow
OpenCreated, awaiting triage
In ProgressActively being worked on
In ReviewCode review or QA
DoneAccepted and closed
ReopenedReturned from Done
Workflow Concepts
StatusCurrent state of an issue
TransitionAllowed move between statuses
ConditionWho can perform a transition
ValidatorChecks before transition executes
Post FunctionAction after transition (e.g., assign)
ResolutionWhy issue was closed (Fixed, Won't Do)
Boards
Board Types
Scrum BoardSprint-based; backlog, sprint planning, velocity
Kanban BoardContinuous flow; WIP limits, no sprints
Board Columns
ColumnMaps to one or more statuses
WIP LimitMax issues in column (Kanban)
SwimlaneHorizontal grouping (by epic, assignee, etc.)
Quick FilterJQL-based toggle filter on board
Board Configuration
FilterJQL query defining board scope
EstimationStory Points or Original Estimate
Card LayoutFields shown on issue cards
Card ColorsColor by priority, assignee, query
Sprints
Sprint Lifecycle
CreateName + optional goal and dates
PlanDrag issues from backlog into sprint
StartSet duration (1-4 weeks typical)
ActiveTeam works on sprint issues
CompleteMove undone items to backlog or next sprint
Sprint Reports
Burndown ChartRemaining work vs time
Sprint ReportCompleted vs not completed
Velocity ChartStory points per sprint over time
Cumulative FlowStatus distribution over time
Sprint JQL
sprint in openSprints() # current sprint sprint in futureSprints() # upcoming sprints sprint = "Sprint 12" # specific sprint sprint in closedSprints() AND resolution = Unresolved
Filters
Creating Filters
SearchWrite JQL in issue search
Save AsSave JQL as named filter
StarStar a filter for quick access
SubscriptionEmail filter results on schedule
Sharing & Permissions
PrivateOnly you can see the filter
GroupShare with a specific group
ProjectShare with project members
PublicAny logged-in user
Edit PermissionsControl who can modify the filter
Dashboards
Filter ResultsGadget showing issues from a filter
Pie ChartBreakdown by field (priority, assignee)
Two DimensionalX/Y matrix (e.g., priority vs status)
Activity StreamRecent project activity
Shortcuts
Global Navigation
g then dGo to dashboard
g then bGo to board
g then iGo to issue search
/Quick search
cCreate issue
?Show keyboard shortcuts
Issue View
aAssign to me
mComment
lEdit labels
eEdit issue
j / kNext / previous issue in list
oOpen selected issue
Board Shortcuts
1-9Move issue to column 1-9
tToggle detail view
nNext card
pPrevious card
Common Patterns
Bug Report Template
Summary[Component] Short description of the bug
Steps to ReproduceNumbered steps to trigger the issue
ExpectedWhat should happen
ActualWhat actually happens
EnvironmentOS, browser, version, etc.
SeverityBlocker / Critical / Major / Minor / Trivial
Story Format
As a [role], I want [action], so that [benefit]. --- Acceptance Criteria: - [ ] Criterion 1 - [ ] Criterion 2
Bulk Operations
Search → Select AllSelect issues from search results
Bulk ChangeEdit, transition, or delete in batch
CSV ExportExport search results for reporting
Board dragDrag issues between columns/sprints