Last updatedAug 14, 2019

Use multiple glances in the issue view

New Jira issue view

These design guidelines relate to the new Jira issue view, which is currently only available to some Jira Software users. New modules and extension patterns on this page only relate to Jira Software right now, but we'll be adding them to Jira Service Desk in the near future.

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




Using multiple glances to represent different entities

If your app has multiple entities you want to represent using glances, 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 a glance 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 glance to be displayed.

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

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



Using multiple glances for empty states

Your app may want to have an experience where you want users to take an action before you display a glance. You can define multiple glances to create this experience.

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

Glance with call to action

When a user clicks your glance, 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 glance to communicate that a conversation has been linked.

Glance with linked conversation