Skip to main content

Search Inside Feature Files

Several attributes of a Feature as well as its text become searchable using JQL. Being able to search for attributes can be particularly useful for improving your Sprint and Backlog Jira boards.

Search for Feature Text

The name of the field that you need to use is 'Feature.content'. Navigate to the Search for Issues page and use the '~' (tilde) character to search for the required text.

image-20241013-112240.png

Depending on your preferences menu options the Feature panel might be loaded in Gherkin Text Editor mode rather than Example Mapping, so you will see textual representation rather like below.

image-20241013-112636.png

info

Search for issues with Features

Query below can be used to find all Jira issues where the Feature panel has at least some text

Feature.content IS NOT EMPTY

image-20241014-191106.png

Search for Feature Attributes

The following list of attributes are searchable with JQL:

Feature.userStories

Type - Number

Description: how many User Stories the Feature contains. A User Story in this case means that there are 3 common keywords: ‘As a', ‘I want to’ and ‘So that’ after the Feature keyword and there is some text after each of these keywords. 'In order to’ keyword can be used instead of ‘So that’.

Examples

Feature.userStories = 0

Could be used to identify Jira issues that have some Feature text but are missing key pieces of information such as who the user or the stakeholder is for whom the story is valuable and/or why exactly the story is needed, or in other words ‘As I' or 'So that’ keywords are missing.

image-20241013-122609.png

Feature.userStories > 1

Could be used to identify Features that contain more than one User Story and therefore should be split into further Jira issues.

image-20241013-122849.png

Feature.questions

Type - Number

Description: total number of questions the Feature contains. Questions are comment lines prefixed with “Q:“ keyword, see more in Questions & Answers.

Feature.unansweredQuestions

Type - Number

Description: total number of unanswered questions, i.e. those that do not have the 'A:' keyword on line below, see more in Questions & Answers.