---
title: "Search Box."
canonical: "https://support.appfire.com/space/DLP/298060889/Search%20Box."
format: markdown
---
| **Contents:**<br>> Macro (toc) |
| --- |

> Macro (excerpt)
> 
> The** search box** functionality lets you quickly find the things of your interest and filter out unwanted tasks or Boxes. The Search box operates in two modes:
> 
> - Text search mode filters information based on the Jira summary field (Boxes and tasks)
> - JQL mode filters tasks using JQL queries
> 
> The search box is available in the following modules:
> 
> - **Overview (text search only)**
> - **Gantt**
> - **Scope**
> - **Board**
> - **Risks**
> - **Calendar**
> - **Resources**
> - **Teams (text search only)**

## Search modes

The text search is the default mode. Click the icon next to the search field to switch between the TEXT and the JQL modes:

![Text search in the Gantt chart](media://7b59e3bf-ebf2-4709-8c1e-153d2040c4ac)

![Text search field](media://8a44d460-412e-4429-9343-cb56c8e62f83)

![JQL search field](media://da4bb603-c986-447f-8674-014ed09135c0)

## Text search

**You can use the text fields and the task key in most modules to locate **<span style="color: #0e101a">**your tasks**</span>**.** Available text fields depend on your connected tools (Trello, Jira, etc.). 

<span style="color: #0e101a">TXT search also applies to </span><span style="color: #0e101a">[Basic tasks](https://appfire.atlassian.net/wiki/spaces/DLP/pages/297702042)</span><span style="color: #0e101a">. </span>

For example, the search checks the contents of **all text fields** of Jira issues, such as:

- Key (TXT search will also go over the task key field)
- Summary
- Description
- Environment
- Comments
- Custom fields
  - Free text field (unlimited text)
  - Text field (<225 characters)
  - Read-only text field

![Usage of the text search field](media://e897fa09-c4c0-4494-9d7c-8c3013f60438)

![Search text visible in results](media://d34e3f00-6414-4dd6-9476-2bb85d739d1a)

![Text search visible in a related Jira issue](media://bf1d46d4-8f1e-4e83-805a-08f6de05d8dc)

![Search text visible in a related Jira issue](media://62eacd9b-99db-4cf6-9242-d91868345f32)

![Search text visible in related Jira issue, Environment field](media://78bf8740-dba9-4e5c-b002-86094d1ca583)

In the case of the Overview module, which shows Boxes, you can text search using:

- Box Id
- Box Name
- Box Summary
- Box Description

> ℹ️ Search applies also to a hidden column(s). The box with results is visible once the search criteria are met.

For example, the word 'project' is used in the description of two Boxes as below:

![Search text in the Overview module](media://ce5affc8-34d5-4ae2-9310-22bdd8c1c197)

### Text search limitations - use of square brackets

:cross_mark: The text search does NOT support using square brackets - the Jira' text~' search applies limitations.

![Usage of brackets in search text](media://7a128a77-4a13-4e74-950d-c937caf281c7)

## JQL Search

Start typing in the search box to open the JQL drop-down, which will help you find the query.

![Search suggestions displayed under search field](media://f74d8b1b-27f3-4aaf-a183-194732434547)

The icon will change to red if the JQL query you typed is incorrect.

![Incorrect JQL query highlighted in red](media://6c16a01d-c9c7-4223-9d41-c86448ff18ef)

For example, to search for a task in the Done status category, type in the following JQL query: "`statusCategory = Done`".

> ℹ️ ["](https://appfire.atlassian.net/wiki/spaces/DLP/pages/298027991)The App does NOT support ORDER BY" JQL - therefore, it can't be executed.

## Apply filters

You can see an orange dot on the filter icon when the filter is active.

Tasks that do NOT match the filter will be grayed-out. This applies to parent tasks, so you can trace how lower-level tasks contribute to higher-level items.

## > Macro (anchor)

Snipe to result

![The Snipe to result option highlighted](media://9e7e9a71-6788-4c3d-a99a-63534306feea)

### Availability

The feature is available in the following modules:

- Gantt
- Scope
- Board (Backlog)

Use the **Snipe to result** option to highlight all tasks that fit the search criteria. It works similarly to the "Ctrl+F" feature in any web browser. The whole row is highlighted not only a searched text. Tasks are visible on the WBS and chart (timeline). 

How does **Snipe to result **work?

- Highlights all items matching the search (the currently selected task is highlighted with a darker color).
- Expands the task tree to make the results visible.
- It takes you to each item.
- Counts the number of matches.
- Works in both TEXT and JQL modes.

![The Gantt chart, highlighted search result](media://6a58b582-f349-4a7d-a1a5-2b16ef7d9ab2)

You can easily switch between the results:

![Number of search results displayed](media://c7da6ed5-2f04-4c83-82a5-cc7d3e9f7798)

- Snipe can be turned on/off at any point. Turning it on/off does NOT affect the search itself (doesn't clear it). In other words, the 'snipe' option changes how the 'search' filter behaves. It is a modification of a search filter function.
- Tasks in the Infobar are NOT highlighted.

**Note**: If a filer option **Show basic tasks (filters don’t apply)** is active, **all** basic tasks are included in the search results. When you snipe between the tasks, basic tasks are included in the rotation (even when they don’t match the search query).

![The Show basic tasks (filters don't apply) option checked](media://cd76a0b8-ed99-4fec-b561-c5f89df3c0e7)

## Clear the search

To clear the search box, delete your search query, press Enter, or click the magnifying glass button.