View and add work items

Azure DevOps Services | Azure DevOps Server 2022 - Azure DevOps Server 2019

Visual Studio 2019 | Visual Studio 2022

View work items that you created or are assigned to you. The Work items page offers several personalized pivots and interactive filter functions to streamline listing work items. Use this page to quickly find work items defined across teams within a project.

This article shows how to add any type of work item. However, use the backlog or board to add backlog or portfolio items—such as user stories, product backlog items, features, or epics. For more information, see Create your backlog, Define features and epics, and Start using your board.

To create test cases and link them to user stories, see Add, run, and update inline tests and Create test plans and test suites.

You can add work items in the following ways:

These methods provide flexibility in how you manage and track your work items within Azure DevOps.

Napomena

The Work Items page is available from Azure DevOps Services, Azure DevOps Server 2019 and later versions, and Visual Studio 2019 RC1.

Prerequisites

  • Project access: Be added to a project.

  • Permissions:

    • Have View work items in this node and Edit work items in this node permissions set to Allow. By default, the Contributors group has these permissions. For more information, see Set work tracking permissions.

    • To add new tags to work items, have Basic access or higher and the project-level Create new tag definition permission set to Allow. By default, the Contributors group has this permission.

      Napomena

      Stakeholders cannot add new tags, even if the permission is explicitly set, due to their access level. For more information, see Stakeholder access quick reference.

  • Email work items: All project members, including those in the Readers group, can send emails containing work items.

Open the Work items page

From your project, select Boards > Work items.

Screenshot of web portal, Open Boards, Work Items hub.

Napomena

The types of work items you can create depend on the process chosen when the project was created—Agile, Basic, Scrum, or CMMI. For example, backlog items may be called user stories (Agile), issues (Basic), product backlog items (Scrum), or requirements (CMMI). All these types describe the customer value to deliver and the work to be performed.

For more information, see About processes and process templates.

View work items

Use the drop-down menu to focus on relevant items within a project using one of seven pivots. Additionally, filter each pivot view. You can also use an Azure DevOps CLI command to view work item details.

Screenshot of web portal, Boards, Work Items, Menu options.

Screenshot of web portal, Boards, Work Items, Menu options, Azure DevOps Server 2019 version.

  • Assigned to me: Lists all work items assigned to you in the project in the order they were last updated. Doesn't include items moved to the Removed category state. To open or update a work item, select its title.
  • Following: Lists work items that you're following.
  • Mentioned: Lists work items in which you're mentioned in the last 30 days.
  • My activity: Lists work items that you recently viewed or updated.
  • My team(s): Lists work items that your team members recently viewed or updated.
  • Assigned to me: Lists all work items assigned to you in the project in the order they were last updated. To open or update a work item, select its title.
  • Following: Lists work items that you're following.
  • Mentioned: Lists work items in which you're mentioned in the last 30 days.
  • My activity: Lists work items that you recently viewed or updated.
  • My team(s): Lists work items that your team members recently viewed or updated.
  • Assigned to me: Lists all work items assigned to you in the project in the order they were last updated. To open or update a work item, select its title.
  • Following: Lists work items that you're following.
  • Mentioned: Lists work items in which you're mentioned in the last 30 days.
  • My activity: Lists work items that you recently viewed or updated.

  • Recently updated: Lists work items recently updated in the project.
  • Recently completed: Lists work items completed or closed in the project.
  • Recently created: Lists work items created within the last 30 days in the project.

Filter to create personal views

Filter each work item pivot view by entering a keyword or using fields like work item type (Types), State, Area Path, and Tags. The page remembers your filters for each pivot, providing personalized views across all pivots. For more information, see Filter backlogs, boards, queries, and plans.

Screenshot of web portal, Work Items page, Filter options, choose to show Bugs.

Add a work item from the Work items page

Napomena

New work items are assigned the last Area Path and Iteration Path selected by the user.

Select New Work Item and choose the work item type from the drop-down menu. For example, here we choose User Story.

Screenshot of web portal, Work Items page, New Work Item.

Savet

Work items you add are automatically assigned to the current team's area and iteration paths. To change the team context, see Switch project or team focus. Enter a title and save the work item. You must save it before changing its initial default state.

Screenshot of Agile process, User story work item form.

Add tags to any work item to filter backlogs, queries, and work item lists. Users with Basic access can create new tags, while users with Stakeholder access can only add existing tags.

Add a work item from a Boards, Backlogs, or Sprints page

Do the following steps to add a work item from your Boards, Backlogs, or Sprints page.

  1. From your Boards, Backlogs, or Sprints page, choose the plus icon or + New Work Item. The following example shows creating a work item from a board.

    Screenshot showing highlighted New item button, for creating a work item.

    Napomena

    Depending on the process chosen when the project was created—Agile, Basic, Scrum, or CMMI—the types of work items you can create are different. For example, backlog items may be called user stories (Agile), issues (Basic) product backlog items (Scrum), or requirements (CMMI). All four are similar: they describe the customer value to deliver and the work to be performed.

    For more information, see About processes and process templates. The Basic process requires Azure DevOps Server 2019.1 or later version.

  2. Select a work item type from the dropdown menu, enter a title, and then select Enter. From a board, for example, you can also select Add to top. Before you can change the state from its initial default, save it.

    Screenshot showing Agile process, User story work item form.

You can add tags to any work item to filter backlogs and queries.

Added work items are automatically scoped to your team's default area path and iteration path. To change the team context, see Switch project or team focus.

Create as many work items as you need of the type you need to track the work you want to manage.

Open a view as a query

From the web portal, you can open any view, filtered view, or selected set of work items as a query. Choose Open in Queries or the Open selected items in Queries option from the context menu.

Queries provide the following features and more:

  • Edit one or more fields of several work items
  • Add or remove tags from several work items
  • Change the work item type
  • Delete work items
  • Apply work item templates

For more information, see Bulk modify work items. For more information about queries, see Use the query editor to list and manage queries and Query fields, operators, and macros.

Use work items page controls

Use the following three controls to manage your views in the web portal.

Control Function
Screenshot of View options control icon. View/hide completed items
Screenshot of Filter control icon. Turn filtering On/Off
Screenshot of Full screen icon. / Image of Exit full screen icon. Enter or exit full screen mode

Next steps