Problem Definition

Users would expect to get outcomes for Epics related to the Issue when using this JQL:

issue in linkedIssues("QQQ-1", "has Epic", "is Epic of")

'QQQ-1' is the Issue Key

However, when using the JQL, it would return no results nor error message:

The expected behavior when using non-existing Link Types would be to receive an error message:

This current behavior can be confusing

Side note: Creating a Link Type with "has Epic" and "is Epic of" would yield results should there be any issues using the Link Type. However, this can cause further confusion.

Suggested Solution

Throw an error message when using the JQL to avoid confusing the user. Additionally, the error message could also include the alternative JQL to use.

Workaround

Use the following JQL based on the use case:

• If the Issue with an Epic is known:

  Issue in (<key>)
  

  Replace <key> with the Issue Key linked to an Epic. If there are multiple Issue Keys, add it in with ','

  • From the outcome, take note of the Epic Link column as that would indicate the name of the Epics
• If you want to display all Epics in a Project

  project = <pkey> AND "Epic Name" is not EMPTY
  

  Replace <pkey> with the Project Key

  • The outcome would display the Epics in the Project. Take note of the Epic Name column to know the Epic name and Key column to know the Issue Key for the Epic
• To list out all the Issues linked to a known Epic:

  "Epic Link" = epic1
  

  epic1 is the Epic Name/Link

  • The outcome would list out all the issues that have the 'Epic Link' field populated with the stated Epic Name/Link