This page last changed on Jan 12, 2011 by jhammons.
On this page:
What is a 'Screen'?
Screens group multiple issue fields. Using Screens, you can control which fields are displayed, and the fields' vertical display order, during issue operations (e.g. 'Create Issue' and 'Edit Issue') or workflow transitions (e.g. 'Resolve Issue'). You can also split fields on a Screen into multiple tabs.
Screens overlap slightly with Field Configurations in regards to field visibility. Note that when a Screen is displayed to a user (during issue creation, for example) the user will see only the issue fields that:
- the user has permissions to edit (e.g. the 'Due Date' field can only be edited by users with the 'Schedule Issues' permission).
- are present on the Screen that is associated with the 'Create Issue' operation for this issue.
- are not hidden in the Field Configuration applicable to the issue.
 | A field may be present on a Screen, but if it is hidden in an appropriate Field Configuration, it will not be visible to the user when the Screen is displayed. Note also that, if a particular field needs to be hidden at all times, it is simpler to hide the field in an applicable Field Configuration rather than remove it from all Screens. For more information please see the Overview. |
Configuring a Screen's Fields
- Log in as a user with the 'JIRA Administrators' global permission.
- Bring up the administration page by clicking either the 'Administration' link on the top bar or the title of the Administration box on the dashboard.
- In the Issue Fields section of the left-hand side column, click the 'Screens' link. (If the Issue Fields section is collapsed and is hiding the Screens link, click the 'Issue Fields' section heading itself to expand this section.) You will then be directed to the View Screens page:

From this page you can:
- Click the 'Configure' link next to the Screen of interest. You will now see that Screen's Configure Screen page.

Adding a Field to Screen
In the Add Field form, located at the bottom of the Configure Screen page:
- Select the field/s that you wish to add to the screen from the 'Fields to add' option.
- If you wish, specify the position at which the field will be placed, by entering the position number in the 'Position' option.
 | If you have selected multiple fields and specified a position, the topmost field selected will be placed in the corresponding position and the other fields directly below it. |
- Click the 'Add' button.
Removing a Field from a Screen
In the table of fields on the Configure Screen page:
- Select the check boxes next the the fields you wish to remove.
- Click the 'Remove' button located at the bottom of the table.
- The fields will be removed from the Screen and will be made available in the Add Field form at the bottom of the screen, for subsequent re-addition.
 | The 'Summary' field is always required by the system. If your screen is being used for a 'create issue' operation, you will need to ensure that the 'Summary' field is on the screen, or your users will be unable to create issues. |
Reordering Fields on a Screen
To change the vertical display order of fields on a screen, in the table of fields on the Configure Screen page:
- Specify the number of the position to which a field should be moved inside the field's text box within the Move to Position column. (You can repeat this step for multiple fields by specifying a different position for each field you wish to move.)
- Click the 'Move' button located at the bottom of the table in the Move to Position column.
- All the fields will be moved to the positions that you specified.
 | Alternatively, you can click on the arrows next to the desired field to move the field up, down, to the first position or to the last position. |
Adding Time Tracking capabilities to a screen
You can add the ability to log work or specify/modify time estimates to a screen by adding the Log Work or Time Tracking fields, respectively.
By adding both of these fields to a screen, your users will be able to log work and specify time estimates on that screen. For more information about how this works for a user, please refer to Logging work and/or specifying time estimates on the same JIRA screen.
To add abilities to log work and/or specify/modify time estimates on a screen, in the Add Field form located at the end of the Configure Screen page:
- Select one or both of the following fields from the 'Fields to add' option, depending on your requirements:
- Log Work — adds a group of fields which provide the ability to log work
- Time Tracking — adds a group of fields which provide the ability to specify/modify time estimates
- Click the 'Add' button.
 | If these fields cannot be seen in the Fields to add selection box and they have not already been added to the screen, then confirm that JIRA's Time Tracking feature has been activated. These fields will not be available to add to any screen if Time Tracking is deactivated.
