Documentation for JIRA 4.4. Documentation for other versions of JIRA is available too.

Skip to end of metadata
Go to start of metadata
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:

On this page:

(warning) The information on this page does not apply to JIRA OnDemand.

To link a JIRA project to a project or space in another application:

  1. Log in as a user with the 'JIRA Administrators' global permission and navigate to the administration page for the project. See Defining a Project for details.
  2. On the the 'Projects' page, choose the JIRA project that you want to link to another project.
  3. On the project's configuration page, locate the 'Application Links' section and click 'Configure Application Links'.
  4. The instructions for adding a project link will vary depending on whether the target application has the Application Links functionality installed:
    • If the target application has Application Links:
      1. Click 'Add Link'. A dropdown menu will appear listing the applications you have already linked to.
      2. 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.
      3. Click one of the options on the 'Authorization required' screen:
        • 'Authorize' — Click this option if you want 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' — Click this option if you only want to allow anonymous access to the target project.
      4. 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.
      5. Click the 'Create' button to create the project link.
    • If the target application does not have Application Links:
      1. Click 'Add Link'. A dropdown menu will display listing the applications you have already linked to.
      2. 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.
      3. 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.
      4. (optional) Enter the alias for the project in the 'Alias' field. This is the display name for the project in your administration console.
      5. Click the 'Create' button to create the project link.

Screenshots above: Linking to another JIRA project where the target JIRA server supports Application Links (click to view full-size images)

Notes

Related Topics

Making a Project Link the Primary Link
Deleting a Project Link