The new Jira issue view

On this page:

We're in the process of redesigning one of Jira's key components—the issue view. You can open the issue view from a number of places in Jira: from boards, your backlog, search, and from a project's issues list. You can even open an issue from Bitbucket if the issue key is mentioned in a commit message. It's something you might look at a few hundred times a day (or more), so it's pretty central to helping you get more done.

The new experience is available for everyone using Jira Core boards, and we're incrementally rolling it out for the full-page issue view and Jira Software boards and backlogs. If the new issue view doesn't fit how you work in Jira Software right now, you can turn it off in your profile under Labs.

tip/resting Created with Sketch.

Latest updates

Click Watch at the top right of this page to be notified about the latest goodies we're adding to the new issue view.

Jira Software

  • Open issues in a sidebar on boards: By popular demand, we've introduced the ability to open issues as a sidebar on your scrum and kanban boards (rather than the pop-up dialog). If you're a team lead and need to view lots of issues in quick succession, or you need to see a selected issue and the board at the same time, this one's for you. From a board, choose ••• >  Open issues in sidebar to set your preference for all scrum and kanban boards (you can switch back at any time).

Jira Core and Jira Software

  • Keyboard shortcuts: Speed up your workflow with keyboard shortcuts! We haven't released all of the shortcuts just yet, but the most popular ones—o to open the selected issue, a to assign the issue to someone, i to assign an issue to yourself, or m to quickly add a comment—are ready to go.
  • Issues in this epic: We now show a list of the issues in an epic when you're viewing the epic.
  • Drag and drop attachments: Grab a file and drop it on the new issue view to add it as an attachment.
  • The new issue view in your project issues list: The latest location for the new issue view is the issues list in your project. We're rolling this out over the next few weeks, so you may not see it just yet. When you go to a project and click Issues in the sidebar, you'll get the same consistent view and edit experience as you do for boards, backlogs, and full-page.

What's changed?

We've grouped key actions and information in a logical way, making it easier for you to scan and update issues. The issue view responds to the width of your window and its location. It'll usually appear as a 2-column layout on boards and as a single column in the backlog, but will change if you make your window really skinny or really wide.

  1. Foundations: Issue fundamentals, like the summary, status, issue key, and quick-add actions.
  2. Description: Includes not only the description, but also any attachments, issue links, and subtasks.
  3. Context: Metadata that helps categorize the issue (labels and components, for example) and give it context.
  4. Activity: Comments, issue edits, and transitions appear here.

This structured layout is what we'll be using to make issue views much more consistent across different locations. An issue should look and behave the same way in Bitbucket as it does on a Jira board, so you only need to know one way of working.

You can also say goodbye to view and edit modes—just click a field to edit it inline.

Quick-add for attachments, subtasks, and linked issues

The quick-add buttons are a key part of the consistency of the new issue view—they're always there, right under the issue summary. Use them to add attachments, create subtasks, or link issues.

  1. Quick add buttons: Add attachments, create subtasks, and link issues.

If you don't see the create subtask icon , it's likely because there are required fields when you create a subtask. The new issue view doesn't support that yet, so you'll need to click through to the old issue view in this case.

Simple transitions

No more workflow-step buttons to transition issues—just the status and one place to click to transition an issue. Click the status and choose a transition or status to move the issue to.

Comment from anywhere

The new docked comment bar is always there. Even with hundreds of comments on an issue, it's one click and no scrolling to start your comment.

New Atlassian editor

We're also rolling out a new editor as part of the new issue view, with a cleaner look and markdown support.

