Last updated Jan 9, 2020

Rate this page:

Creating a custom issue link dialog for remote issue links


JIRA 5.0 and later.

This guide will show you how to create a custom dialog for creating issue links, which makes it easier for users to create remote links to a third-party application in JIRA.


  1. Insert a web item in your atlassian-plugin.xml with a section attribute having a value of 'create-issue-link-types'.

    <web-item key="add-myapp-link" section="create-issue-link-types" weight="100">
      <label key="" />
      <link linkId="add-myapp-link-link">
  2. Insert a webwork action in your atlassian-plugin.xml with an alias attribute matching the link destination defined in the web item above.

    <webwork1 key="link-myapp-entity" name="Link My Application Entities" class="java.lang.Object">
        <action name="com.mycompany.myapp.LinkMyAppEntity" alias="LinkMyAppEntity">
          <view name="error">/templates/dialog/linkmyappentity.vm</view>
          <view name="input">/templates/dialog/linkmyappentity.vm</view>
  3. Write a matching webwork action and a velocity template. Examples:

    • linkremotejiraissue.vm

Rate this page: