Using Keyboard Shortcuts

Keyboard shortcuts provide a quick and easy way of navigating though JIRA Agile, and for performing fundamental actions on issues without having to take your fingers off the keyboard.

(info) You may not have permission to perform all the keyboard shortcut actions described on this page. This depends on how your JIRA administrator(s) have configured permissions for your user account.

Keyboard Shortcuts

Global Shortcuts

These shortcuts are available from any JIRA Agile or JIRA screen.

On this page:

Related pages:

Operation

Keyboard Shortcut

Description

Go to Dashboard

g then d

Browse to a Project

g then p

Directs you to the JIRA Browse Project screen for your current project.

Go to Agile

g then a
or
g then h

Directs you to your most recently visited JIRA Agile board.

Go to Issue Navigator g then i Opens the JIRA Issue Navigator, where you can search for issues using JIRA's Simple Search or Advanced Search (JQL) features.
Administration Search Dialog Box

(Only available if you have the 'JIRA administrators' global permission)
g then g

Opens the Administration Search dialog box.

  • Press the 'Cursor Down' key to show a list of all Administration options, then:
    1. use the cursor keys to select an Administration option, and
    2. press 'Enter' to choose your selected option.
  • Type one to a few letters of the Administration option's name to restrict the list down to options whose names match the series of letters you entered, then:
    1. if there is more than one option in the restricted list, use the cursor keys to select one, and
    2. press 'Enter' to choose your selected option.

Quick Search

/

Directs your cursor to JIRA's Quick Search text box in the top right-hand corner.

Create an Issue

c

Opens the dialog box for creating an issue in JIRA Agile.
(info) The type of issue last created in JIRA Agile is the default issue type selected in this dialog box.

Open shortcut help

?

Opens the keyboard shortcuts dialog box (described below). To close this dialog box, press the 'Esc' key or click Close in the lower-right of the box.

Dashboards drop-down menu

Modifier key(s) + d

Opens the Dashboards drop-down menu in JIRA's top navigation bar. You can then use the arrow keys to navigate to an item, then press 'Enter' to select it.

Projects drop-down menu

Modifier key(s)p

Opens the Projects drop-down menu in JIRA's top navigation bar. You can then use the arrow keys to navigate to an item, then press 'Enter' to select it.

Issues drop-down menu

Modifier key(s) + i

Opens the Issues drop-down menu in JIRA's top navigation bar. You can then use the arrow keys to navigate to an item, then press 'Enter' to select it.

