Skip to content
Hawzu Docs

Labels Overview

2 min read

Labels help teams organize project work with lightweight categories. They are useful for grouping items by product area, release theme, test area, triage status, feature, customer, or any other classification your team uses.

Labels are managed at the project level and can be reused across supported work items in that project.

Where Labels Are Used

Section titled “Where Labels Are Used”

Hawzu supports labels across many project areas. A label detail view tracks usage across all of them:

  • Test cases
  • Requirements
  • Releases
  • Tasks
  • Executions
  • Testruns
  • Defects
  • Testsuites

Usage details help you understand where a label is being used before you edit or delete it. See Label Details to review usage across each of these areas.

Why Use Labels?

Section titled “Why Use Labels?”

Use labels when you need a flexible way to group work without changing the main structure of the project.

Labels are helpful for:

  • Filtering lists quickly
  • Grouping related work across folders or sections
  • Highlighting release scope
  • Marking product areas, teams, or feature areas
  • Creating lightweight triage categories
  • Improving reporting and review workflows

Labels are intentionally simpler than custom fields. Use labels for quick, reusable categories. Use custom fields when you need structured values with a defined field type.

Label Appearance

Section titled “Label Appearance”

Each label has:

  • Name
  • Color
  • Preview

The color controls how the label appears in lists and label pickers. A label can also use a transparent style when you want a neutral look.

Labels Page

Section titled “Labels Page”

The project Labels page is the central place to view and manage labels.

From the Labels page, you can:

  • Create labels
  • Search labels by name
  • Filter by creation date
  • Sort by name or creation date
  • Show or hide table columns
  • View usage counts
  • Open label details
  • Duplicate labels
  • Export label data

Each row shows the label name, color, usage summary, created date, and available actions.

Label Details

Section titled “Label Details”

Opening a label shows a two-panel detail view:

  • The details panel with the label’s name, color, and preview, where you can edit the name and color.
  • The usages panel, which groups every place the label is used into tabs — test cases, requirements, releases, tasks, executions, testruns, defects, and testsuites — with a count for each and links to the individual items.

See Label Details for a full tour of the view.

Permissions

Section titled “Permissions”

Label actions depend on your project permissions.

Depending on your role, you may be able to:

  • View labels
  • Create labels
  • Edit labels
  • Delete labels

If a button or action is unavailable, your project role may not include the required permission.

Best Practices

Section titled “Best Practices”

When using labels:

  • Keep names short and easy to scan
  • Use consistent naming across the project
  • Avoid creating several labels with the same meaning
  • Choose colors that make important categories easier to recognize
  • Review usage before renaming or deleting labels
  • Use labels for flexible grouping, not for data that needs strict validation

Next Steps

Section titled “Next Steps”