If your project team uses YouTrack, the first thing you'll probably do is create an issue or two. If you've read the quick start guide, you already know how easy it is. On this page, you'll find a little more information about how to create an issue, add an attachment, and update existing issues.
note
YouTrack Lite & YouTrack Classic
YouTrack supports two interfaces for working with issues in YouTrack: YouTrack Lite and YouTrack Classic.
To make sure you see information that is relevant to your experience, select the tab that corresponds with the interface you currently use.
Create an Issue
Whenever you need to report a problem or define a task for yourself or another member of your project team, create an issue for it.
Press Alt + Insert (Control + N for macOS), or click the New Issue button in the header.
There's also an icon for adding a new issue next to the Drafts menu in the issue sidebar.
The New Issue page opens.
In YouTrack Lite, the form for reporting a new issue opens as a dialog. To open the form in its own page, click the View in full page link at the bottom of the form.
YouTrack normally sets the value for the project field to the project where you reported your last issue.
To report the issue in another project, select another value for the Project field.
Enter an issue summary and description in the corresponding input fields. When you enter the description, you can format your text in Visual or Markdown mode.
To learn more about formatting text in YouTrack, see Rich Text Editor.
For a complete list of formatting options in Markdown, see Markdown Syntax.
Assign values to the custom fields. Default custom fields include the issue type, priority, and subsystem.
Click the attachment panel to select one or more files from your local directory.
Drag files from your computer and drop them in the attachment panel.
Press Ctrl + V to paste an image from your clipboard.
Do one of the following:
To report the new issue, press Ctrl + Enter or click the Create button.
Open the menu next to the Create button, where you can either choose to create the issue and load another empty draft or load another copy of the current issue.
To close the New Issue page without reporting the issue, press Esc or click the Cancel button. The current issue is saved as a draft. The next time you create an issue, you can reload the draft from the Drafts menu in the sidebar.
note
Creating Linked Issues
If you're reporting an issue and want to create one or more issues that are somehow connected to the issue you're currently working with. you can create and link multiple issues without leaving the current draft.
To create an issue that is automatically linked to the current issue, use the Link issue option at the bottom of the form.
Choose which link type you want to use to bind the current issue with its target.
Use the search box to find existing issues.
To create an issue and link it to the current draft, enter the summary for the new issue and press Enter or click the Create link at the bottom of the search results.
To learn more about linking issues in YouTrack, see Link Issues.
Press Alt + Insert (Control + N for macOS), or click the New Issue button in the header.
The New Issue page opens:
YouTrack normally sets the value for the project field to the project where you reported your last issue. If you are currently using a project as a search context, this project is used instead.
To report the issue in another project, select another value from the project list in the header. Projects that you have marked as your favorites are shown at the top of the list.
Enter an issue summary and description in the corresponding input fields. When you enter the description, you can format your text in Visual or Markdown mode.
To learn more about formatting text in YouTrack, see Rich Text Editor.
For a complete list of formatting options in Markdown, see Markdown Syntax.
Assign values to the custom fields. Default custom fields include the issue type, priority, and subsystem. The following options are available:
Select values for each field in the field panel.
Open the Apply Command dialog and set the values for multiple custom fields in a single command. To open the Apply Command dialog, press Ctrl + Alt + J.
Click the attachment panel to select one or more files from your local directory.
Drag files from your computer and drop them in the attachment panel or in the issue description.
Press Ctrl + V to paste an image from your clipboard.
For additional options, click the Show more button in the issue toolbar. For details, see Attach a File or Screenshot below.
Do one of the following:
To report the new issue, press Ctrl + Enter or click the Create button.
To close the New Issue page without reporting the issue, press Esc or click the Close button. The current issue is saved as a draft. The next time you create an issue, you can reload the draft from the Drafts list in the issue toolbar.
note
Creating Linked Issues
If you're currently viewing an issue and want to create another issue that is somehow connected to the issue you're currently working with. you can create and link an issue in a single operation.
To create an issue that is automatically linked to the current issue, use the drop-down menu next to the New Issue button in the header. Just choose which link type you want to use to associate the new issue with the original.
When you use the option, a link to the original issue is automatically added to the New Issue page. Continue reporting the issue as described in the previous section and click the Create button when done.
To learn more about linking issues in YouTrack, see Link Issues.
Attach a File or Screenshot
Sometimes, words are not enough. To describe an issue in more detail, you can attach resources such as log files and screenshots to the issue.
Select one or more files from your local directory and attach them to the issue.
Attach files privately
Select one or more files from your local directory and set the visibility of the attachments. Use this option when the attachments contain information that should be restricted to specific users or groups.
For more information about attaching files or screenshots to an issue, see Attach Files.
Edit an Existing Issue
Nobody's perfect. If you want to rewrite the issue summary or description, you can change these at any time. All changes are recorded and displayed in the issue history. There are a few properties that you cannot update, like the issue ID, reporter, and creation date. These properties are saved by YouTrack and cannot be overwritten.
YouTrack Lite
YouTrack Classic
To edit an existing issue:
tip
Requires permissions: Read Issue, Update Issue
If you're currently viewing the list of issues, you can either open the issue in quick view or single issue view.
Click the Edit issue button in the toolbar.
If the issue is open in quick view, you can press F2 on your keyboard.
The issue opens in editing mode.
Update the project, summary, or description. You can also set new values for the custom fields.
When finished, click the Save button.
To edit an existing issue:
tip
Requires permissions: Read Issue, Update Issue
Select an issue in the list and press F2 or click the Edit issue button in the toolbar.
The issue opens in editing mode.
Update the project, summary, or description. You can also set new values for the custom fields.
When finished, click the Save button.
You can also apply changes to multiple issues with commands. For more information, see Commands.
Our website uses some cookies and records your IP address for the purposes of accessibility, security, and managing your access to the telecommunication network. You can disable data collection and cookies by changing your browser settings, but it may affect how this website functions. Learn more.
With your consent, JetBrains may also use cookies and your IP address to collect individual statistics and provide you with personalized offers and ads subject to the Privacy Notice and the Terms of Use. JetBrains may use third-party services for this purpose. You can adjust or withdraw your consent at any time by visiting the Opt-Out page.