The List widget shows the work items of its source as a table, with the columns you choose, quick filters above it and page buttons under it. It is in both editions, on classic and new Jira dashboards.

Settings
Open the widget's menu and choose Edit. The settings have five tabs.
| Tab | What it holds |
|---|---|
| Source | Where the work items come from: Dashboard (new dashboards), Filters, Projects, Saved filter or JQL. |
| Columns | Up to 8 columns, any Jira field, in any order. Type, Key, Status, Summary and Assignee by default. |
| Quick filters | Up to 8 chips above the list, each from a saved filter or JQL. |
| Display | Rows per page, row colours, the number column, links, text height, pictures, number and date formats. |
| Import / Export | Auto refresh, the options menu, Allow export, and copying a setup to another List. |
Columns
- Pick any Jira field, custom fields included, and put the columns in the order you want.
- Status shows as a coloured label by Jira's status category: grey for To Do, blue for In Progress, green for Done.
- Type column shows text, an icon, or both.
- Long summaries are cut at the Maximum text height you set.
Quick filters
Each quick filter is a chip above the list, from a saved filter or a short JQL. Viewers turn chips on and off. When several are on, a work item must match all of them.
Display
- Results per page: 10, 20, 25, 50 or 100. Pages are shown under the list.
- Alternating row colours, Show number column and User pictures (a small picture beside user fields).
- Hyperlinks: keys open the work item in Jira. Turn it off to show plain text; then nothing in the list opens a link.
- Number format and Date format.
Order
The order comes from the source, such as the ORDER BY of a saved filter or of your JQL. When the List follows a Filters widget, it uses that widget's Order by.
Export as CSV
With Allow export on, the ··· menu has Export as CSV. It reads the list page by page, up to 30 pages, and keeps your columns and formats. If a Jira admin has turned export off for the site, the switch says so. See How to export a list to CSV.
On a new Jira dashboard
A widget's height is the slot Jira gives it. A List scrolls its rows inside the widget, with the column headings kept at the top, and its page buttons stay in view. At narrow widths the List stays a table that scrolls sideways.
Related pages
Need help with SmartDash? Contact us