How To Delete A User Story In Azure DevOps

Maintaining a clean and efficient backlog is essential. What you remove from your backlog is often just as important as what you add. In this comprehensive article, I will walk you through the professional way to delete a user story in Azure DevOps while maintaining the integrity of your project.

How To Delete A User Story In Azure DevOps

Deleting vs. Removing vs. Closing: Know the Difference

Before we click the delete button, we must understand the “State” logic in Azure DevOps. Many teams make the mistake of deleting work items when they should actually be “Removing” or “Closing” them.

The Decision Matrix

ActionWhen to Use ItImpact on Data
CloseThe work is finished and verified.Keeps the item in history; counts toward velocity.
RemovedThe idea is valid but we’ve decided not to do it.Keeps the item in history; does not count toward velocity.
DeleteThe item was a mistake, a duplicate, or created in error.Moves item to the “Recycle Bin”; eventually permanently purged.

If you are a Project Lead overseeing a critical deployment, you likely want to use the “Removed” state for audit purposes. However, if someone accidentally double-clicked and created a blank story, “Delete” is the correct path.

Prerequisites: Permissions and Access

In most enterprise Azure DevOps environments, “Delete” permissions are restricted to prevent accidental data loss.

  • Project Level: You must be a member of the Project Administrators group or have the “Delete work items” permission set to “Allow” for your specific Area Path.
  • Process Template: Whether you use Agile, Scrum, or Basic, the deletion process remains consistent, but ensure your organization hasn’t disabled the Recycle Bin feature.

How to Delete a User Story: The Step-by-Step Tutorial

I will show you the two primary ways to handle this: through the Backlog view and through the Work Item form.

Method A: Deleting from the Backlog or Board (The Bulk Method)

This is the most efficient way to clean up several items at once.

  1. Navigate to your Project: Open your organization (e.g., dev.azure.com/YourOrg).
  2. Go to Boards: Select Backlogs or Queries from the left-hand navigation pane.
  3. Select the Story: Click on the User Story you wish to delete. To select multiple, hold the Ctrl key (Windows) or Cmd key (Mac).
  4. Open the Context Menu: Right-click on the selected item(s) or click the three dots (…) (Actions menu).
  5. Select Delete: Click on Delete.
  6. Confirm: A confirmation dialog will appear. Click Delete again.

Check out the screenshots below for your reference.

how to delete a user story in azure devops