Resolve work item linking problems in Jira Cloud projects

Platform Notice: Cloud Only - This article only applies to Atlassian apps on the cloud platform.

Summary

Users are unable to link work items in one or more Jira projects, and the Linked Work Items field isn't visible on some projects.

Solution

There are multiple causes for this behavior. Depending on the way the problem appears, the solution may also differ.

Tip: Before you change anything, find the case below that matches your problem. The fix depends on whether linking fails in all projects, only in certain projects, or only for some users.

No users are able to link work items across any projects

Enable the global setting to allow work item linking across Jira:

  1. Select Settings > Work items.

  2. Select Work item Linking.

  3. Check the status message. It shows whether work item linking is OFF or ON.

  4. If it's OFF, select Activate.

No users are able to link work items across certain projects

  1. Add the Linked work items field to the View and Edit screens for each affected project. See Add a field to a screen.

  2. Make sure the Linked work items field isn't hidden in the project's field configuration. See Specify field behavior (hide or show a field)..

Some users are unable to link work items across certain projects

Grant Link work items permission in the workspace permission scheme:

  1. Navigate to your Jira Space.

  2. Select Space settings > Permissions.

  3. Select Actions > Edit permissions.

  4. Grant Link work items to the appropriate groups, project roles, or individuals.

If the above suggestions don't help, please raise a ticket with Atlassian Support here: https://support.atlassian.com

Updated on October 21, 2026

Still need help?

The Atlassian Community is here for you.