Last updated Jul 18, 2024

Use multiple issue contexts in the issue view

New Jira issue view

As an app developer, you can define multiple issue context modules in your descriptor, but Jira will only display the first issue context module returned (after any conditions have been evaluated). We recommend you avoid selecting conditions that result in more than one issue context panel appearing on an issue.


Using multiple issue context panels to represent different entities

If your app has multiple entities you want to represent using issue context panels, you can make use of conditions. For example, if you're building a Git integration, you might want to show related commits, branches, and pull requests for an issue.

In this example, you could define an issue context module in your descriptor for each of these:

  • Commits
  • Branches
  • Pull requests

You could then make use of conditions to validate against properties that you store against the issue to choose the issue context panel to be displayed.

For each panel you could use a predefined condition, like entity_property_equal_to. You could then define the condition to decide which panel to display.

  • Commits: 'git_integration_display_context_panel === commits'
  • Branches: 'git_integration_display_context_panel === branches'
  • Pull requests: 'git_integration_display_context_panel === pull-requests'

Using multiple issue context panels for empty states

Your app may want to have an experience where you want users to take an action before you display an issue context panel. You can define multiple panels to create this experience.

For example, through using conditions and app properties, you could define an issue context panel that prompts users to "Link a conversation".

Context panel with call to action

When a user clicks your panel, you could use the modal dialog target to design a view where the user links a conversation to the issue through your app.

Once a conversation is linked, you could use conditions and app properties to change your panel to communicate that a conversation has been linked.

Context panel with linked conversation

Rate this page: