YouTrack Standalone 2021.3 Help

New Issue View

The page that you use to report an issue is stripped down to include only what you need to create an issue in YouTrack. To access this page, click the New Issue button in the application header. Here's an overview of the functionality that is supported in this issue view.

Project Selector

The page title contains a drop-down list for selecting the project in which the issue is reported.

New create issue project selector

Many of the attributes that are assigned to issues in YouTrack are defined at the project level. If you only have access to one project, the value for this field is set automatically. Otherwise, the project in which you have most recently created an issue is selected for you.

The following factors affect the order of the projects that are shown in the list.

  • If you set a project as your search context, this project is used as the default value for new issues. For more information, see Search Context for Projects.

  • Next, you see the projects that you have marked as favorites in the Projects list.

  • After your favorite projects, all other projects are listed in alphabetical order.

Every issue belongs to one project — you never have the option to select an empty value. As you change this value, the set of available custom fields can change as well.

Issue Toolbar

The toolbar provides access to the same actions that are supported in the view for single issues.

New create issue toolbar

The following actions are available:

Open command dialogOpens the Apply Command dialog. Here, you have access to update the issue draft using the keyboard-centric command syntax.
Add linkAdds a link from the issue draft to another issue. Select the link type from the drop-down list to open the Apply Command dialog and enter the ID of the target issue.
Add tagAdds a tag to the issue draft. Select an existing tag from the list. Enter a value in the input field to filter the list of tags.
Assign issueSets the value for the Assignee field in the issue draft. Select a user from the list. Enter a value in the input field to filter the list of users.
Show more

Opens a list of additional actions. This menu also provides access to custom commands that are supported by workflows.

For details, see Show More Menu.

Clear draftClears the issue summary and description. Resets all custom fields to their default values.

Show More Menu

The following actions are available from the Show more menu:

New issue show more menu
Custom actionsThe first items in the Show more menu are custom actions that are supported by workflows. The set of actions that are available in each issue is determined by the workflows that are attached to the current project. For more information, see Action Rules.
Attach filesOpens a dialog that lets you locate and attach a file from your local directory.
Attach files privately

Opens the Attach Files Privately dialog. Here, you have the option to restrict the visibility for all files to specific groups and/or users.

Use this option for files that contain sensitive information.

Repeat last commandOpen the Apply Command dialog with the most recent command in the input field.

Draft Management

The New Issue page lets you access a list of unreported issue drafts.

New create issue drafts

From the Drafts drop-down list, you can perform any of the following actions:

  • View which drafts have tags and attachments.

  • Click the Create link to immediately create an issue from the draft.

  • Click the Remove draft option to delete the draft and remove it from the list.

  • Click the Delete all button to remove all unreported drafts and start from scratch.

For more information, see Load Issue Drafts.

Issue Summary

Every issue must include a summary.

New issue summary

As you type, YouTrack starts searching for other issues with similar text in the summary. These issues are shown below in the Similar issues section of the page. For more information, see Similar Issues.

Issue Description

Below the summary is an input field for the issue description. If the issue summary is descriptive enough, you can skip it — the description is not mandatory. However, when the issue is more complex, it often helps to solve an issue faster when you describe it in more detail.

As you type, the list of similar issues is updated to show other issues with matching text in the issue description. The Preview section of the page shows you how the content will be formatted in the issue when you create it.

New issue description

The rich text editor lets you format the issue description text in Visual or Markdown mode.

Formatted Text Fields

YouTrack supports custom fields that store values as text with formatting. These fields store a string of characters that is presented as formatted text when shown in the issue.

Fields with this type are not shown in the sidebar with other custom fields. Instead, they appear just below the issue description.

Text field preview

The ability to add and edit content in these fields is supported by a rich text editor. The editor lets you format text in Visual or Markdown mode. When editing in Markdown mode, a preview of the formatted input is shown below the field.


The New Issue page has a drop zone for adding files as attachments to the new issue.

New issue attach files
  • Click the drop zone to select and attache files from your local directory.

  • Drag files to the drop zone.

  • Use the paste command for your operating system to attach an image from the clipboard.

Once you have attached one or more files, the attachments are shown as thumbnails in the Attachments section of the page.

New issue attachment panel

To learn more about attachments, see Attach Files.

Issue Visibility

Below the Attachments section is a menu that lets you set the visibility for the new issue.

  • The issue is usually marked as visible to issue readers. This means that any member of this group who has the Read Issue permission in the selected project can view this issue.

  • If the owner of the project has defined a specific group to be used as the default visibility setting for new issues in the current project, this group will be selected automatically. To learn more about default visibility options, see Configure a Project.

To restrict the visibility of a new issue to specific users and groups, select these users and groups from the list.

New issue visibility

To learn more about issue visibility, see Set Issue, Comment, and Attachment Visibility.

Similar Issues

The New Issue page contains a section that shows issues that might be similar to the issue you are currently reporting. Maybe another user encountered the same problem and has already created an issue to fix it. In this case, you might add your comment to an existing issue and avoid creating a duplicate.

As you enter the issue summary, YouTrack searches for other issues with similar text.

Create issue similar issues
  • The list of similar issues is restricted show a maximum of five issues in a scrollable list. This ensures that the list doesn't hide the section of the page that displays the issue preview.

  • You can add the Star tag and votes to similar issues without leaving the page.

For more information, see Find Similar Issues.

Custom Fields

The side panel contains a list of custom fields that are attached to the current project. Many fields are configured to use a default value. Fields can also be configured to require input for new issues.

To set or change the values for custom fields, click the field and choose one or more values from the list or enter a value.

New issue custom fields

An option in your user profile lets you decide whether this panel is shown on the left or right side of the page. For more information, see YouTrack General Profile Settings.


Below the panel for custom fields is a set of controls for Watchers.

  • Click the Watch issue link to add yourself to the list of watchers. This also adds the Star tag to the issue for your account.

  • If you have the Add Watchers permission in the project, you can click the > icon to add users to the list of watchers.

New issue watchers

For more information, see Watch Issues.


Below the Watchers list is a set of controls for Boards.

New issue boards
  • Click the > icon to view a list of agile boards to which the issue will be added automatically when it is reported. These boards in this list are configured to use a filter to add issues automatically. The current issue matches the filter query on each of these boards.

  • Click the Add to board link to add the issue to a specific board. This action opens the Apply Command dialog with the add Board command in the input field. To complete the operation, add the name of the target board and apply the command.

Actions for New Issues

There are four action buttons on the New Issue page. These actions determine what happens to the information on the page.

New issue actions
Clear draftClears the issue summary and description. Resets all custom fields to their default values.
CreateReports the current issue in the selected project.

Closes the current issue without reporting it to the project. The issue is saved to your list of drafts.

The same action is performed when you close the browser tab or window without clicking the Create button.

DeleteCloses the current issue without reporting it to the project or saving it to your list of drafts.

Issue Templates

Another option on the New Issue page lets you generate an issue template without reporting the issue. Use this option when you want to create several issues with the same basic set of attributes or standardize issue reporting for a group of users.

New issue template

To learn more about issue templates, see Generate an Issue Template URL.

Last modified: 08 July 2021