Synchronize a structure using Custom projects and fields


I am trying to synchronize a structure using Custom projects and fields. Here is what I selected.

image2016-2-22 10:48:37.png

I enable the synchronizer but I can't understand what it does or how it works. I worked with synchronizers a lot but I'm new with this one.

My understanding of this feature is that I can use an issue type to work "as an epic" when it comes to structure synchronization. Is that right?

I read the documentation but I still don't understand how to use this synchronizer. What is an "Epic Field"? What does "Scrum Board Epics" mean?

Can you suggest some documentation that would explain this or can you explain it to me?

Thank you very much!

1 answer

Hello Nicolas,

The Agile synchronizer allows you to sync your Structure with one or several JIRA Agile scrum boards (you can sync with Kanban too, but that makes less sense).

Basically it automatically adds to the structure the stories, which being to epics, which are already in the structure.

The Agile board configuration allows you to setup such configuration for one specific board - in this case if you have epics from other boards in your structure, the stories they have won't be pulled it. 


If you want to sync with several boards, it might be easier to use the Custom option and select the projects which the synchronizer should work with.

The epic field setting you have selected is correct as long as you use recent JIRA Agile and don't have any special customisation.

The Epic type allows you to select the issue type that you are using as Epics in your Agile setup. In the default configuration its the actual Epic field.

You can find more details here:


Please don't hesitate to contact us at if you have more questions.


Eugene (ALM Works)

Suggest an answer

Log in or Join to answer
Community showcase
Sarah Schuster
Posted Jan 29, 2018 in Jira

What are common themes you've seen across successful & failed Jira Software implementations?

Hey everyone! My name is Sarah Schuster, and I'm a Customer Success Manager in Atlassian specializing in Jira Software Cloud. Over the next few weeks I will be posting discussion topics (8 total) to ...

2,775 views 11 18
Join discussion

Atlassian User Groups

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

Find a group

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

Find my local user group

Unfortunately there are no AUG chapters near you at the moment.

Start an AUG

You're one step closer to meeting fellow Atlassian users at your local meet up. Learn more about AUGs

Groups near you
Atlassian Team Tour

Join us on the Team Tour

We're bringing product updates and pro tips on teamwork to ten cities around the world.

Save your spot