Customize Work Item Types (WIT) in Azure Boards

Learn how to tailor Work Item Types (WITs) to match your team's specific workflow and processes. Customizing WITs allows you to add custom fields, modify layouts, and define rules to streamline your project management.

Why Customize Work Item Types?

Every team has unique needs. Azure Boards provides flexibility to adapt its default WITs (like User Story, Bug, Task) or create new ones to perfectly fit your development lifecycle. This includes:

  • Adding custom fields to capture specific information.
  • Modifying the work item form layout for better usability.
  • Defining rules to automate actions and enforce data integrity.
  • Creating new WITs for custom processes or artifacts.

Prerequisites

  • You need to be a member of the Project Collection Administrators group or have the appropriate permissions to manage process templates.

Steps to Customize a Work Item Type

Step 1: Navigate to Process Settings

To customize WITs, you'll work within the project's process settings. This is typically done by a Project Administrator or a member of the Project Collection Administrators group.

  1. Go to your Azure DevOps project.
  2. Click on Project settings in the bottom-left corner.
  3. Under the Boards section, select Process.

You will see a list of processes applied to your project. If you are using an inherited process, you can customize it. If you are using an XML-hosted process, you'll need to modify the process template file.

Step 2: Select the Process and Work Item Type

From the Process page, choose the process your project uses. Then, click on the specific Work Item Type you wish to customize (e.g., User Story, Bug).

For this tutorial, let's assume we're customizing the 'User Story' WIT.

Azure DevOps Process Settings

Selecting a process and Work Item Type.

Step 3: Add Custom Fields

To add a new field, click on the New field button.

  1. Choose the field type (e.g., Text, Integer, Picklist, Date/Time).
  2. Provide a Name for your field (e.g., "Customer Impact").
  3. Optionally, add a Description.
  4. Select the Category (e.g., Custom).
  5. For picklist fields, you'll define the allowed values.
  6. Click Add.

Once added, you can choose which page and group on the work item form the new field should appear. Drag and drop it to the desired location.

Adding Custom Field to Layout

Adding a field to the work item form layout.

Step 4: Modify Layout and Add Controls

The Layout tab allows you to manage the appearance of the work item form. You can:

  • Create new Groups to organize fields.
  • Add existing fields to these groups.
  • Rename groups.
  • Rearrange the order of groups and fields.
  • Make fields required or read-only using rules.

To add a control (like a field) to a group, simply drag it from the 'All fields' list on the right to the desired group on the form preview.

Step 5: Add Rules

Rules automate actions based on specific conditions. Click on the Rules tab.

To add a rule:

  1. Click New rule.
  2. Define the Conditions (e.g., "When Field 'State' changes to 'Done'").
  3. Define the Actions (e.g., "Set Field 'Resolution' to 'Fixed'").
  4. Click Save.

Common rules include setting default values, making fields required based on state, or copying values between fields.

Step 6: Review and Save Changes

After making your customizations, it's good practice to review them. You can see how the work item form will look and ensure your rules are set up correctly.

Click the Save changes button at the top of the page to apply your customizations.

Now, when you create or edit a work item of the customized type, you will see your new fields, organized layout, and enforced rules.

Best Practices

  • Start Simple: Don't over-customize initially. Add fields and rules as needed.
  • Consistent Naming: Use clear and consistent naming conventions for fields.
  • Test Thoroughly: After making changes, test the work item form and rules to ensure they function as expected.
  • Documentation: Document your custom fields and any custom WITs for your team.
  • Permissions: Be mindful of who has permissions to modify processes.

Next Steps

Explore other customization options in Azure Boards, such as setting up custom columns in your backlogs and boards, or creating custom dashboards to visualize your team's progress.

Related Topics: