--- title: "Filter Mode" canonical: "https://support.appfire.com/space/ILV/198022635/Filter%20Mode" format: markdown --- > Macro (aura-html) ## Overview In **Filter **mode, the Issue Matrix panel will show only the issues by the JQL filter specified in the *Filter *section. The different configuration options in this mode are organized into the following groups: - *Data* - *Display* - *Locations* ## Data The *Data *configuration options let you control the content displayed in the matrix table. ![Screenshot of the Data group of options for an Issue Matrix custom field in Filter mode.](media://769a609a-0ae6-476d-98d3-e350786cadc5) ### Filter In this section, you must specify any saved JQL filter in the system. The Issue Matrix panel will show only issues returned by the chosen filter. ### Columns Any of the available issue custom fields can be added to the list of columns that will be visualized in the Issue Matrix panel. The field value visualized will be the same as in the Issue Navigator. > ℹ️ **Adding a progress bar** > ℹ️ > ℹ️ If you want to have a progress bar in your matrix, you can add the **Σ Progress** field as a column. If you don't see it in the field selector, you must enable time tracking for your Jira instance first. To do that, go to **Settings** :jira-cog: >** Issues **>** Time tracking** and click the **Activate **button. You can specify the *Width *of the columns you add to the Issue Matrix table. For details, see [https://appfire.atlassian.net/wiki/spaces/ILV/pages/198182504](https://appfire.atlassian.net/wiki/spaces/ILV/pages/198182504). Since v. 2.8.0, you can also specify the *Header *of each column you add to the Issue Matrix table. If you want to have column headers adapted to your use cases, set the headers when you configure the Issue Matrix columns. When you choose a field from the list to be added as a column to the Issue Matrix table, the column header is set by default to the custom field's name. If you want to revert to the default header of a column, just delete the contents in the *Header *column of the configuration. You can enable *Inline Edit* for the fields within each column. For details, see [https://appfire.atlassian.net/wiki/spaces/ILV/pages/198182354](https://appfire.atlassian.net/wiki/spaces/ILV/pages/198182354). ## Display The *Display *options let you control how the Issue Matrix table is visualized. In addition, you can hide certain default panels to avoid showing the same issue list twice. ![Screenshot of the Display group of options for an Issue Matrix custom field.](media://4baed15e-5bff-42f7-9608-9fbd0b630f9d) ### Table Visualization The options in this section are: - **Show Table Headers: **If enabled, this option will visualize the fields configured in the *Column *selection as table headers. Users will be able to sort the table by clicking the table headers. See [https://appfire.atlassian.net/wiki/spaces/ILV/pages/197957270](https://appfire.atlassian.net/wiki/spaces/ILV/pages/197957270). - **Show Empty Table: **If enabled, the Issue Matrix table will be shown even if there are no issues to be displayed. ### Issues - Since v.5.0, the Issue Matrix table includes pagination when viewed in Issue Detail View and Agile Boards for improved performance. You can choose the default page size of the Issue Matrix table. The page size must be a value between `1` and `1,000`, and it is initially set to `10`. This setting automatically applies to all users. Later, each user can change this setting for their account directly from the table. For details, see [https://appfire.atlassian.net/wiki/spaces/ILV/pages/197957270](https://appfire.atlassian.net/wiki/spaces/ILV/pages/197957270). > 📝 Issue Matrix pagination is not available in the Issue Navigator, Issue Matrix preview, nested matrices, dashboards, Service Desk queue, and as a Confluence macro. In these locations, the Issue Matrix table displays all issues. - In earlier versions, this section lets you specify the number of initially visible issues in the Issue Matrix table. The remaining issues will be shown after clicking the **Show more** link. To remove the limit, either choose **All** or set the **Selected** entry to `0`. > ℹ️ After upgrading to v. 5.0 or later, the current number of issues initially visible becomes the default page size of the Issue Matrix table. ### Categories This section lets you create JQL-based categories that use color-coded cells to highlight and prioritize specific issues in the matrix table. For details, see [https://appfire.atlassian.net/wiki/spaces/ILV/pages/198248015](https://appfire.atlassian.net/wiki/spaces/ILV/pages/198248015). ### Jira Panels The options in this section are: - **Hide Sub-Tasks: **If enabled, the default *Sub-Tasks* panel will be hidden on the Issue View screen. - **Hide Issue Links: **If enabled, the default *Linked Issues* panel will be hidden on the Issue View screen. - **Hide Issues in Epic: **If enabled, the default panel showing all stories linked to an issue of type Epic will be hidden on this Epic issue View screen. ## Locations You can configure the locations in Jira where you want to show the Issue Matrix table. Configure the visualization of the Issue Matrix in the Issue Navigator and Agile Boards. ![Screenshot of the Locations group of options for an Issue Matrix custom field.](media://0807fc43-f1b2-4024-a5a8-91a577c10e12)