Skip to main content
Waterline reads Jira tickets to extract acceptance criteria and map them to your codebase. No admin permissions required.

​
Connect via OAuth

1

Go to Integrations

In Waterline, navigate to Settings → Integrations → Jira and click Connect Jira.
2

Authorize on Atlassian

You’ll be redirected to Atlassian’s OAuth page. Log in and grant access to your Jira projects.
3

Select a Jira site

If you have multiple Jira Cloud sites, choose which one Waterline should access.
4

Done

Jira is connected. Start analyzing tickets from the Analyze tab.
Waterline never creates, updates, or deletes Jira issues.

​
What Waterline reads

Waterline’s analysis automatically extracts acceptance criteria from the ticket description — you don’t need a dedicated custom field, though it helps.

​
Analyzing a ticket

Go to Analyze, select Jira as the source, and enter a ticket key:
Results include a progress percentage, per-criterion breakdown, and the code evidence behind each criterion.

​
Token refresh

Waterline automatically refreshes your Jira OAuth token in the background. If the token is revoked (e.g., access removed in Atlassian), reconnect from Settings → Integrations → Jira.

​
Supported Jira products

  • Jira Cloud — fully supported
  • Jira Data Center / Server — not currently supported