---
title: "Search box"
canonical: "https://support.appfire.com/space/BGdc/3525181708/Search%20box"
format: markdown
---
## 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

## 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://5aa3d4f4-a9e6-4c31-8c38-ac05927c7c7c)

### 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/BGdc/pages/3525509186) (Trello, Jira, etc.).

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

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://5b8617e8-ccd1-4fe8-ae43-ab6e33def7d8)

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://9abfdbf4-6571-475a-ab93-ac20d3510222)

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

![Incorrect JQL query highlighted in red](media://799393ee-24a9-4b1c-b220-cee9ae30265d)

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://1e53eddc-e10e-4254-b57e-8eb64427b461)

### 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://58dad4e0-079f-4971-bcc4-85d17f8f678f)

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://d2468e1c-f24f-49ef-b38b-ab21d3f6f21e)

## 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://a9f7f264-ddac-49e3-9860-cc555aaef964)

## Clear the search

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