projectMatch

The projectMatch function allows you to find issues based on projects whose keys match a specified text pattern. This function is particularly helpful for:

Managing large-scale Jira instances with numerous projects, allowing for quick segmentation and access to relevant projects.
Facilitating cross-project reporting and analytics by dynamically grouping projects according to naming conventions or identifiers.
In environments where projects are consistently named according to specific patterns or standards.

Syntax and parameters:

projectMatch(Pattern Match)

Pattern match: A text pattern for matching project keys.
Syntax: Our example below uses regex syntax. You can refer to this website which is a regular expressions builder that can help you build an expression and provides definitions for each of the characters.

Example

Identifying all projects with a common prefix:

To find all projects that start with a common prefix, such as "DEV" for development projects:

project in projectMatch("^DEV.*")

This query is invaluable for quickly accessing all development-related projects, particularly in organizations where projects are systematically named.

Tip:

Careful construction of the pattern match: Ensure that the Pattern Match used is precise to avoid including unintended projects in your results.
Regular review of naming conventions: Maintain and review project naming conventions regularly to ensure that they continue to support effective use of the projectMatch function.
Combine with other JQL functions: To further refine your queries, combine projectMatch with other JQL functions and filters, such as status, issueType, or component, to create comprehensive views of project data.