---
title: "Configure smart filters"
canonical: "https://support.appfire.com/space/RFP/803405912/Configure%20smart%20filters"
format: markdown
---
> Macro (aura-html)


## > Macro (anchor)

About smart filters

Smart filters are more versatile than the two other filter types (static and dynamic). Smart filters allow the users to:

- Filter the issues displayed by gadgets based on the current Rich Filter. The smart filters can be displayed as buttons with drop-down menus in *Rich Filter Controller* gadgets (similar to dynamic filters).
- Add computed columns and/or color-coding in *Rich Filter Results* gadgets.
- Build statistics on configurable criteria.

![2025-09-02_16-05-21.png](media://a70a3d3e-eaf2-4bca-92fd-a6778bb852c3)

## > Macro (anchor)

Smart filters key attributes

<span style="color: #172b4d">The </span><span style="color: #172b4d">**Smart filters**</span><span style="color: #172b4d"> section of your rich filter lets you add new smart filters and view existing ones and their key attributes. </span>

![2025-09-02_13-35-04.png](media://7e95a70e-1755-4f1e-9070-be907f574442)

<span style="color: #172b4d">The </span><span style="color: #172b4d">**key attributes**</span><span style="color: #172b4d"> of a smart filter are:</span>  


| **Attribute** | **Description** |
| --- | --- |
| **Name** | Each smart filter has a **name** that identifies it. This name is mandatory and must be unique among the other smart filters within the Rich Filter. |
| **Clauses** | A smart filter contains a list of clauses (options). Each clause is identified by a color and/or a label tag and has a JQL that is applied when the clause is used. |

## > Macro (anchor)

Add and edit smart filters

<span style="color: #172b4d">The </span>**Smart filters**<span style="color: #172b4d"> section of your rich filter allows you do to the following operations: </span>

| **To do the following:** | **Do this:** |
| --- | --- |
| **Add a new smart filter** | Click **Create smart filter** at the top-right of the page.<br>![2025-09-02_13-38-55.png](media://26bfe231-d474-46dc-8869-c5b43a7a8581)<br>Type a name and click **Create**.<br>![2025-09-02_13-42-14.png](media://da003aab-fa22-4192-ac7a-563674a0e298)<br>> ℹ️ You can add up to 30 smart filters in each rich filter. |
| **Reorder the smart filters** | In the *Smart filters* list, hold the pointer over the smart filter vertical **Grid **()  icon, then drag up or down to the new position.<br>![2025-09-02_14-56-39.png](media://aaf127b0-1471-47fc-a241-7dbeb9da6199)<br>> ℹ️ When the smart filters of this rich filter are displayed by Controller Gadgets, they are displayed in the order configured in this section by default. |
| **Duplicate a smart filter** | Click the **Menu** () icon and select the **Duplicate** option.<br>![2025-09-02_15-08-51.png](media://745c2317-ede8-4ac2-8949-784f73288827)<br>Choose the name of the new smart filter and click **Duplicate**. A new smart filter identical to the first one, but with the name you have entered, is created.<br>![2025-09-02_15-09-48.png](media://d4d7835e-b659-40b1-aec2-ffb8a6530502) |
| **Delete a smart filter** | Click the **Menu** () icon and select the **Delete** option.<br>![2025-09-02_14-53-56.png](media://dccc8173-b620-4538-bb9b-43447b7e0844) |
| **Create a smart clause** | Click the **Plus** icon next to the smart filter to create a new smart clause.<br>![plus create smart clause.png](media://e6f8892e-27a6-4de7-ac98-3a3a62e61695) |
| When you create a new smart filter or click an existing smart filter, a new screen focusing on the selected smart filter is displayed. This screen lets you perform the following operations on the selected smart filter: |
| **Edit a smart filter’s name** | Click the **Edit **() icon next to the static filter.<br>![change filter name.png](media://d9e5348f-93f7-4542-b67b-c6b6eaf8a37a)<br>![edit name.png](media://dacc8c16-64a4-4322-848e-6117ba3a1400) |
| **Add clauses to the smart filter** | 1. Click the **Create smart clause*** *button.<br>![create_smart_clause.png](media://96931d70-f9e4-46e1-9340-c2f2b720e682)<br>2. Select a color, enter a **Name** and a **JQL** clause, and click **Create**.<br>![create_a_smart clause.png](media://809b165f-c102-4eba-a071-11670f993507)<br>> ℹ️ You can add up to 10 smart clauses in each smart filter. |
| **Edit the clauses of the smart filter** | Click any smart clause to edit it (or click the corresponding **Edit **() icon at the right of the clause). Update the clause's color, name, and/or JQL clause, and click the **Update** button to save the changes.<br>![2025-09-02_14-30-35.png](media://3ba29a2b-f32c-48e0-aa1e-cd4bfe4b819d) |
| **Delete clauses from the smart filter** | To delete clauses, click the **Delete**  ()  icon.<br>![2025-09-02_14-32-17.png](media://bc88419c-66b2-4f26-ac9b-9deb05b63c6c) |
| **Reorder the clauses of a smart filter** | Hold the pointer over the vertical **Grid **()  icon of the clause, then drag up or down to the new position.<br>![2025-09-02_14-33-52.png](media://2d96aa98-98ce-4f51-882c-7fe07c574bff)<br>> ℹ️ When the smart filter is displayed by Rich Filter gadgets, the smart filter options are displayed in the order as configured in this section. |

## > Macro (anchor)

Use **smart filters in rich filter gadgets**

Once configured, smart filters can be used in several rich filter gadgets:

- The** Rich Filter Controller **gadget – You can use the smart filters to apply additional filtering to the other rich filter gadgets. The smart filters are displayed as drop-down menus (similar to dynamic filters).
  <span style="color: #172b4d">Learn more: </span>[Rich Filter Controller Gadget](https://appfire.atlassian.net/wiki/spaces/RFP/pages/803407087)<span style="color: #172b4d"> </span>
- The** Rich Filter Results **gadget – the smart filters can be added in views as smart columns
  

  
**See also:**

<span style="color: #172b4d">[Configuring Views](https://appfire.atlassian.net/wiki/spaces/RFP/pages/803405905)</span><span style="color: #172b4d"> </span>

[Rich Filter Results Gadget](https://appfire.atlassian.net/wiki/spaces/RFP/pages/803407090)<span style="color: #172b4d"> </span>  


- The** Rich Filter Statistics **gadget – the smart filters can be used as statistics criteria
  Learn more:<span style="color: #172b4d"> </span>[Rich Filter Statistics Gadget](https://appfire.atlassian.net/wiki/spaces/RFP/pages/803407113)
- The** Rich Filter Flexi Charts **gadget – the smart filters can be used as statistics criteria
  Learn more:[ Rich Filter Pie Chart Gadget](https://appfire.atlassian.net/wiki/spaces/RFP/pages/803407059)<span style="color: #172b4d"> </span>
- The** Rich Filter Two Dimensional Statistics **gadget – the smart filters can be used as statistics criteria on any of the two axis or on both
  <span style="color: #172b4d">Learn more: </span>[Rich Filter Two Dimensional Statistics Gadget](https://appfire.atlassian.net/wiki/spaces/RFP/pages/803407105)<span style="color: #172b4d"> </span>
- The** Rich Filter Smart Counters **gadget – the gadget displays one value for each of the clauses of the selected smart filter
  <span style="color: #172b4d">Learn more:</span>[ Rich Filter Smart Counters Gadget](https://appfire.atlassian.net/wiki/spaces/RFP/pages/803407067)<span style="color: #172b4d"> </span>
- The** Rich Filter Smart Gauges **gadget – the gadget displays one gauge for each of the clauses of the selected smart filter
  <span style="color: #172b4d">Learn more: </span>[Rich Filter Smart Gauges Gadget](https://appfire.atlassian.net/wiki/spaces/RFP/pages/803406976)<span style="color: #172b4d"> </span>
- **The Rich Filter Date Bar Chart gadget** – the smart filter can be used as a data split type
  Learn more: [ Rich Filter Date Bar Chart Gadget](https://appfire.atlassian.net/wiki/spaces/RFP/pages/803407039)<span style="color: #172b4d"> </span>

> ℹ️ When deciding under which clause an issue falls, we use *match-all criteria:* the same issue can be part of multiple clauses if it matches the JQL of each clause. This means that when the smart filter is used as a computed column or statistics criteria, it behaves as a multi-select option field.
> ℹ️ 
> ℹ️ If you want your clauses to be mutually exclusive, you need to write your JQL in such a way that an issue can match only one clause at any particular time. For instance, these are mutually exclusive clauses; an issue cannot possibly match more than one clause at a time:
> ℹ️ 
> ℹ️ ![2025-09-02_16-02-33.png](media://592c6437-0b36-44f3-9705-80805fdd4fdc)