Skip to content
Hawzu Docs
API reference Go to app

Deleting Labels

1 min read

Deleting a label removes it from the project label list.

If the label is used anywhere, deleting it also removes the label from those linked items. The linked items themselves are not deleted.

Before You Delete

Section titled “Before You Delete”

Before deleting a label, open the label details and review its usage.

Usage can include:

  • Test cases
  • Requirements
  • Releases
  • Executions
  • Defects

The label detail view shows linked test cases, requirements, and releases when the label is used in those areas.

Deleting an Unused Label

Section titled “Deleting an Unused Label”

If a label is not used anywhere, Hawzu shows a confirmation message explaining that it is safe to remove.

After deletion:

  • The label is removed from the project
  • It no longer appears in label pickers
  • No work items are changed

Deleting a Used Label

Section titled “Deleting a Used Label”

If a label is used, Hawzu shows how many places use the label before deletion.

After deletion:

  • The label is removed from all linked usages
  • The label no longer appears in label pickers
  • The affected test cases, requirements, releases, executions, and defects are not deleted
  • The action cannot be undone

Use extra care when deleting labels with many usages.

What Deletion Does Not Do

Section titled “What Deletion Does Not Do”

Deleting a label does not delete:

  • Test cases
  • Requirements
  • Releases
  • Executions
  • Defects

It only removes the label itself and removes that label from linked items.

When to Delete a Label

Section titled “When to Delete a Label”

Delete a label when:

  • It has no meaningful use
  • It was created by mistake
  • It duplicates another label
  • It no longer matches your project organization

If a label is still useful but poorly named, edit the label instead of deleting it.

Permissions

Section titled “Permissions”

Deleting labels requires label deletion permission.

If the delete action is unavailable, your project role may not allow label deletion.

Best Practices

Section titled “Best Practices”

Before deleting labels:

  • Review usage counts
  • Confirm the label is no longer needed
  • Rename or recolor the label instead if the category still matters
  • Communicate large cleanup changes to the team
  • Export labels before major cleanup work

Next Steps

Section titled “Next Steps”