Appearance
Simple Issue Links FAQ
What is Simple Issue Links used for?
Simple Issue Links provides an alternative to standard Jira issue linking. The Issue Reference Field Type lets you create a searchable dropdown of issues based on a JQL query, making it easy to link related issues.
How do I create an Issue Reference field?
- Navigate to Admin ⚙ > Issues > Custom fields
- Click Create custom field
- Select Issue Reference Field Type
- Name your field and click Create
- Configure the field in Admin ⚙ > Apps > Simple Issue Links Configuration
Can the Issue Reference field create automatic links?
Yes. When configuring the field, you can optionally select a Jira link type. When a user selects an issue in the field, a standard Jira issue link of that type will be automatically created.
What JQL can I use in Issue Reference fields?
You can use any valid Jira JQL, including:
- Project filters:
project = "MY PROJECT" - Status filters:
status = "In Progress" - Issue type filters:
issuetype = "Story" - Custom field filters:
customfield_xxxxx = "value" - Date functions:
created >= -7d
Combine filters with AND/OR operators to create powerful queries.
Are there limitations on the number of issues that can be displayed?
The Issue Reference Field can display a large number of issues, but very large result sets (thousands of issues) may impact performance. We recommend refining your JQL query to return a reasonable number of results. To improve performance:
- Keep JQL queries specific and efficient
- Avoid very large result sets (thousands of issues)
- Use indexed fields in your JQL when possible
- Consider breaking into multiple, focused fields instead of one broad field