---
title: "Filters"
canonical: "https://docs.getxray.app/space/XRAYCLOUD/44566597/Filters"
format: markdown
---
## Working with Filters

The [Document Generator](https://getxraydocs.atlassian.net/wiki/spaces/XRAYCLOUD/pages/44565169) supports integration with Jira filters, allowing you to include the filter-related information from your Jira instance in your Templates. 

To get the JQL statement, use this [mapping](https://getxraydocs.atlassian.net/wiki/spaces/XRAYCLOUD/pages/44570571): `${filter:<Filter name> or <Filter ID>}`

This ensures your document contains precise details about the filters applied, enhancing traceability and clarity in your reports.

## FilterJQL and FilterName

The *FilterJQL* and *FilterName* mappings allow you to include the search criteria and filter details from Jira's Issue Navigator directly in your generated documents.

> ℹ️ This is **available** **exclusively when exporting data through the *****Export***** menu** on the Issue Navigator screen, making it easier to document the context and scope of your search results.

- `${FilterJQL}` - captures the JQL query used to define the search criteria.
- `${FilterName}`** **- captures the name of the filter applied during the search.


<details>
<summary>Support/Troubleshooting</summary>

If you have questions or technical issues, please [contact the Support team via the Customer Portal (Jira service management)](https://jira.getxray.app/servicedesk/customer/portal/2/user/login?destination=portal%2F2%2Fcreate%2F28) or [send us a message using the in-app chat](https://getxraydocs.atlassian.net/wiki/spaces/XRAYCLOUD/pages/44577312).
</details>