If any screens have the Log Work or Time Tracking fields and JIRA's Time Tracking feature is subsequently deactivated, those screens will retain these fields until these fields are removed. However, the fields will not be visible to the user until Time Tracking is reactivated. |
Adding a Screen
In the Add Screen form, located at the bottom of the View Screens page (see 'Configuring a Screen's Fields', above):
- Enter the name of the new Screen in the 'Name' field.
- You can optionally add a description in the in the 'Description' field.
- Click the 'Add' button. The the Screen list will automatically be updated with the new Screen.
Editing a Screen's Details
To change Screen's name and/or description, on the View Screens page (see 'Configuring a Screen's Fields', above):
- Click the 'Edit' link next to the appropriate screen.
- You will now be directed to the Edit Screen page where you can edit the name and/or description of the Screen.
- Click the 'Update' button. You will be brought back to the View Screens page with your updates now applied to the Screen.

Copying a Screen
On the View Screens page (see 'Configuring a Screen's Fields', above):
- Click on the 'Copy' link next to the Screen you wish to copy. You will be directed to the Copy Screen page.
- Enter a name and a description for the new Screen in the respective 'Name' and 'Description' fields.
- Click the 'Copy' button. You will be brought back to the "View Screens" page, and the newly added Screen will have the same issue fields and field positions as the original field screen.

Deleting a Screen
To entirely remove a Screen from the system, on the View Screens page (see 'Configuring a Screen's Fields', above):
- Click the 'Delete' link next to the Screen you wish to delete.
- Click the 'Delete' button to confirm this action. You will be brought back to the View Screens page and the Screen removed from the list of Screens.

 | Screens that are associated with at one or more Screen Schemes, or one or more workflow transitions, cannot be deleted. |
Configuring Tabs
Splitting a Screen into multiple tabs can help to group related fields. For example, the following screenshot shows a simple Screen that only shows the issue 'Summary' and 'Description' on the first tab ('Main'), and 'Affected Versions' and 'Components' on the second tab ('Other Details'):
This functionality is very useful for organising complex Screens, as you can place less used fields ('Attachment' and 'Environment', for example) onto separate tabs:

Screen tabs are available from the "Configure Screens" page (see 'Configuring a Screen's Fields', above).
Adding a Tab
In the Add New Tab form, located at the bottom of the Configure Screen page:
- Enter the name of the new tab in the 'Name' field.
- Click the 'Add' button.
Moving fields between Tabs
If your screen contains multiple tabs, you can move fields from one tab to another.
In the table of fields on the Configure Screen page:
- For the field you wish to move, select the field's destination tab in the Move to Tab column. Repeat this for all the fields you wish to move.
- Click the 'Move' button located at the bottom of the table in the Move to Tab column.
- All the selected fields will be moved to the appropriate tabs.
 | Please Note:
- Fields of type 'Date' can only be displayed in the 'Dates' area of the screen, even if they are custom fields.
- System fields on the default 'View Issue' screen (e.g. Summary, Security Level, Issue Type, etc.) are fixed and cannot be moved onto a separate tab. However, any other custom fields (excet 'Date' fields) that have been added to the 'View Issue' screen can be moved onto a separate tab. This restriction only applies to the screen associated with the 'View Issue' operation, i.e. system fields can be moved onto other tabs for screens associated with operations such as 'Create Issue', 'Edit Issue', etc.
|
Navigating between Tabs
To navigate between the Tabs of a Screen, simply click on their linked tab names at the top left of the table of fields on the Configure Screen page.
Deleting a Tab
In the table of fields on the Configure Screen page:
- Navigate to the Tab you wish to remove.
- Click the 'Delete' tab link. You will now be directed to the Delete Tab confirmation page.
- Click the 'Delete' button to confirm. You will be returned to the Configure Screen Page.

Renaming a Tab
In the table of fields on the Configure Screen page:
- Navigate to the desired Tab.
- The 'Rename' text field is located in the top left of the Configure Screen Tab form.
- Enter the new name of the Tab.
- Click 'Enter'.
Reordering Tabs
It is possible to configure the horizontal order of Tabs by clicking on the selected tab's arrows to move that Tab left or right (in the direction of the arrow).
Activating a Screen
To make a Screen available to users, you can either:
|