Skip to content
Esc
navigateopen⌘Jpreview
Sign up
On this page

Youtrack

Baz integration guide for Youtrack

By pulling in issue information like titles, descriptions, issue states and labels, and stakeholder comments, Baz ensures that every change request is grounded in intent. Reviewers no longer need to flip between Youtrack and GitHub to understand why a change exists - they get the full story, right where the code is.

Baz uses this context to:

  • Enrich AI-generated summaries and topics with your business objectives.
  • Tailor prompts to reflect the goals and constraints from the YouTrack issue.
  • Help reviewers focus on what’s important by aligning code changes to the original intent.

Configuring Baz & Youtrack

  1. In Baz, open SettingsIntegrationsYoutrack.
  2. Create a personal access token via this link. Assign the scope YouTrack to the token.
  3. Once authorized, Baz will automatically attach issue context to any linked change request.

How Baz Uses Youtrack Issue Data

Once enabled, Baz pulls these fields from linked Youtrack issues:

  • Title & Description – to inform review summaries and reasoning.
  • Issue State & Labels – to set expectations (e.g. bug vs. feature vs. chore).
  • Stakeholder Comments – injected into review prompts as context.

This context powers workflows that:

  1. Generate summaries that reflect your YouTrack objectives.
  2. Break down topics based on feature or flow relevance.
  3. Guide reviewers to evaluate changes through the lens of what the issue was designed to accomplish.

FAQ

How does Baz know which YouTrack item a change relates to?

From issue IDs mentioned in the pull request description, for example AB-123.

What does Baz read from YouTrack?

Title and description, issue state and labels, and stakeholder comments on the linked issue.

Does connecting it change what reviewers see in the code host?

Yes, in the sense that the review itself gets richer: summaries, topics, and agent prompts carry the intent from YouTrack, so reviewers do not have to open the tracker to understand why a change exists.

Nothing is attached to my pull request, what should I check?

Check that the integration is connected under Settings, Integrations, that the branch name or pull request description carries a recognizable identifier, and that the connected account can see the item in YouTrack.

Was this page helpful?