Last updated Jul 11, 2024

Creating Remote Issue Links


JIRA 5.0 and later.

Remote Issue Links offers a simple but powerful way to integrate your application with JIRA. If you have an object in your application that relates to a JIRA ticket, you can link that object to the JIRA issue using Remote Issue Links.


Let's say you have a support ticket raised by a customer in your help desk system and the bug that causes that issue is being tracked in JIRA. With a single API call, you can create a link in that JIRA issue pointing to the support ticket. You can provide an icon, a title, a summary, even a status icon for the remote object.

Want to understand more? Here's a quick video on creating Remote Issue Links via REST.

REST API Tutorial

Want to see some JSON? See how easy it is to create a Remote Issue Link in the REST API tutorial.


You can also manage remote issue links from within JIRA using the Java API. The key classes are:

Guide to Fields

All the fields used in the Remote Issue Link API are described in the guide to Remote Issue Links fields.

You can now create an issue link renderer plugin to customise how issue links appear for your application. Find out more in the guide to the Issue Link Renderer plugin

You can also create a dialog for easy insertion of links to your application. Find out more in the guide to the issue link creation dialog.

Rate this page: