Skip to main content

​
Benefits of connecting Jira to Windmill

Connecting Jira to Windmill ensures engineering work is accurately reflected in 1:1s and performance reviews — without engineers needing to write self-promotional summaries or dig through old tickets.
  • Captures real progress, ownership, and work patterns automatically
  • Reduces review prep time for engineers and managers
  • Highlights meaningful contributions beyond lines of code (debugging, triage, architecture, support)
  • Brings visibility to collaboration, problem-solving, and delivery reliability
  • Makes performance reviews more fair, objective, and grounded in actual work
Windmill turns ongoing Jira activity into structured performance and coaching context.

​
Connected data

When Jira is connected, Windmill reads work activity and issue content, not source code:
Windmill stores Jira issue descriptions and comment bodies.

​
Permissions

Windmill requests read access through Jira’s API. Windmill syncs all Jira projects that the connected account can access. If Jira data is missing in Windmill, confirm that the connected account can read that project or issue.
Windmill uses the access of the connected Jira account. Use an account with access only to the projects that you want Windmill to sync.

​
Username mapping

Jira uses specific usernames that don’t always map to employee email addresses. If you see Jira activities that aren’t associated with a team member or are associated with the wrong team member, Windmill Admins can fix this. To update username mapping:
1

Open Integration Mappings

Go to Settings > Integration Mappings.
2

Find the person or Jira user

Use the employee and user views to find a missing or incorrect mapping.
3

Update the mapping

Select the mapping, assign the correct employee and Jira user, and save the change.

​
FAQs

Windmill does not change Jira issues, comments, projects, or workflows. It creates and removes a webhook so Jira can send changes to Windmill.
Windmill syncs all projects that the connected Jira account can access. To limit the scope, use a Jira account that can access only the required projects.
Yes. Windmill stores issue descriptions and comment bodies from the Jira projects that the connected account can access.
Webhooks can send some changes shortly after they happen. An hourly incremental sync checks for new or changed data.
Yes. Windmill uses encrypted data transfer, secure storage, scoped OAuth access, and meets SOC 2 compliance standards.
Their historical contributions remain available for context, but Windmill stops associating new activity once the user is deactivated.