---
title: "Search box"
canonical: "https://support.appfire.com/space/BGc/3540452124/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

## 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://94e9fb0e-5100-4477-a80f-7df1d18a3aa7)

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

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

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://035ecdd2-7d20-461c-aa21-b36857693797)

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://e48b93f3-7be2-49b5-9bf7-7252191655e9)

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

![Incorrect JQL query highlighted in red](media://6ae4db47-3c9f-40a6-9e6c-30ba8a99884e)

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://f77b284e-a027-4b6d-9905-18064fcb6db4)

### 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://bf5d171a-df37-429c-a240-42a1267171c4)

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://d743617a-eb3b-4f64-8763-d56ad1bc80b9)

## 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://624ba15c-c7d6-4044-b25e-685d2767d202)

## Clear the search

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