JIRA - Search

Jira - Searching for Issues

Jira offers powerful and flexible search capabilities to help you find issues across projects, versions, and components. You can save your search criteria as ‘filters’ for reuse and share them with your team or use them in dashboards and reports.

Primary Search Methods

Jira primarily offers two ways to search for issues:

• Basic Search: A user-friendly, form-based interface.
• Advanced Search (JQL): Uses Jira Query Language for complex and precise queries.
• Quick Search: For fast lookups by issue key or keywords.

Basic Search

Basic Search provides an intuitive way to find issues without needing to know JQL. To perform a Basic Search:

1. Navigate to ‘Issues’ in the top navigation bar, then select ‘Search for issues’ (or a similar option like ‘View all issues and filters’).
2. If a previous search is active, you might see its criteria. You can click ‘New filter’ or modify the existing criteria.
3. Use the dropdown menus to select criteria for fields like ‘Project’, ‘Issue Type’, ‘Status’, and ‘Assignee’.
4. Click ‘More’ to add criteria for other standard or custom fields.
5. Enter keywords in the text search box (often labeled ‘Contains text’) to find issues with specific terms in their summary, description, or comments.

While using Basic Search, Jira is constructing a JQL query in the background. You can often switch to ‘Advanced Search’ to see and edit this JQL.

Advanced Search (JQL)

For more complex queries, Jira Query Language (JQL) provides a powerful and flexible syntax. To use JQL:

1. Navigate to the issue search page as described for Basic Search.
2. If you are in Basic Search mode, click the ‘Switch to JQL’ or ‘Advanced’ link (the exact wording may vary).
3. Enter your JQL query into the search bar. Jira provides auto-complete suggestions to help you build valid queries.

Common JQL Examples:

• Find issues assigned to the current user: assignee = currentUser()
• Find issues reported by the current user: reporter = currentUser()
• Find issues in a specific project: project = "Project Alpha" or project = "PROJA" (using project key)
• Find open bugs: issuetype = Bug AND status = Open
• Find issues created in the last 7 days: created >= -7d
• Find issues mentioning ‘performance’ in text fields: text ~ "performance"
• Find issues with no due date: duedate IS EMPTY

JQL supports various operators (e.g., =, !=, >, <, IN, NOT IN, IS, IS NOT), keywords (e.g., AND, OR, NOT, ORDER BY), and functions (e.g., currentUser(), now(), membersOf()).

Saving and Managing Searches (Filters)

Once you’ve defined your search criteria (either via Basic or Advanced Search):

1. Click the ‘Save as’ button (usually located above the search results).
2. Enter a descriptive name for your filter and click ‘Submit’ or ‘Save’.
3. Your saved filter will appear in the sidebar (often under ‘Favorite filters’ or ‘My open issues’, etc.). You can manage your filters, share them with others, or subscribe to receive email notifications for filter results.

Quick Search

The Quick Search bar, typically located in Jira’s main navigation header, is the fastest way to find specific items.

• Enter an issue key (e.g., PROJ-123) to jump directly to that issue.
• Type keywords to search across issue summaries, descriptions, and comments.
• Use ‘smart queries’ (Jira often suggests these as you type):
• my open issues: Shows issues assigned to you that are not resolved.
• r:me: Issues reported by you.
• You can also type parts of project names or user names.

Practical Application

Effective searching is crucial for daily work in Jira. Saved JQL filters are extensively used to create custom dashboards for monitoring project health, tracking team progress, managing personal workloads (e.g., ‘my critical bugs due this week’), or generating specific reports for stakeholders.

Common Learning Obstacle: Mastering JQL syntax, especially for custom fields or more complex logical conditions, can take practice. Utilize Jira’s JQL auto-complete feature and refer to the official Atlassian JQL documentation for a comprehensive list of fields, operators, and functions.