> For the complete documentation index, see [llms.txt](https://docs.ox.security/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.ox.security/get-started/searching-and-filtering-in-ox/ox-search-and-filters.md).

# Searching and Filtering Data

## About Search and Filters

Use the unified search and filtering interface to find information in OX tables and narrow the displayed results. You can search table data, locate filters, and combine multiple filters to refine your results.

You can also use AI Search to identify relevant filters based on natural-language requests.

To save and reuse your preferred filters, columns, and sorting preferences, see [Managing Views](https://docs.ox.security/analyze-with-ox/analyzing-scan-results/issues/managing-views.md). Views are currently available on the Active Issues page.

## Search options

The search field provides the following options:

| Option            | Description                                                                                               |
| ----------------- | --------------------------------------------------------------------------------------------------------- |
| Search table data | Searches for text in the table without requiring you to select a filter.                                  |
| Search filters    | Finds filters that match the entered text. For example, entering `severity` displays the Severity filter. |
| AI Search         | Interprets a natural-language request and attempts to apply relevant filters automatically.               |

When you enter a search term, OX displays matching filters and an option to search the table directly.

## Searching table data

To search for information in a table:

1. Select the search field above the table.
2. Enter the text you want to find.
3. Select the option to search the table.
4. Review the matching results.

## Filtering data

Filters narrow the displayed results based on specific criteria, such as application, severity, or security category.

To apply filters:

1. Select **Filters** to open the filter selector.
2. Select a filter category or use **Suggested** to access commonly used filters.
3. Select a filter to open its available values.
4. Select the values you want to include.
5. Repeat the process to apply additional filters.

Applied filters appear as chips above the table, allowing you to see which filters are active.

To modify an applied filter, select its chip and update the selected values.

## Filter categories

Filters are organized into categories to make them easier to locate.

| Category        | Description                                                                                         |
| --------------- | --------------------------------------------------------------------------------------------------- |
| Suggested       | Displays the ten most frequently used filters in OX, including Application, Severity, and Category. |
| Application     | Filters by application attributes, such as application name, branch, or business priority.          |
| Issue           | Filters by issue attributes, such as severity, issue name, or policy.                               |
| Exploitable     | Filters by exploitability-related criteria.                                                         |
| Artifacts       | Filters by artifact-related information.                                                            |
| Cloud           | Filters by cloud-related attributes.                                                                |
| Agentic Pentest | Filters by attributes related to agentic penetration testing.                                       |
| Other           | Contains additional filters that do not belong to the other categories.                             |

## Finding filters using search

Instead of browsing the filter categories, you can search for a specific filter by name.

To find and apply a filter:

1. Select the search field.
2. Enter a filter name or keyword, such as `cloud` or `severity`.
3. Select the relevant filter from the suggested results.
4. Select the filter values to apply.

The selected filter appears as a chip above the table.

## Using AI Search

AI Search uses natural-language input to identify filters that may match your search request.

To use AI Search:

1. Select the search field.
2. Enter a description of the information you want to find.
3. Select **AI Search**.
4. Review the suggested filters and adjust them if necessary.

Note: AI Search is available only to some customers. The generated filters may not always match your intended criteria.

## Using keyboard navigation

The search and filtering interface supports keyboard navigation. You can enter a search term, navigate through matching filters, select filter values, and return to the search field to add more filters.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.ox.security/get-started/searching-and-filtering-in-ox/ox-search-and-filters.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
