Docs / Tasks

The issue panel

Open any issue beside its list and edit everything there.

Click a row in any list, a card on a board, or an issue in the command palette, and the issue opens in a large window over the list. The list stays behind it, so you can close the window with Esc, the × or a click outside it, and carry on where you were. On a phone it fills the screen.

What you can changeLink to this section

Everything in the panel that can be edited is edited in place, and saves as you go.

While the panel is open, changes other people make show up by themselves: new and edited comments, the title, the description, fields, tags, files and links. Anything you're in the middle of typing stays as it is.

• The title. Click it, type, then press Enter to save or Esc to undo. Long titles wrap, so you can read them in full on a phone.
• Every field the project has: status, assignee, priority, type, area, due date and the rest. A change shows at once; if YouTrack refuses it, the old value comes back with a line saying what didn't save. Agents with their own YouTrack account are marked with a bot in the people lists; picking one asks for an optional note and hands the issue over (see Assigning an issue to an agent).
• Tags. Use the + beside them to switch tags on and off, or type a new name and press Enter to make one. Each click shows its check mark at once, so you can tick several tags quickly; they save one after another. If YouTrack refuses one, its mark goes back and the panel says it couldn't save.
• The description. Save and Cancel appear once you've changed it. See Writing a description.

Writing a descriptionLink to this section

Descriptions are Markdown. The switch at the top right of the box picks how you see it:

• Preview, the default, shows the description formatted: headings, lists, bold, links, code, tables, checklists and images. You can edit it right there. Markdown you type turns into what it means as you go, so # starts a heading, - a list and **word** makes the word bold. Markdown you paste as plain text, say from an agent or a terminal, comes out formatted too.
• Raw shows the plain Markdown, as YouTrack stores it.

Both edit the same text, and you can switch at any point before saving. The New epic and New task dialogs have the same box, and so do comments.

What else is in the panelLink to this section

The left column holds the work itself, from top to bottom:

• Subtasks, with a box to add one.
• Links to other issues.
• Time: what's been logged, and a timer. See Time tracking and the timer.
• The description, then Files.

The right column, Activity, holds the talk about it:

• Comments, newest first and shown formatted, with the box to write one pinned at the bottom. After you post, the list scrolls back to the top so you see your comment. See Comments and mentions.
• History, folded until you open it.

Each column scrolls on its own, so a long description doesn't push the comments away. Drag the line between the columns to make Activity wider or narrower; a reload puts it back to its usual width. A wide table in a comment scrolls sideways inside the comment. On narrower screens Activity moves below the details, and the comment box sticks to the bottom of the screen while the comments are in view.

If the issue is a subtask, the line above the title says which issue it's in. Click that to open the parent in the same panel.

The buttons at the topLink to this section

• The eye watches the issue, so you hear about its changes. See Watching an issue.
• Copy link copies a link that always opens this issue.
• Open in YouTrack opens the same issue in YouTrack, in a new tab.
• Delete asks first. Its subtasks aren't deleted; they move to Unsorted.

Links to an issueLink to this section

While the panel is open, the address bar ends in ?issue= and the issue's ID, so you can share the list with the issue open over it.

There's also a link that works from anywhere: /i/ followed by the ID, like /i/CT-12. It opens the issue over its epic's list, or over Unsorted if it isn't under an epic yet. An epic's link opens the epic's own page. Copy link uses this form.

Making it widerLink to this section

The panel has three widths: Normal, up to about 1150 pixels, Wide, which fills the window apart from a thin margin, and Full screen, which covers the whole window. The button beside the close button switches full screen on and off, and switching it off goes back to the width you had. You can also pick a width in Settings under Issue panel. The choice is synced, so it follows you to your other devices. On a phone the panel is always full screen.

Opening fasterLink to this section

Rest the pointer on a row for a moment and Suru Me starts loading that issue before you click, so the panel opens at once. Issues you've opened before also show straight away, then refresh.