Come for the products,
stay for the community

The Atlassian Community can help you and your team get more value out of Atlassian products and practices.

Atlassian Community about banner
Community Members
Community Events
Community Groups

Jira and Jira Align Integration: Workflow Best Practices

Before integrating Jira with Jira Align, there are some best practices that should be considered. Some are a little more rigid than others; while others can lend themselves to some workarounds. Let's explore further to understand what these are, why these are important and the potential impacts. 


Full end-to-end flows

Jira workflows should represent full end-to end flows starting with statuses prior to being ready and ending with a “Done” status.

Why: When creating an issue, it is not immediately ready to start. There need to be statuses prior to this that account for the refinement of the issue. “Done” status needs to have a post function to populate the resolution to “Done” which in turn populates the Resolution Date. The Resolution Date is what drives the State of the story being “Accepted” in Jira Align.

Where the "Accepted" state for features in Jira Align is driven by the state mapping, the Accepted Date that is captured in the Audit Log on a feature in Jira Align is driven by the Resolution Date.

A Post Function is also needed to clear the Resolution if the issue is moved out of “Done” status.

Related articles:


Standard and less complex workflows

Jira workflows should be standardized and less complex when possible (especially at the team level). It is recommended to have a standard workflow scheme that is standard to all projects or limit the number of variations.

Why: Jira statuses are mapped to/from Jira Align states/process steps. Standard and less complex workflows reduce administration overhead and potential state mapping issues.

Workaround: Bi-directional syncing of process steps can be enabled to help with more complex workflows but would still need standardization. When combining multiple workflows into a single Process Step flow in Jira Align will present process steps not used by all teams.


Do not require transition approvals (for bi-directional syncs)

Jira workflows should not enforce transition approvals. Transitions should accommodate potential changes via Jira Align.

Why: If there are transition approvals and the process step/state is updated in Jira Align, it will fail to sync to Jira. If using transition approvals, statuses can only be updated via Jira. This is not as problematic at the team level where most status updates will be done via Jira. There are no transition restrictions in JA. Any transition not supported will not sync to Jira.

Related article: Workflow approval


Related Articles



Log in or Sign up to comment
Community showcase
Published in Jira Align

Rockin' the Roadmap - How to make most of the Roadmap with Jira Align

The roadmap challenge for large scale agile enterprises Regardless of the agile framework you use, the agile enterprise has a massive scale with the challenge to connect hundreds of teams and thous...

2,537 views 7 26
Read article

Community Events

Connect with like-minded Atlassian users at free events near you!

Find an event

Connect with like-minded Atlassian users at free events near you!

Unfortunately there are no Community Events near you at the moment.

Host an event

You're one step closer to meeting fellow Atlassian users at your local event. Learn more about Community Events

Events near you