Agile drop-down menu Modifier key(s) + g Opens the Agile drop-down menu in JIRA's top navigation bar. You can then use the arrow keys to navigate to an item, then press 'Enter' to select it.
Form Submit Modifier key(s) + s Submits any currently open form or dialog box.
Cancel Form Modifier key(s)` (backquote) Cancels any currently open form or dialog box.

Agile Shortcuts

These shortcuts are available on JIRA Agile screens only.

Operation

Keyboard Shortcut

Description

Next Issue

j

Go to the next issue (down) in a column.

Previous Issue

k

Go to the previous issue (up) in a column.

Next Column

n

Go to the next (right) column on a board in the Active sprints/Kanban board.

Previous Column

p

Go to the previous (left) column on a board in the Active sprints/Kanban board.

Expand/Collapse All Swimlanes - Toggle between expanding or collapsing all swimlanes on a board in the Active sprints/Kanban board.

Hide/Show Detail View

t

Toggle between hiding or showing the Detail View of the currently selected issue (see Viewing an Issue).

View Issue o Open the issue which is currently showing in the Detail View for viewing (or subsequent editing) in JIRA.

Add a New Line

Enter

Add a new line in a field being edited in the Detail View (applies to 'Description' and other multi-line text fields).

Submit changes Enter Submit the content of a field being edited in the Detail View (except for multi-line text fields).
Cancel changes Esc Cancel the changes to content of a field being edited in the Detail View. The 'Esc' key can also be used to Close or Cancel dialog boxes.
Assign to Me i Assign the issue in the Detail View to you.
Send to Top s + t Move your selected issue(s) to the top of the current column. (Only applicable if Ranking has been enabled.)
Send to Bottom s + b Move your selected issue(s) to the bottom of the current column. (Only applicable if Ranking has been enabled.)
Edit Issue e Opens the currently selected issue for editing in JIRA.
Projector Mode z

Reduces clutter and increases contrast. For use on projectors or similar.

  • The first press of z collapses the header.
  • The second press of z adds high-contrast, which is best for projectors.
  • The third press of z returns the page to the normal mode.

You can also perform any JIRA issue operation on the currently selected issue of a board, using the Operations Dialog Box (see below).

Issue Actions and Navigator Shortcuts

These shortcuts are available from JIRA's View Issue and Issue Navigator screens only.

Operation

Keyboard Shortcut

Description

Availability

View selected Issue

o or Enter

Opens the currently selected issue on the Issue Navigator.

Issue Navigator

Next Issue

j

Navigates to the next issue. This keyboard shortcut only applies to a View Issue screen if you got there via the Issue Navigator.

View Issue and Issue Navigator

Previous Issue

k

Navigates to the previous issue. This keyboard shortcut only applies to a View Issue screen if you got there via the Issue Navigator.

View Issue and Issue Navigator

Back to the Navigator

u

Returns to the Issue Navigator from the View Issue screen. This keyboard shortcut only applies to a View Issue screen if you got there via the Issue Navigator.

View Issue

Hide/Show Left Section

[ (left square bracket)

Hides or shows the left section on the Issue Navigator.

Issue Navigator

Next Activity

n

Navigates to the next item in the activity section of the View Issue screen.

View Issue

Previous Activity

p

Navigates to the previous item in the activity section of the View Issue screen.

View Issue

Focus search field

f

Focuses the cursor in the Advanced Search text field or the Simple Search's Query text field.

Issue Navigator

Escape field

Esc

Escapes the cursor out of the current text field so that you can use more keyboard shortcuts. Pressing the 'Esc' key can also be used to Close or Cancel JIRA's dialog boxes.
(info) If the auto-complete dropdown list is visible on the Advanced Search text field, you must press the 'Esc' key twice to escape the cursor out of this text field.

View Issue and Issue Navigator

Edit Issue

e

Opens the Edit Issue dialog box (if you have appropriate permission), where you can edit the issue.

View Issue and Issue Navigator

Assign Issue

a

Opens the Assign dialog box (if you have appropriate permission), where you can assign the issue to another JIRA user.

View Issue and Issue Navigator

Comment on Issue

m

On the View Issue screen, this opens the comment panel at the top of the page and focuses on the comment text box.
On the Issue Navigator, this opens the Add Comment dialog box for adding a comment to the currently selected issue.

View Issue and Issue Navigator

Edit Issue Labels

l (lower-case 'L')

Opens the Labels dialog box, where you can edit the labels associated with the issue.

View Issue and Issue Navigator

Share Issue s Opens the Share bubble, which allows you to send a link to an issue or search result (with an optional note) to the email address of any JIRA user, or any arbitrary email address. See Sharing an Issue or Sharing a Search Result for details. View Issue and Issue Navigator

Operations dialog box

. (full-stop/period)

Opens the Operations dialog box, from which you can perform any permitted issue operation on the current JIRA issue by doing either of the following:

  • Press the 'Cursor Down' key, then:
    1. use the cursor keys to select an issue operation, and
    2. press 'Enter' to choose your selected operation.
  • Type one to a few letters of the issue operation's name to restrict the list down to operations whose names match the series of letters you entered, then:
    1. if there is more than one operation in the restricted list, use the cursor keys to select one, and
    2. press 'Enter' to choose your selected operation.
Screenshot: The 'Operations' dialog box


The list of issue operations available in the drop-down menu are split into the following categories:

  • Workflow Transitions — Choose the appropriate workflow transition to change the issue's status. The workflow transitions available depend on the current issue's status and on how your JIRA administrator has customized your JIRA workflow. The default JIRA workflow transitions include:
    • Start Progress — Set the issue's Status to In Progress.
    • Resolve issue — Set the issue's Status to Resolved and select the appropriate Resolution.
    • Close issue — Set the issue's Status to Closed and if the issue has not already been Resolved, select the appropriate Resolution.
    • Reopen issue — Set a Resolved or Closed issue's Status to Reopened.
  • Actions — Choose the appropriate action to perform on the issue.

    • Edit — Edit the issue's details (Summary, Description, etc).
    • Assign — Select an asignee for the issue.
    • Assign To Me — Assign the issue to yourself.
    • Comment — Add a comment to the issue.
    • Log Work — Record the work done and time spent on the issue. This option is only available if Time Tracking has been activated on your JIRA site.
    • Attach Files — Select a file, upload it and attach it to the issue.
    • Attach Screenshot — Select a file, upload it and attach it to the issue.
    • Voters — Opens the Voters list of the issue, where you can manage your vote and see others who have voted on the issue too.
    • Add Vote — Adds your vote to the issue. (This option is only available if you did not create the issue.)
    • Watch Issue — Become a watcher of the issue.
    • Stop Watching — Stop watching the issue. (This option is only available on issues you are currently watching.)
    • Watchers — Opens the Watchers List, where you can manage watchers of the issue.
    • Create Sub-Task — Create a new issue which is a sub-task of the issue.
    • Convert to Issue — If the issue is a sub-task, convert it to a standalone issue.
    • Convert to Sub-Task — If the issue is a standalone issue, convert it to a sub-task.
    • MoveMove the issue to a different project.
    • Link — Create a link between the issue and another issue. This option is only available if Issue Linking has been enabled on your JIRA site.
    • Clone — Create a new issue which is an identical copy of the issue.
    • Labels — Edit the issue's labels.
    • Delete — Permanently remove the issue.

    Note that some options in the Actions menu will only be available if you have the necessary permissions, or if certain features have been enabled by your JIRA administrator.

View Issue and Issue Navigator


Modifier Keys

If a keyboard shortcut requires modifier keys, one or two of these modifier keys (for example, 'Shift', 'Alt' or 'Ctrl') must be pressed simultaneously, along with a single 'action' key. In the shortcuts dialog box, these keystrokes are indicated as 'modifier (+ modifier) + x', where 'x' is an action key, with the exception of a 'Shift + x' key combination.

Modifier keys differ depending on your combination of operating system and web browser. For example, when running Firefox on Mac OS X, you will need to press 'Ctrl' + 'S' to submit a form, while on Windows, you will need to press 'Alt' + 'S'. The following table identifies the modifier keys for the various combinations of supported web browsers and operating systems:

Web Browser

Mac OS X

Windows

UNIX/Linux

Firefox

Ctrl

Alt + Shift

Alt + Shift

Internet Explorer

Alt

Safari

Ctrl + Alt

Ctrl

(info) Please note:

  • Modifier key shortcuts differ from two-key shortcuts. For the latter, one discrete keystroke follows another (without the keys being pressed simultaneously). In the shortcuts dialog box, two-key shortcuts are indicated as 'x then y', where 'x' is the first keystroke and 'y' is the second.
  • In Internet Explorer, typing a 'Modifier key shortcut' that leads to a link results in the link being highlighted only. Hence, after typing a modifier key shortcut, you will then need to press the 'Enter' key to complete the action - for example, to open a link's drop-down menu. The actions of modifier key shortcuts that lead to buttons, however, are fully completed.
  • In Firefox, it is possible to customise 'Modifier key shortcuts'. Please read Mozilla's Ui.key.contentAccess documentation for more information.

Accessing the Keyboard Shortcuts Dialog Box

The keyboard shortcuts dialog box shows an overview of JIRA actions that are available as keyboard shortcuts and the combination of keystrokes required to perform them.

To open the keyboard shortcuts dialog box, either:

  • press '?' ('Shift + /') on your keyboard, or
  • click your username's dropdown (or the '?' dropdown if you are using JIRA Agile with JIRA Cloud) and select 'Keyboard Shortcuts' from the list.

(warning) When you press '?', the keyboard shortcuts dialog box will not appear if your cursor is already focused inside any JIRA Agile text entry field. Press 'Esc' first to escape from a field.

The keyboard shortcuts dialog box will show which modifier key (or keys) are required for your combination of web browser and operating system. The Modifier Keys section (above) provides more details on other platform combinations.

Screenshot: Keyboard Shortcuts Dialog Box 


(warning) Please Note: The following JIRA-specific keyboard shortcuts, shown in the Navigating Issues section of this dialog box, have no functionality in JIRA Agile or limited use when viewing a JIRA Agile issue in JIRA:

Operation Name

Keyboard Shortcut

Description

Back to the Navigator

u

No functionality in JIRA Agile. When viewing a JIRA Agile issue in JIRA, this keyboard shortcut takes you to JIRA's Issue Navigator, showing either no query or the last query that you conducted in JIRA.

Hide/Show Left Section

[ (left square bracket)

No functionality in JIRA Agile.

Focus Search Field

f

No functionality in JIRA Agile.

Disabling and Re-enabling Keyboard Shortcuts

Keyboard shortcuts are enabled by default. However, you can disable them on a per-user basis via the Keyboard Shortcuts dialog box.

To disable or re-enable keyboard shortcuts:

  1. Ensure you are logged in to JIRA Agile and open the Keyboard Shortcuts dialog box (see above).
  2. At the bottom of the Keyboard Shortcuts dialog box, click Disable Keyboard Shortcuts or Enable Keyboard Shortcuts to respectively disable or re-enable keyboard shortcuts for the currently logged-in user.
    (info) Alternatively, you can disable or re-enable keyboard shortcuts by editing the Preferences section of the Summary Tab of your User Profile in JIRA.

Was this helpful?

Thanks for your feedback!

Why was this unhelpful?

Have a question about this article?

See questions about this article

Powered by Confluence and Scroll Viewport