---
title: "Search box"
canonical: "https://support.appfire.com/space/DLP/2212496347/Search%20box"
format: markdown
---
> Macro (aura-html)

## Overview

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](https://appfire.atlassian.net/wiki/spaces/DLP/pages/2211711655):

- [Overview](https://appfire.atlassian.net/wiki/spaces/DLP/pages/2212233373) (text search mode only)
- [Gantt](https://appfire.atlassian.net/wiki/spaces/DLP/pages/2211872959)
- [Scope](https://appfire.atlassian.net/wiki/spaces/DLP/pages/2212004592)
- [Board](https://appfire.atlassian.net/wiki/pages/createpage.action?spaceKey=dlp&title=OLD%20Board%20module&linkCreation=true&fromPageId=2212496347)
- [Risks](https://appfire.atlassian.net/wiki/spaces/DLP/pages/2211580158)
- [Calendar](https://appfire.atlassian.net/wiki/spaces/DLP/pages/2212004303)
- [Resources](https://appfire.atlassian.net/wiki/spaces/DLP/pages/2211938799)
- [Teams](https://appfire.atlassian.net/wiki/spaces/DLP/pages/2212004695) (text search mode 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-jql.png](media://c9c354f1-309d-4ebb-8e63-cd3e18f855e1)

### Text search

You can use the text fields and the task key in most modules to locate your tasks. Available text fields depend on your [connected tools](https://appfire.atlassian.net/wiki/spaces/DLP/pages/2211938761) (Trello, Jira, etc.).

Text search also applies to [basic tasks](https://appfire.atlassian.net/wiki/spaces/DLP/pages/2211352313).

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

- Key (text 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

![text-search.png](media://dcba0de7-6a7e-40c6-9c77-e3a49531f7ca)

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.

### Text search limitations - use of square brackets

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

## JQL Search

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

![jql-search.png](media://de3b1cf7-3d75-49e7-bdba-2170596fe9d2)

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

![Incorrect JQL query highlighted in red](media://4adab9b7-c136-4a42-b0fa-53ab9fe8b5aa)

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.

## Active search

The active search box will be cleared automatically when you switch to another module and then return to the previous module.

## 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

![snapie-to-result.png](media://deb71bdc-c72e-429c-826a-ab5f0dbe6b62)

### 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.

![snipe-to-result.png](media://9a3cc3ea-2c19-45d8-8dbe-a03a7a942dad)

You can easily switch between the results by using the arrows in the search box.

- 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 when using Jira filters** 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).

![show-basic-tasks.png](media://c24bb904-d959-494b-ab87-240d4bfa3c08)

## Snipe to task

The option is available in the Gantt module, Change History panel.

The "**snipe to task" **button takes you to a task and selects it. 

![change-history-snipe.png](media://aab8472c-3df3-4a2d-b15c-5c1dd4be7745)

## Clear the search

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