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


## > Macro (anchor)

About queues

<span style="color: #172b4d">Queues allow you to display and manage a list of issues in Rich Filter Results gadgets. They are ideal for organizing support requests (by support agent, service desk, request type, etc.) and for managing lists of issues in general.</span>

<span style="color: #172b4d">Queues are based on configurable JQL queries that further filter the issues returned by the rich filter. One or multiple queues can be displayed in a </span><span style="color: #172b4d">*Rich Filter Results*</span><span style="color: #172b4d"> gadget, and each queue can use one or multiple </span><span style="color: #172b4d">[views](https://appfire.atlassian.net/wiki/spaces/RFP/pages/803405905)</span><span style="color: #172b4d"> to display its issues. Each queue also has its own sorting criteria, independent of the others.</span>

<span style="color: #172b4d">Here are some of the main features of the queues displayed in </span><span style="color: #172b4d">*Rich Filter Results*</span><span style="color: #172b4d"> gadgets:</span>

- Queues are displayed as tabs; users can simply switch between them with one click.
- Each queue displays, next to its name, the number of issues it contains. This is useful for letting users know about the queues that require attention.
- The queues displayed in the same gadget are independent of the current view, page, and sort order.
- When you switch from one queue to another, the displayed list of issues and the issue counts of all the queues in the gadget is refreshed.

![image](media://e2c55283-09e7-448a-8682-ceb9a0670379)

## > Macro (anchor)

Queues key attributes

You can add new queues and see existing queues and their configuration in the **Queues** section of your rich filter.

![2025-09-03_11-38-16.png](media://e5662915-a3d2-4404-a884-f903c5f98f19)

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

| **Attribute** | **Description** |
| --- | --- |
| **Name** | <span style="color: #172b4d">Each queue has a name used to identify and display the queue. It is required and must be unique among the queues within the rich filter.</span> |
| **Color** | The selected color will display the queue in *Rich Filter Results* gadgets. |
| **JQL filter** | Additional JQL query for the queue – it defines the list of issues in the queue. Optionally, an ORDER BY clause to set the default order of the issues in the queue.<br>Remember, the issues in the queue are already filtered by the base Jira filter, <span style="color: #172b4d">as configured in the </span><span style="color: #172b4d">[General section](https://appfire.atlassian.net/wiki/spaces/RFP/pages/803405863)</span><span style="color: #172b4d"> of the rich filter.</span><br>> ✅ <span style="color: #333333">Since the queue is based on JQL, it can be cross-project.</span> |
| **Views** | <span style="color: #172b4d">The views used to display the issues of the queue in </span><span style="color: #172b4d">*Rich Filter Results*</span><span style="color: #172b4d"> gadgets. </span>By default, the queue uses all the views defined in the rich filter (the option *Show all views* is selected).<br>The list of views can be customized (by selecting the option *Customize views*). You can add, remove, or reorder (by drag and drop) the views to be displayed. |

## > Macro (anchor)

Adding & Editing Queues

<span style="color: #172b4d">The </span>**Queues**<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 queue** | 1. Click **Create queue** at the top-right of the page.<br>![2025-09-03_11-48-20.png](media://4698f98b-aed0-4af2-b90e-75a3c644d21b)<br>2. Type a **Name** and a **JQL** query, and select a color.
3. (Optional) Click **Customize shown views** and select the views where you want to display the queue.
  1. You can add, remove, and reorder (using drag-and-drop) the views to apply to the queue.
4. Click **Create**<span style="color: #172b4d">.</span><br>![2025-09-03_12-00-18.png](media://e1b38916-e8f4-4a5d-83d7-19e4de467c40) |
| **View or edit a queue** | Click the **Edit** ()icon next to a queue to view or edit its configuration. Depending on your rights, you can edit or only view the queue.<br>![2025-09-03_12-20-22.png](media://5b58d45d-79ab-42f3-9e6a-acc0183356a8) |
| **Delete a queue** | <span style="color: #172b4d">Click the</span> **Delete** () <span style="color: #172b4d">icon next to the queue’s name.</span><br>![2025-09-03_12-29-50.png](media://b945e64a-7de5-4435-a581-d77e995f6449) |
| **Reorder queues** | Hold the pointer over the queue's **Grid **() icon, then drag the queue up or down to its new position.<br>![2025-09-03_12-31-43.png](media://557a6c32-b731-4408-8a8c-68aed3021e1e)<br><span style="color: #333333">By default, this is the display order of the queues in the </span><span style="color: #333333">*Rich Filter Results *</span><span style="color: #333333">gadgets.</span> |
| **Copy  a JQL** | <span style="color: #172b4d"> Click the </span><span style="color: #172b4d">**Copy **</span>**JQL** <span style="color: #172b4d">** **</span> icon <span style="color: #172b4d">next to the JQL of a selected clause. </span><br>![2025-09-03_12-54-21.png](media://92dd2ae9-b974-45c6-b848-a470b22d1ad9) |

> ✅ <span style="color: #333333">Check the </span>[Rich Filter Results Gadget](https://appfire.atlassian.net/wiki/spaces/RFP/pages/803407090)<span style="color: #333333"> documentation page to see how to display queues in dashboards.</span>