Close
View this page in your language?
All languages
Choose your language
Getting started
Introduction to Jira
Jira for Teams
7 Steps to Get Started in Jira
Projects
Overview
Tutorials
Resources
Boards
Overview
Tutorials
Resources
Issues
Overview
Tutorials
Resources
Workflows
Overview
Tutorials
Resources
Integrations
Overview
Tutorials
Resources
Reports and Dashboards
Overview
Tutorials
Resources
Insights
Overview
Tutorials
Resources
Permissions
Overview
Tutorials
Resources
JQL
Overview
Tutorials
Cheat sheet
Resources
Automation
Overview
Tutorials
Resources
Timeline
Overview
Tutorials
Resources
Advanced planning
Overview
Tutorials
Resources
Mobile Apps
Overview
Tutorials
Resources
More about Jira
Editions of Jira
Hosting options

Jira issues tutorials

Create an issue

Select “Create” in the top navigation. Your issue will appear in the backlog or board of the project.

video thumbnail

Find an issue

Perform a global search and find an issue across the entire site

The search bar in the top navigation enables you to quickly search for issues across the whole instance via issue ID or keywords. You can narrow down your search by project, assignee, and/or status.

Perform a contextual search and find an issue in the project’s board, roadmap, or backlog view

Search bars can be found in the roadmap, backlog, and board view. Issues would appear in the search results if these issues can be found that particular view.

Find an issue in a given project via Issue Navigator

Navigate to “Issues” in the sidebar navigation. Toggle between “Basic” or “JQL” modes in the top right of the screen. In Basic mode, you can type keywords in the search bar and/or use the dropdown menus to filter issues by project, issue type, status, assignee, and any fields that an issue can have. In JQL mode, you to build structured queries using the Jira Query Language (JQL) to search for issues.

Please note that the Issue Navigator is not available by default in team-managed projects. Enable this feature by going to Project Settings > Features > Issue navigator.

Add an issue type to a project

In team-managed projects:

  1. Select “Project Settings” in the sidebar navigation on the left, then select “Issue types”, then hit “+ Add issue type”.
  2. Drag and drop the types of fields you’d like to have in the issue type, and give each field type a name. You could also set the default values for each field if you’d like.

In company-managed projects:

How to link issues

  1. Open an issue.
  2. Select Link issue at the top of the issue modal.
  3. Choose the type of issue link (for example, "this issue is blocked by...").
  4. Specify the issue(s) you want to link to by typing the full issue key (for example, ABC-123).
  5. Select Link.

Configure an issue’s layout

  1. Select any issue from your board.
  2. In the bottom right of the issue view, select Configure.
  3. Drag and drop issue fields in the appropriate regions.