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

Acceptance Criteria Sync

If you have any documentation related to Acceptance Criteria sync between Jira Align and Jira please share

1 answer

1 accepted

2 votes
Answer accepted

Hi @Vandana Kurapati,

This Help article addresses the Jira integration with Jira Align  -

Within the article is this section:

Sync acceptance criteria

For features and stories, you can synchronize a Jira custom field with acceptance criteria with Jira Align's acceptance criteria. In the box, type the Jira custom field ID that is used for acceptance criteria, for example, customfield_12345. After the acceptance criteria are synchronized with Jira custom field, no more acceptance criteria fields can be added in Jira Align. You can add all acceptance criteria in one field in Jira Align.

Some things that may not be clear from the above:

  1. This is a limitation of the Atlassian Jira API, not Jira Align's connector, as far as I know. I will defer to Jira Align Support for the technical details as to the why.
  2. There is one Jira custom field value that can be entered in Jira Align for Acceptance Criteria.
    • This means that if you want to integrate Acceptance Criteria for stories but not features, it is not possible.
    • The moment you populate the Acceptance Criteria Jira custom field value in Jira Align, you lose native Jira Align multiple acceptance criteria functionality/granularity for both features and stories.
  3. What are the options?
    • Don't integrate Acceptance Criteria between Jira and Jira Align to maintain the ability to have multiple, track-able Acceptance Criteria for reporting and health visibility in Jira Align.
      • For features:
        • In Jira you would not enter any acceptance criteria on the features.
        • Only enter acceptance criteria on the features in Jira Align.
      • For stories:
        • In Jira you can enter the story acceptance criteria in the description field or in the single Jira acceptance criteria field.
          • If you enter them in the Jira AC field they will not sync to Jira Align
        • In Jira Align - allow the acceptance criteria to sync via the Jira story description field or enter them as granular acceptance criteria and manually maintain them in Jira's AC field or keep them in sync via the description field.
    • Integrate Acceptance Criteria between Jira and Jira Align and lose the native Jira Align multiple/granular Acceptance Criteria functionality
      • This maintains automatic syncing of the Jira Acceptance Criteria text field to Jira Align, but you lose the robustness of the native Jira Align functionality that provides progress and health at a more granular level than is available in Jira natively.


@Peter Jessen for the win!

Like # people like this

@julie_byrne is in the house! Welcome, my friend!

Like # people like this

Hey @Shawn Kessler  - so excited to have this community resource for Jira Align. :)

Like # people like this
Like Peter Jessen likes this

After integrating Acceptance Criteria between Jira and Jira Align- JA to Jira Acceptance Criteria sync is happening only once and any more updates to JA Acceptance Criteria is not synching with Jira. Is this known issue?

Hi @Vandana Kurapati ,

Can you be more specific? Updates only occur when the AC field is changed by at least one character in either Jira or Jira Align.

I suggest you check with your Jira Align admin to see if the fields are properly configured in the connector.

Also, if the Jira admin replaced the Acceptance Criteria custom field in Jira, then it might have a new custom filed ID and will no longer sync.

There are multiple reasons fields won't sync between the systems that could be at the Jira project level, the field level, the screen level, or the connector.


Super helpful information, Peter! Just a further clarification that you can add acceptance criteria to the feature (Jira epic) in Jira and the integration will create and add it to the feature in JA. Also, updates to AC are synced bi-directionally.AC in JA.png

Suggest an answer

Log in or Sign up to answer
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,570 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