Share via

Changing status doesn't work when there is space in the name

Sławek Rosiek 0 Reputation points
2026-06-04T07:03:14.8633333+00:00

I have case that when I merge PR in github I would like to change status of Azure boards work item. It works fine is status name is single world but doesn't when it's multi word, eg "Ready For Deploy AB#1344". Is it a bug or there is special way to write it so bot knows it's state name.

Azure DevOps
0 comments No comments

1 answer

Sort by: Most helpful
  1. AI answer

    2026-06-04T07:03:38.9266667+00:00

    Multi-word states are supported; they must match the Azure Boards work item state name or state category exactly, including spaces.

    For GitHub → Azure Boards integration, the syntax is:

    {State or StateCategory} AB#{ID}
    

    Examples that should work if the process has such a state or category:

    Ready For Deploy AB#1344
    Resolved AB#1344
    Closed AB#1344
    

    Behavior is as follows:

    1. Azure Boards first tries to match the full text before AB# to a state name on the work item type.
    2. If no state name matches, it tries to match it to a state category (for example, Resolved or Completed).
    3. If a category matches, the work item is moved to the first state in that category.
    4. If neither a state nor a category matches, the keyword is ignored and the work item state is not updated.

    Therefore, if Ready For Deploy AB#1344 is not changing the state, it means:

    • The work item type does not have a state named exactly Ready For Deploy, and
    • There is no state category named Ready For Deploy.

    To make it work, either:

    • Rename or add a state so its name is exactly Ready For Deploy, or
    • Use a state/category name that already exists in the process (for example, Resolved AB#1344 or Closed AB#1344).

    Also note: state transition rules only apply when the pull request is merged into the default branch.


    References:

    AI-generated content may be incorrect. Read our transparency notes for more information.

    Was this answer helpful?

Your answer

Answers can be marked as 'Accepted' by the question author and 'Recommended' by moderators, which helps users know the answer solved the author's problem.