Showing results for 
Search instead for 
Did you mean: 
Sign up Log in
Deleted user
0 / 0 points
badges earned

Your Points Tracker
  • Global
  • Feed

Badge for your thoughts?

You're enrolled in our new beta rewards program. Join our group to get the inside scoop and share your feedback.

Join group
Give the gift of kudos
You have 0 kudos available to give
Who do you want to recognize?
Why do you want to recognize them?
Great job appreciating your peers!
Check back soon to give more kudos.

Past Kudos Given
No kudos given
You haven't given any kudos yet. Share the love above and you'll see it here.

It's not the same without you

Join the community to find out what other Atlassian users are discussing, debating and creating.

Atlassian Community Hero Image Collage

Jira and Jira Align Integration: Configure Custom Issue Type Mapping and Stories of Type Defect

Custom issue types in Jira can be mapped to Jira Align stories of select types.  


Mapping Custom Issue Types in Jira Align:

Navigate to Jira Align Admin section > Jira Settings > Custom Issue Types panel > Click Add and input the Name of any Custom Issue Types that you would like to synchronize with a Jira Align Story of the selected Type then select the matching Jira Align Story Type from its corresponding drop-down then click Save.  The selector toggles are used to select and Delete a Custom Issue Type. They do not need to be utilized when adding Custom Issue Types.

Note: There needs to be a one to one mapping between Custom Issue Types in Jira and Story Types in Jira Align or data will not sync properly.  



Defining Custom Issue Types in Jira Align:

Custom Story Types can be defined by navigating to Jira Align Admin > Platform > Dropdowns Panel > Story Type




Custom Issue Type Fields and Filtering

Custom Issue Types that are integrated with Jira Align will sync in the same manner as traditional Jira Stories except that the Jira Align type field on the Story will reflect what Type of Story was integrated.  The fields that sync between Jira and Jira Align on Stories and Custom Issue Types can be found here:

Stories can be filtered in the Jira Align Stories Grid base off of the Type field as show below.


Stories of Type Defect

The Jira Align Defect has a separate Backlog than Jira Align Stories meaning that Jira Align Defects cannot be linked to Jira Align Features (Jira Epics) or have their Story Points vertically aggregate to the Enterprise Level.  More information can be read on the Jira Align defect here:

Some organizations would rather be able to Link their Jira Bugs to Jira Epics and synchronize Story Points on Bugs from Jira to Jira Align so it makes more sense for them to sync Jira Bugs to Jira Align Stories of Type Defect instead of the native Jira Align Defect.  

If syncing the Jira Bug to the Jira Align Defect these fields should be populated under Jira Align Admin > Jira Settings > Jira Setup


If syncing the Jira Bug to the Jira Align Story of Type Defect the above fields should be left blank and the following fields should be populated under Jira Align Admin > Jira Settings > Custom Issue Types


The Jira Align Story of Type Defect will function as a normal Jira Align Story outside of having a Type Defect. If you original setup the connector to sync Jira Bugs to Jira Align Defects and wish to convert to Story of Type Defects you can null out the Bug to Defect mapping and populate the Custom Issue Type mapping then run a custom JQL to update all data.  Information on custom JQLs can be found here:


Hello, thank you for the article! Wanted to let you know that I am unable to see the photos attached to this article.

missing photo.JPG

Like # people like this
Tim Keyes Atlassian Team Jan 06, 2020

Hi Esme,

Thank you for the note.  Can you please check again.  I have removed and readded the images.



Tim Keyes

Like Shawn Kessler likes this

Hi Tim, 

I checked again and I am still unable to view the images.



Tim Keyes Atlassian Team Jan 06, 2020

Hi Esme,


Can you please verify if you can see them now?

I was originally hosting the images internally on the Atlassian Network and have made them public through public hosting. 

Thank you for the assistance, it is greatly appreciated!

Tim Keyes  

Like # people like this

Hi Tim,

Yes, I am able to see them now! 



Peter Jessen Community Leader Jan 07, 2020

Hi @Tim Keyes,

Nicely written article. Of course, I didn't see it until after I wrote up this related one.


Like # people like this
FUN MAN ANDY Community Leader Jan 09, 2020

@Peter Jessen Never a bad thing to have as MUCH knowledge from different perspectives on Community. Nice job!! And great knowledge share! #KUDOS

Like # people like this

@Tim Keyes , how does align handle the resolution field in JIRA? I did not see even a reference to it.

Hi Reza,

Thank you for the question. 

Jira Align will treat the resolution differently for defects and stories.

Additional information can be found in this article:

  • If a bug in Jira Software is in any status other than Resolved, the defect's status will be Open in Jira Align.
  • If a bug's Resolution is set to Done in Jira Software, the Defect will be set to Closed in Jira Align.
  • The Accepted state for stories is not configured on this panel, as the Accepted status from Jira Software to Jira Align is based off of the Accepted Date field.  The Accepted Date field is configured in the Jira Align Administration > Jira Settings > Jira Setup tab in the Custom Fields section.
  • A combination of Done + Resolution states in Jira Software is required in order to transition a story's state to Accepted in Jira Align.

Please let us know if you have any additional questions.



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

Helpful hints if you're rolling Align out to your entire enterprise

(Or, What to expect when you’re expanding.) Once you've completed your Jumpstart, or your initial assessment of Jira Align, you'll start to think about how you can roll it out to the rest of your e...

1,091 views 3 25
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