See some common markdown formatting options...
  • ## This is H2 style (we support H2–H5)
  • **bold** for bold
  • *italic* for italic
  • ``` for a code block
  • [this is link text]( for this is link text
  • * for bulleted lists (like this one (wink))
  • 1. for numbered lists

The editor in the new issue view uses markdown rather than wiki markup. Right now, if you've added wiki markup in the old editor, we'll render it correctly in the new issue view.

As we continue to roll out the new issue view and new editor, wiki markup support will be phased out and eventually removed in favor of markdown.

Show more

Issues can get pretty busy, and it can be tough to look at everything at once. Click Show more in the details section of the issue to reveal those details that don't always show on the new issue view.

To choose which custom fields appear in the new issue view, head to Project settings > Screens, expand the appropriate screen scheme, select the View issue screen to configure it. Field order isn't configurable in the new issue view just yet, but we're working on it.

Where can I see the new issue view?

Full-page issue view

Just like boards and backlogs, the new full-page issue view lets you edit any field you see with a click, and has the same handy quick-add buttons for adding attachments, subtasks, and issue links.

As we're still building some features for the full-page issue view, we've added a click-through option so you can see the old issue view if you need to. Click See the old view at the top-right of the full-page issue view to access anything that's not yet available in the new view.

See an example...

  1. Quick-add buttons: Add attachments and subtasks, and link issues.
  2. Watch and more actions: Watch the issue, and perform other issue actions like move and clone.
  3. Transition issues: Quickly get from to-do to done, and any status or workflow step in between.
  4. Contextual information: Issue labels, components, time tracking, and more.
  5. Docked comment bar: Always there, so you can quickly add a comment no matter how far you've scrolled.

Jira boards

Jira Software

You can open the new issue view as either a dialog or sidebar on your boards, letting you have laser focus on the issue you're working on or a broader view of the issue and board.

To choose the sidebar option, go to a scrum or kanban board and choose •••  Open issues in sidebar .

See an example...

Open issues in a dialog

  1. Quick-add buttons: Add attachments and subtasks, and link issues.
  2. Watch and more actions: Watch the issue, and perform other issue actions like move and clone.
  3. Transition issues: Quickly get from to-do to done, and any status or workflow step in between.
  4. Show more issue details: Reveal all issue fields, including fields that don't yet have values.

Open issues in a sidebar

tip/resting Created with Sketch.

Click the issue key to open the full-page issue view in a new tab.

We're progressively rolling out the new issue view in Jira Software, as we add and refine more features. It's not available to everyone yet, but stay tuned—it'll be available for you soon if it's not right now. For those of you using it, we'd love to get your feedback on the new view so we can continue improving it. Give it a go and let us know what you think.

If the new issue view is on for you, but doesn't fit how you work in Jira Software just yet, you can turn it off in your profile under Labs.

We're not turning on the new issue view for those of you using marketplace apps just yet. If you use marketplace apps that are critical to your work, and you've inadvertently been switched over to the new issue view, you can turn it off in your profile under Labs.

Jira Core

The new issue view appears as a dialog and keeps you in the context of the board. From there you can see all the important info for the issue, edit it inline, and get back to your board in no time.

Even though the new issue view is available for everyone using Jira Core boards, we're not finished improving it. Keep  sending us your feedback , and we'll keep the improvements coming.

Jira Software backlog

Get the same issue structure and inline editing you see on your boards, this time in a single-column layout. Contextual information like AssigneeSprint, and Story points appear high up in the issue view, keeping them within easy reach for backlog grooming, estimation, and prioritization.

If the new issue view is on for you, but doesn't fit how you work in Jira Software right now, you can turn it off in your profile under Labs.

tip/resting Created with Sketch.

The new issue view lets you choose a two-column layout if you have enough screen real estate. Drag the divider and give your issue details more space.

Project issues list

The project issues list (also called the project issue navigator) lets you find issues in your project using handy pre-configured filters. Head to your project and choose Issues in the sidebar, then choose a filter.


Previously, when you clicked an issue key that was mentioned in a commit message, we'd take you to Jira to view and edit the issue. With the new issue view you can see and edit the issue right in Bitbucket. Click the issue key and the new issue view dialog pops open to let you do the work you need to and get back to working in Bitbucket in a snap.

Last modified on May 23, 2018

Was this helpful?

Provide feedback about this article
Powered by Confluence and Scroll Viewport.