This article shows how to synchronize issue links on Jira Server using external scripts.

    The script is an advanced way of syncing issue links. We recommend to use it in case you don't want the links to be overridden on the source in case the issue remote issue does not have any issue links.

    This script does not override links to linked issues on the source side in case the remote side does not have any linked issue. If this is not your case we recommend to use simple issue links synchronization.


    1. Create the File from the Exalate Public Repository

    We store external scripts for Jira Server in a public repository. Copy the code from the repository below and create a .groovy file. You must keep the file names as below.

    2. Upload the File with the External Script

    You need to upload the .groovy file into the scripts directory

    External scripts library location

    Jira Server: $JIRA_HOME/scripts

    3. Call the Script from the Sync Rules

    Once all external .groovy files have been uploaded to the proper directory, you need to call the script from the Sync Rules. Every .groovy file includes comments with a detailed explanation on how to use it. For more information, please read the file comments.

    Source Side

    Outgoing sync


    Destination Side

    Incoming sync

     linkTypeMapping = [
    	// replace the mapping below acordindly "Remote side" : "Local side"
       "Blocks" : "Relates"