Skip to content

Keep children on the parent’s area and iteration in Azure DevOps

  • Azure DevOps
  • Automation
  • Parent & Child
  • Copy fields
  • Children
Keep children on the parent’s area and iteration flow overview
Overview of the flow for keeping children on the parent’s area and iteration.

When Area Path or Iteration Path changes on a parent that has children, copy those fields onto every child in Azure DevOps.

By default, Azure DevOps boards inherit area and iteration paths only at the time of creation. This automation helps maintain consistency when the parent work item is moved to a different area or iteration.

Prerequisite: Install Automations App on your Azure DevOps organization

Install from Marketplace Complete organization setup

Create an automation from the Keep children on the parent’s area and iteration template, or start from scratch
Go to Project → Automations → Create automation from template Keep children on the parent’s area and iteration or Start from scratch.
Trigger

Trigger — Work Item Update

This trigger activates when a work item's Area Path or Iteration Path is updated. It does not trigger for changes in links or comments.

Configured in this template

  • Work item types: all (no filter)
  • Changed fields (optional filter): Area Path, Iteration Path

You can customize

  • Limit the trigger to specific work item types.
  • Add more fields to monitor for changes.
  • Exclude certain projects from triggering.
Keep children on the parent’s area and iteration trigger
The trigger setup for detecting updates to Area Path and Iteration Path.
Condition

Condition — Work item fields

This condition checks if the work item has children. The automation proceeds only if this condition is met.

Configured in this template

  • Check: This work item
  • Require: All of Items
  • Field conditions: (none)
  • Match logic: All conditions must match (AND)
  • Related work item conditions: children: at least one exists

You can customize

  • Add specific field conditions to refine the check.
  • Change the match logic to any conditions (OR).
  • Require a minimum number of children.
Keep children on the parent’s area and iteration condition 1
Condition setup to verify the presence of child work items.
Action

Action — Copy Fields

This action copies the Area Path and Iteration Path from the parent work item to all its children. System.Tags are merged, while other fields are overwritten.

Configured in this template

  • Work on: Children of trigger
  • Copy from: Trigger work item
  • Fields to copy:
  • - Area Path
  • - Iteration Path

You can customize

  • Include additional fields to copy.
  • Change the destination to specific child types.
  • Modify the action to exclude certain fields.
Keep children on the parent’s area and iteration action 1
Action setup to copy fields from the parent to its children.

Full automation

Keep children on the parent’s area and iteration full automation
Full view of the automation flow for copying area and iteration paths to child work items.

Common questions

How do I keep children on the parent’s area and iteration in Azure DevOps?
When Area Path or Iteration Path changes on a parent that has children, copy those fields onto every child in Azure DevOps. Use the Keep children on the parent’s area and iteration template in Documentero Automations: open Templates, pick this flow, fill the required fields, and enable it.
What fields are required to enable this automation?
Ensure that all required fields in the template are filled, especially the optional extra fields to copy if needed.
Can I change the work item types this automation applies to?
Yes, you can customize the trigger to apply to specific work item types.
How can I test this automation?
After setting up, make a change to a parent work item's Area Path or Iteration Path and verify that the changes reflect on its children.
Does this automation run on a schedule?
No, this automation runs in response to updates on the specified fields, not on a schedule.

Visual Studio Marketplace

Automations

Documentero · Preview

Automate Azure DevOps workflows with triggers, actions, conditions, and scheduled rules.

Setup guideParent & Child templates

Get it free

Create child tasks automatically

Parent & ChildFeatured

When a User Story is created, create child Tasks via stacked Create Work Item steps.

Create Bug from Task

Parent & Child

When a Task is created, create a related Bug seeded from the trigger title.

Copy parent tags to new children

Parent & Child

When a child is created, add tags from its parent. Tags already on the child stay. Boards already inherit Area and Iteration — add other fields here if you need them.

Reopen parent when a child is reopened

Parent & Child

When a child leaves Completed (Closed or Done), set the parent back to In progress (Active, Committed, Doing, …). Pairs with Close parent when all children are completed.