Table of Contents

Issue Workflow Configuration

YouTrack's workflow engine lets you define state machines for issues, automate transitions, and enforce rules.

What this page covers

  • Default workflow states and transitions
  • Configuring the Stage field as the primary workflow state
  • Automation rules: auto-assign, auto-transition
  • Integration with Gitea via webhooks
  • The AI agent workflow states

Workflow states

For the self-hosted dev platform, the recommended workflow states map to the Stage custom field:

To DO → In Progress → Code Review → Done

The AI State field tracks AI agent activity independently:

Ready → Progressing → Done
              ↓
           Blocked

Automation rules

YouTrack supports automation rules that trigger on issue events. Useful automations:

  • When a PR is merged in Gitea, move the linked issue to Done.
  • When an issue is assigned to an AI agent, set AI State to Ready.