Documentation for JIRA 5.0. Documentation for other versions of JIRA is available too.

What is a 'screen'?

'Screens' group (a subset of) all available fields defined in JIRA and organise them for presentation to a user. Through screens, you can control what fields are displayed to the user during issue operations (e.g. Create Issue and Edit Issue dialog boxes) or workflow transitions (e.g. Resolve Issue dialog box), as well as define the order in which these fields are shown to them. A screen also allows you to split subsets of fields across multiple tabs.

When it comes to field visibility, screens functionally overlap slightly with field configurations. For example, on the Create Issue dialog box, users will only see issue fields that:

  1. are present on the screen associated with the issue's Create Issue issue operation,
  2. are also not hidden in the field configuration applicable to the issue (as defined by the project's field configuration scheme),
  3. the user has permission to edit (e.g. the Due Date field can only be edited by users with the Schedule Issues project permission),

Hence, a field may be present on a screen used by a project, but if that field is hidden in the field configuration (also used by the same project), that field will not be visible to the user when that screen in the project is displayed.
(tick) If a particular field needs to be hidden at all times, it is easier to hide the field in the relevant field configuration than remove it from all screens. For more information please see the Overview.

(warning) Be aware that any newly created screen in JIRA is not usable by a JIRA project until it has been associated with either:

See Activating a screen (below) for details.

On this page:

JIRA ships with the Default Screen, Resolve Issue Screen and Workflow Screen, which are used as described:

  • Default Screen — the default issue operations for creating, editing or viewing an issue.
  • Resolve Issue Screen — the transition view for the default Close Issue and Resolve Issue transitions originating from the Open, In Progress and Reopened steps in JIRA's default workflow.
  • Workflow Screen — the transition view for the default Reopen Issue transitions originating from the Resolved and Closed steps and Close Issue transition originating from the Resolved step in JIRA's default workflow.
    (info) The Workflow Screen defines a smaller set of fields than the Resolve Issue Screen.

    JIRA's default workflow, showing transitions (arrows) and steps (blue boxes):

画面の追加

JIRA に新しい画面を追加するには :

  1. 「JIRA 管理者」 グローバル権限 を持つユーザーとしてログインします。
  2. Select Administration > Issues > Screens to open the View Screens page, which lists all screens which have been defined in JIRA.
    (tick) Keyboard shortcut: g + g + type screens
    (Screenshot from JIRA 5.0.1 and later)
  3. If you are using JIRA 5.0.1 and later, click the Add New Screen button to open the Add New Screen dialog box.
    (info) If using JIRA 5.0.0, scroll down to the Add Screen form towards the end of the page.
  4. Complete the Add New Screen dialog box (in JIRA 5.0.1 and later) or Add Screen form (in JIRA 5.0.0):
    • 名前  — 新しい画面をうまく説明する短いフレーズを入力します。
    • Description — enter a sentence or two to describe the situations screen will be used.
  5. Click the Add button to add your new screen to JIRA.
    (info) If you are using JIRA 5.0.2 and later, you will be taken directly to the Configure Screen page, where you can add fields to your new screen. See Adding a field to a screen (from step 4) below in the Configuring a screen's fields section for details.

画面の詳細の編集

画面の名前および/または説明を変更するには：

  1. 「JIRA 管理者」 グローバル権限 を持つユーザーとしてログインします。
  2. Select Administration > Issues > Screens to open the View Screens page (above).
    (tick) Keyboard shortcut: g + g + type screens
  3. Click the Edit link next to the appropriate screen.
  4. You will now be directed to the Edit Screen page where you can edit the name and/or description of the Screen.

画面のコピー

  1. Log in as a user with the JIRA Administrators  global permission.
  2. Select Administration > Issues > Screensto open the View Screens page (above).
    (tick)Keyboard shortcut: g + g + type screens
  3. Click the Copy link next to the Screen you wish to copy. You will be directed to the Copy Screen page, where you can enter a name and a description for the new Screen:

画面の削除

  1. 「JIRA 管理者」 グローバル権限 を持つユーザーとしてログインします。
  2. Select Administration > Issues > Screens to open the View Screens page (above).
    (tick) Keyboard shortcut: g + g + type screens
  3. Click the Delete link next to the screen you wish to delete. You will be prompted to confirm your deletion

(info) Screens that are associated with one or more screen schemes, or one or more workflow transitions, cannot be deleted.

Configuring a screen's fields

Adding a field to a screen

  1. 「JIRA 管理者」 グローバル権限 を持つユーザーとしてログインします。
  2. Select Administration > Issues > Screens to open the View Screens page, which lists all screens which have been defined in JIRA.
    (tick) Keyboard shortcut: g + g + type screens
    (Screenshot from JIRA 5.0.1 and later) 
  3. Click the Configure link (under the Operations column) next to the screen you want to add a field to, to open the Configure Screen page for that screen.
  4. In the Add Field form towards the end of the Configure Screen page, select the field/s that you wish to add to the screen from the Fields to add list.
    (info) If you wish, specify the number representing the position to which a field should be added relative to the other fields.
    (tick) Use the numbers indicated in the table's Position column as a guide.
  5. at which the field will be placed, by entering the position number in the Position option.
    (info) 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.
  6. 追加ボタンをクリックします。

Removing a field from a screen

  1. 「JIRA 管理者」 グローバル権限 を持つユーザーとしてログインします。
  2. Select Administration > Issues > Screens to open the View Screens page (above).
    (tick) Keyboard shortcut: g + g + type screens
  3. Click the Configure link next to the screen of interest to open the Configure Screen page (above).
  4. In the table's Remove column, select the check boxes next to the fields you wish to remove.
  5. Click the Remove button located at the bottom of the table.
  6. The fields will be removed from the screen and will become available in the Add Field form at the bottom of the screen (for subsequent re-addition if required).

(info) The Summary field is always required for a JIRA issue. Hence, if your screen is being used for a 'create issue' operation, you will need to ensure that the Summary field is on this screen. Otherwise, your users will be unable to create issues.

Reordering fields on a screen

To change the vertical display order of fields on a screen:

  1. 「JIRA 管理者」 グローバル権限 を持つユーザーとしてログインします。
  2. Select Administration > Issues > Screens to open the View Screens page (above).
    (tick) Keyboard shortcut: g + g + type screens
  3. Click the Configure link next to the screen of interest to open the Configure Screen page (above).
  4. In the table's Move to Position column, specify the number representing the position to which a field should be moved relative to the other fields.
    (tick) Use the numbers indicated in the table's Position column as a guide.
  5. Click the Move button located at the bottom of the table.
    (info) Please Note:
    • You can repeat this step for multiple fields by specifying a different position for each field you wish to move.
    • Alternatively, you can click on the arrows next to the desired field (in the Order column) to move a field up or down one position (using the inner arrows), or to the first or last position (using the outer arrows).

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 special 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 (see 'Adding a Field to a Screen above):

  1. Select one or both of the following fields from the Fields to add  list, 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
  2. 追加ボタンをクリックします。

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 you specifically remove them. However, the fields will not be visible to the user until Time Tracking is reactivated.

Configuring tabs

Splitting a Screen into multiple tabs can help to group related fields. This functionality is very useful for organising complex Screens, as you can place less used fields onto separate tabs.

For example, the following screenshots show an example of configuring a simple Screen that only shows the issue Summary and Description on the first tab ('Main'), and Affects Version/s and Component/s on the second tab ('Other Details'). You might want to put the Environment field and the Attachments field on their own tabs too. The final result could look like this when the screen is displayed to a user:

Screenshot: displaying a multi-tab screen to a user - the 'Main' tab

Screenshot: displaying a multi-tab screen to a user - the 'Other Details' tab

Screenshot: displaying a multi-tab screen to a user - the 'Attachments' tab

Adding a tab

  1. 「JIRA 管理者」 グローバル権限 を持つユーザーとしてログインします。
  2. Select Administration > Issues > Screens.
    (tick) Keyboard shortcut: g + g + type sc
  3. The 'View Screens' page will be displayed (see above). Click the Configure link next to the Screen of interest.
  4. In the Add New Tab form, located at the bottom of the 'Configure Screen' page (above), enter the name of the new tab in the Name field and click the Add button.

Moving fields between tabs

If your screen contains multiple tabs, you can move fields from one tab to another.

  1. 「JIRA 管理者」 グローバル権限 を持つユーザーとしてログインします。
  2. Select Administration > Issues > Screens.
    (tick) Keyboard shortcut: g + g + type sc
  3. The 'View Screens' page will be displayed (see above). Click the Configure link next to the Screen of interest.
  4. In the table of fields on the 'Configure Screen' page (above):
    1. 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.
    2. Click the Move button located at the bottom of the table in the Move to Tab column.

注意:

  • 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 (except '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.

Deleting a tab

  1. 「JIRA 管理者」 グローバル権限 を持つユーザーとしてログインします。
  2. Select Administration > Issues > Screens.
    (tick) Keyboard shortcut: g + g + type sc
  3. The 'View Screens' page will be displayed (above). Click the Configure link next to the Screen of interest.
  4. The 'Configure Screen' page will be displayed (above). Navigate to the tab you wish to remove.
  5. Click the Delete <tab name> link. You will be prompted to confirm your deletion.

Renaming a tab

  1. 「JIRA 管理者」 グローバル権限 を持つユーザーとしてログインします。
  2. Select Administration > Issues > Screens.
    (tick) Keyboard shortcut: g + g + type sc
  3. The 'View Screens' page will be displayed (above). Click the Configure link next to the Screen of interest.
  4. The 'Configure Screen' page will be displayed (above). Navigate to the Tab you wish to remove.
  5. The Rename text field is located in the top left of the Configure Screen Tab form.
  6. Enter the new name of the Tab and click Enter.

Reordering tabs

To configure the horizontal order of Tabs:

  1. 「JIRA 管理者」 グローバル権限 を持つユーザーとしてログインします。
  2. Select Administration > Issues > Screens.
    (tick) Keyboard shortcut: g + g + type sc
  3. The 'View Screens' page will be displayed (above). Click the Configure link next to the Screen of interest.
  4. The 'Configure Screen' page will be displayed (above). Navigate to the Tab you wish to move.
  5. Click the arrows (next to the name of the tab) to move that Tab left or right (in the direction of the arrow).

画面のアクティブ化

To make a Screen available to users, you can either:



See our Getting Help page for details.



Raise an issue for our developers.



See answers from the community.



Tweet, blog and update our documentation.

Except where otherwise noted, content in this space is licensed under a Creative Commons Attribution 2.5 Australia License.