Issue preview customization
On this page:
In this article, we show you how to configure a customized preview popup when you’re hovering over an Artifact link.

Example of an Issue Preview displayed when hovering a Jira Issue in IBM ELM.
Default field to appear in issue previews
There are a few fields that are shown by default, even if they are not in your Screen configuration:
Project Name
Issue Type
Priority
Affects Version/s
Description
Issue Links
Status
Resolution
Fix Version/s
Assignee
Reporter
Created Date
Updated Date
Creating an Issue Preview
To customize an Issue Preview, we leverage the Screens feature of Jira to list and organize which additional Fields should be displayed in the Preview.
To customize your Issue Preview:
Go to the Screens configuration page of Jira.
Click the Jira Administration icon in the top right corner and go to the
Issues
tab.Click
Screens
in the Screens section.
Upon reaching the Screens management page, you can either click the Add Screen
button in the top right corner or Configure
an existing Screen.
Use the input field at the bottom to add Fields to your Screen configuration. You can add multiple tabs to organize the Fields in different sections of the Preview.

In the above example, we have a simple Screen configuration with a single tab holding three Fields.
Related documentation:
You can check out the official Atlassian Jira documentation for a more in-depth guide of Screen configuration: https://confluence.atlassian.com/adminjiraserver0813/defining-a-screen-1027137981.html
Selecting an Issue Preview
Now that you have a custom Screen to use, you need to define when it will be used. This configuration is done on the OSLC Connect Issue Previews configuration page.
To reach this configuration page, simply:
Click the Jira Administration icon in the top right corner and go to the
Manage apps
tab.Click
Issue Previews
in the OSLC Connect section.
This page will allow you to precisely choose when to use your custom Screen for previews:
Start by choosing your Issue Type Scheme in the first list.
Select a Default Scheme Screen in the list below. This will now be the default Screen used to preview issues.
(Optional) If you want, you can choose a different Screen to preview a specific Issue Type.
Click the
Save
button.

An example of Issue Preview configuration, using a Custom Preview screen for all Issue Types except for the Bug Type, that uses a specific Screen.
Before-after comparison
As an example, you can see below a comparison of the same issue being previewed from ELM.
The first image is the preview with a default empty screen configuration for the preview.

Preview with a default empty screen configuration.
The second image is the preview with a customized screen configuration that uses two sections (Additional Information; Details) to display four new fields (Summary; Labels; Component/s; Due Date).

Preview with a customized screen configuration that uses two sections to display four new fields.
Note that even though it pushes down the Description field, it is still fully readable by scrolling inside the preview or using the Show More
option.