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 Connector - Feature sync failure "Components is required"

Jira Align connected and syncing with an instance of Jira.



  • A newly created Feature in Jira Align fails to create a corresponding Epic in Jira.

  • No errors are seen in the Jira Align audit logs for the feature.

  • Jira Align support sees the following API error on the backend:

ResponseContent:{"errorMessages":[],"errors":{"components":"Components is required."}}, JsonErrors:components=Components is required.

What does this mean?:

  • "Components" has been set to a required field on the Jira project that Jira Align is attempting to sync with. The Jira connector API call to create the Jira Epic does not include a Component entry, which causes the API call to fail.

  • Components is not a supported field within the Jira connector.

What to do?:

  • Remove or make this Jira custom field not required since there is no corresponding Jira Align field that it can be mapped to.

1 comment

HI @Kent Baxley,

Nice concise article. I see this issue way too often when we integrate Jira Align with Jira.

The obvious answer is to have a proper two-day Jira Align Implementation Kick-Off event with one outcome being a well-documented standard for all Jira projects that will map to Jira Align.


Like Kent Baxley likes this


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,615 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