Let's assume that you are managing a project or team. You would like to connect your project's Confluence space with your JIRA project, and link up your team's source repository too.

When you have connected your applications via Application Links, you can also connect the areas of those applications that contain information relating to your project or team. Using project links (also called entity links) you can associate one or more projects, spaces and repositories across the linked applications.

To connect all the information relating to the project or team that you are managing, you can link one or more of the following:

  • JIRA projects.
  • Confluence spaces.
  • FishEye repositories.
  • FishEye projects. A FishEye 'project' is the Crucible project if you have installed FishEye and Crucible, otherwise it is the paths associated via the 'FishEye Project Content' function in FishEye.
  • Crucible projects.

  • Bamboo projects.

    Note, we do not recommend the use of project links with FishEye 2.9 and later, if you have JIRA 5.0 or later as well as the latest version of the JIRA FishEye Plugin. This is because application links now provide all of the functionality previously available with project links. However, project links are retained in FishEye and Crucible for the following reasons:

    • Setting up project links provides a way to restrict the scope of JIRA searches, which can provide performance benefits.
    • Legacy configurations can continue to use project links without any need for changes.
    • Third-party plugins may continue to rely on project links for their functionality.

On this page:

To add a project link:

  1. Log in to your application as an administrator and navigate to the administration page for the project:
  2. Choose the project in your local application that you want to link from. For example, you may want to link a FishEye repository to another type of project.
  3. The instructions for adding a project link will vary depending on whether the target application has Application Links:
    • If the target application has Application Links:
      1. Click Add Link. Then, in the dropdown menu, click the application that contains the project you want to link to. For example, if you want to link to a specific JIRA project, click the JIRA site that contains that project. If you want to link to a Confluence space, click the Confluence site that contains that space.
      2. Click one of the options on the 'Authorization required' screen:
        • Authorize — Select to grant your project authorised access to the target project. The target application will open in a new window, so that you can log in and authorise access.
        • Skip – your access is anonymous — Select if you only want to allow anonymous access to the target project.
      3. In the Name or Key field, enter the name/key of the project in the remote application that you want to link to. For example, if you want to link to a JIRA project, enter the project key. If you want to link to a Confluence space, enter the space key.
      4. Click the Create button to create the project link.
    • If the target application does not have Application Links:
      1. Click Add Link. Then, in the dropdown menu, click the application that contains the project you want to link to. For example, if you want to link to a specific JIRA project, click the JIRA site that contains that project. If you want to link to a Confluence space, click the Confluence site that contains that space.
      2. In the Key field, enter the name/key of the project in the remote application that you want to link to. For example, if you want to link to a JIRA project, enter the project key. If you want to link to a Confluence space, enter the space key.
      3. (optional) Enter the alias for the project in the Alias field. This is the display name for the project in your administration console.
      4. Click the Create button to create the project link.

Step 1
Step 2
Step 3

Screenshots above: Linking to a JIRA project (where target JIRA server includes Application Links)

Making an Entity Link the Primary Link
Delete an Entity Link

  • No labels

7 Comments

  1. Bob Swift

    This information is confusing. I finally figured it out, but, needs specific examples for how to get to the place to create an entity link for each of the applications.  Also need information on what this means if I link a Confluence space to a JIRA project for instance - what new capabilities are now available?. 

  2. Fabrizio Galletti

    Same question there.

    From entity to application link, JIRA version a lot of things has changed

  3. user-5b015

    That would definitely be helpful.  Same question as Bob.  I've got the links set up between Jira Project and Confluence space, but I don't know how to now easily add a link to a page within that confluence space.

    Will someone from atlassian please enlighten us?

  4. Soni M

    It would be useful if information is provided on linking the space created in confluence with applications created using Adobe Air. 

    Is it possible to link the confluence project with other application set up using the Application Link feature? 

  5. Eunice Mora

    ??? Too bad nobody from Atlassian has answered on what is the usability.

  6. Gaurav Mishra

    Exactly the same question like all above, what does this integration provides? I see a document at Application Links Documentation but the methods described in that document like linking Issues using JRA-1234 no longer work, may be because that version was released in 18th century. I don't see the similar documentation for the latest version. 

  7. Anonymous

    Is it possible to create an entity link between a JIRA Component and a FishEye repository?