Send an email with work items - Azure Boards (2024)

  • Article

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

Visual Studio 2019 | Visual Studio 2022

Using work items to track your work provides a host of benefits, including the ability to easily share information. You can capture most information within the work item Description or other rich-text formatted field. If you need to maintain the information in a different format, you can easily link to or attach a file.

Supported tasks

Emailing lists of work items is a common way to share work tracking information. The following table indicates which tasks or features are supported from the web portal and Visual Studio.

Note

The tasks/features listed in the following table aren't available when you're connected to a GitHub or third-party Git repository. Also, they aren't available from Visual Studio under the following conditions:

  • If you're set to use the new Git Tool as described in Git experience in Visual Studio.

Important

We strongly recommend that everyone use the default view instead of the legacy view. It is designed for you to quickly access a list of work items based on your assignment, following, mentioned, or recent updates. The legacy view is no longer being enhanced and we expect to remove it in a future release of Visual Studio.

Task/feature

Web portal

Visual Studio

Email summary list with links to work item(s)

✔️

✔️

Print work item(s)

✔️

Email link to a work item query

✔️

✔️

Email query results

✔️

✔️

Export query result as CSV

✔️

Note

For the email feature to work, your administrator for Azure DevOps Server must configure a Simple Mail Transfer Protocol (SMTP) server.

Prerequisites

  • You must be added to a project.
  • To view or modify work items, you must have your View work items in this node and Edit work items in this node permissions set to Allow. By default, the Contributors group has this permission set. For more information, see Set permissions and access for work tracking.
  • To add new tags to add to work items, you must have Basic access or higher and have the project-level Create new tag definition permissions set to Allow. By default, the Contributors group has this permission set. Even if the permission is explicitly set for a Stakeholder, they don't have permission to add new tags, as they're prohibited through their access level. For more information, see Stakeholder access quick reference.
  • All project members, even members in the Readers group, can send emails containing work items.
  • You must be added to a project.
  • To view or modify work items, you must have your View work items in this node and Edit work items in this node permissions set to Allow. By default, the Contributors group has this permission set. For more information, see Set permissions and access for work tracking.
  • To add new tags to add to work items, you must have Basic access or higher and have the project-level Create new tag definition permissions set to Allow. By default, the Contributors group has this permission set. Even if the permission is explicitly set for a Stakeholder, they don't have permission to add new tags, as they're prohibited through their access level. For more information, see Stakeholder access quick reference.
  • All project members, even members in the Readers group, can send emails containing work items.

Note

Make sure you provide members of your organization Stakeholder access who want to contribute to the discussion and review progress. These are typically members who don't contribute to code, but want to view work items, backlogs, Kanban boards, and dashboards.

Email a single item

You can quickly email a summary of one or more work items. Summaries include the values assigned to these fields: work item ID, title, work item type, assigned to, state, and tags.

Important

If you use the built-in email feature, you can only send the email to individual address for a project member that is recognized by the system. Adding a team group or security group to the to line isn't supported. If you add an email account that the system doesn't recognize, you receive a message that one or more recipients of your email don't have permissions to read the mailed work items.

  • Web portal
  • Visual Studio

From the web portal, open the work item, choose the Send an email with work items - Azure Boards (1) actions icon, and select the Email work item option. The first 200 items in the list appear in a formatted table.

Send an email with work items - Azure Boards (2)

Note

If you connect to an on-premises Azure DevOps Server, your server administrator must have configured an SMTP server for the email feature to work.

Email summary lists with links to items

Another way to share items is by emailing summary lists, such as a sprint summary plan or active bugs list. You can share items from a backlog or query results list.

Depending on the option and client you choose, summary lists may or may not include a hyperlink to the work item ID.

  • Web portal
  • Visual Studio

To email items from the web portal: Open a backlog or query and highlight the items from the list. Open the context menu for one of the selected items and select to email them.

Send an email with work items - Azure Boards (3)

If you want to mail a list of all items in the backlog or query, choose the Send an email with work items - Azure Boards (4) actions icon, and select the Email option.

Send an email with work items - Azure Boards (5)

Copy formatted list of work items

With this option, you can copy an HTML formatted table of selected items. You can then email this list using your choice of email client.

  1. From the web portal, open a backlog or a list of query results.

  2. Select the work items you want to copy.

    Send an email with work items - Azure Boards (6)

    The formatted table contains a link to each work item included in your selected results list.

  3. Paste the contents of the clipboard into your email client or other application. To open a linked work item, requires users to have read access to the project or area node for those work items.

Print items

Open a query in Visual Studio that contains a work item that you want to print, select or highlight those items, and then select the Print option from the context menu.

Important

We strongly recommend that everyone use the default view instead of this legacy view. It is designed for you to quickly access a list of work items based on your assignment, following, mentioned, or recent updates. The legacy view is no longer being enhanced and we expect to remove it in a future release of Visual Studio.

Send an email with work items - Azure Boards (7)

Print work items as cards

Some teams want to work with physical cards when planning or updating their physical Kanban or Scrum task boards. There's no native support for printing work items as cards. However, you may find a solution from the Azure DevOps Marketplace.

Copy the URL to a single work item

Note

All URLs you copy, regardless of the client you use to copy them, opens the work item in the web portal.

  • Web portal
  • Visual Studio

From the web portal, copy the URL from the web browser address or hover over the title and then select the Send an email with work items - Azure Boards (8) copy-to-clipboard icon.

Send an email with work items - Azure Boards (9)

Export list as CSV

From any query, you can export a list of work items as a comma-delimited list. Open the query, choose the Send an email with work items - Azure Boards (10) actions icon, and choose Export to CSV. For more information, see Bulk import or update work items using CSV files.

Note

Requires Azure DevOps Server 2019 Update 1 or later version.

Send an email with work items - Azure Boards (11)

Marketplace extensions

You may find other ways to share information by exporting work items to other applications such as Microsoft Word. For more information, review the Marketplace extensions that support Microsoft Word.

Related articles

  • Use templates to add and update work items
  • Send email with work item
  • Use templates to add and update work items
  • Send email with work item
  • Configure an SMTP server
Send an email with work items - Azure Boards (2024)
Top Articles
Latest Posts
Article information

Author: Jerrold Considine

Last Updated:

Views: 5641

Rating: 4.8 / 5 (58 voted)

Reviews: 81% of readers found this page helpful

Author information

Name: Jerrold Considine

Birthday: 1993-11-03

Address: Suite 447 3463 Marybelle Circles, New Marlin, AL 20765

Phone: +5816749283868

Job: Sales Executive

Hobby: Air sports, Sand art, Electronics, LARPing, Baseball, Book restoration, Puzzles

Introduction: My name is Jerrold Considine, I am a combative, cheerful, encouraging, happy, enthusiastic, funny, kind person who loves writing and wants to share my knowledge and understanding with you.