View your work in a list

Jira Work Management’s list view sorts all your project’s work into a single list that can be quickly scanned and sorted by category. You can also use the list to add, edit, and view issues in your project.

alt="Work viewed as a list"

Learn about the fields in your list

Understand what each field means in your list view:

Type: This field indicates what type of issue each item is in your list. Jira enables you to keep track of different types of things — bugs, tasks, sub-tasks, etc — by using different issue types. The default issue types depend on how your project has been set up by your project admin and which Jira Work Management template you’re using in your instance. Learn more about issue types.

# Key: This field gives you a project and unique issue key. For example, this could look like TBT-12. Learn more about project and issue keys.

Summary: This field shows the summary of the item in your list. This should provide an overview of the task at hand.

Status: This field shows what stage each item is up to in the project lifecycle. 

Assignee: This field indicates who this item is assigned to.

Due date: Indicates when the item is due.

Original estimate: This is a field where you can estimate the amount of time this item will take to complete.

Reporter: This field indicates who has created the issue.

Components: This field shows the subsections of a project. They are used to group issues within a project into smaller parts.

Create an issue from your list

To create an issue from the list view:

  1. Select the Add item button at the bottom of the list.

  2. Give your issue a name based on what work needs to be done.

  3. On your keyboard, press enter to create or escape to cancel.

Once you’ve created an issue, it will be added to your project with an automatically assigned issue key and a to do status.

alt="Add an item to list view."

Customize your list by adding or removing fields

Every team has different needs, so you may want to add or remove fields so only the most important information is displayed in your list. You can select other fields you’d like to include in your list view. However, you’ll always see the item’s type, key, and summary.

If you’d like to customize the fields you see:

  1. Select plus icon at the top right of your list. A drop-down menu will appear.

  2. Use the checkboxes to display and hide fields from your list.

alt="Adding and removing fields in list view."

Jira custom fields

Only project admins can set up custom fields that can be used in your list view.

For other custom fields that exist in Jira more broadly; Jira Work Management currently only supports a limited set of custom field types at the moment. In addition to the default fields that exist in the list view, you can create other fields you’d like to include in your list view. Learn more about creating custom fields. These are usually fields that you’ll need to configure and enable in your Jira settings. Learn more about how to configure a custom field.

You can currently add:

  • Date picker

  • Date time picker

  • Number field

  • Select field (single select)

  • Select field (multiple select)

  • Text field (single line)

  • Text fields (multi-line)

  • URL field

  • User picker (single user)

  • User pick (multiple users)

Quickly edit an issue

The list view allows you to quickly and easily make changes to your issues without having to open them individually.

To edit an issue from the list view:

  1. Select which field you’d like to edit.

  2. If it’s text, just start typing and press enter when you’re finished.

  3. If it’s a selection, select the correct value from the drop-down menu.

  4. Your changes will be applied instantly.

alt="Editing an issue in list view."

View and edit issues in more detail

You can view any of the issues on your project’s list by selecting the relevant issue key in the Key column. Once you’ve opened the issue you can add more details such as a description, assignee, or subtasks. Learn how to update an issue’s details.

Here are the steps:

  1. Select the specific issue in the Key column. There’s an open icon (↗️) next to each specific issue.

  2. View your issue in more detail once the modal opens.

Here’s what it should look like:

alt="View and edit issues in more detail."
Last modified on Jul 19, 2021
Cached at 9:09 PM on Aug 2, 2021 |

Additional Help

Ask the Community