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

The search box is available in the following [modules](https://appfire.atlassian.net/wiki/pages/createpage.action?spaceKey=bpedc&title=000%20BigPicture%20modules&linkCreation=true&fromPageId=2534540281):

- [Overview](https://appfire.atlassian.net/wiki/pages/createpage.action?spaceKey=bpedc&title=000%20Overview%20module&linkCreation=true&fromPageId=2534540281) (text search mode only)
- [Gantt](https://appfire.atlassian.net/wiki/pages/createpage.action?spaceKey=bpedc&title=000%20Gantt%20module&linkCreation=true&fromPageId=2534540281)
- [Scope](https://appfire.atlassian.net/wiki/pages/createpage.action?spaceKey=bpedc&title=000%20Scope%20module&linkCreation=true&fromPageId=2534540281)
- [Board](https://appfire.atlassian.net/wiki/spaces/DLPDRAFT/pages/297567561)
- [Risks](https://appfire.atlassian.net/wiki/pages/createpage.action?spaceKey=bpedc&title=000%20Risks%20module&linkCreation=true&fromPageId=2534540281)
- [Calendar](https://appfire.atlassian.net/wiki/pages/createpage.action?spaceKey=bpedc&title=000%20Calendar%20module&linkCreation=true&fromPageId=2534540281)
- [Resources](https://appfire.atlassian.net/wiki/pages/createpage.action?spaceKey=bpedc&title=000%20Resources%20module&linkCreation=true&fromPageId=2534540281)
- [Teams](https://appfire.atlassian.net/wiki/pages/createpage.action?spaceKey=bpedc&title=000%20Teams%20module&linkCreation=true&fromPageId=2534540281) (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://b7eb497e-2fe5-4caa-84c1-095fc62e5cdc)

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

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

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://d141a934-7573-42b2-bc4b-011b5eea2a11)

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://42c565ae-08e6-4b45-8139-dac29c2368e0)

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

![Incorrect JQL query highlighted in red](media://5a4dc3c7-b1f8-4c26-892d-338412f2acd7)

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://1582c742-ab80-44d6-846e-12c0cbd8a947)

### 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://c28ff8df-30cf-4b96-83bd-5962e1e5e36b)

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://c99f1add-a64e-41e4-8033-3793d873c908)

## 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://2b15e127-3727-4254-827c-821aab6a7fd9)

## Clear the search

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