New Issue View

For new issues in YouTrack Lite, the project that the issue is assigned to when reported is shown at the top of the field panel.

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.

• First, 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.

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

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.

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

The Drafts menu in the sidebar lets you perform any of the following actions:

• Click the issue summary to load a draft in the new issue form.

• Click the Delete draft icon to permanently delete an issue draft.

• Click the Delete all drafts icon at the top of the menu to discard all issue drafts.

• Click the New issue icon at the top of the menu to load an empty form. Any input that is currently stored in the form when you perform this action is saved as a new draft and added to the list.

For more information, see Load Issue Drafts.

The New Issue page lets you access a list of unreported 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.

Every issue must include a 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.

Every issue must include a 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.

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.

The rich text editor lets you format the issue description 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.

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.

The rich text editor lets you format the issue description 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.

The new issue view supports a special type of custom field for storing text. These fields store a string of characters that you can format in Visual or Markdown mode.

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

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.

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.

• To learn more about formatting text in YouTrack, see Rich Text Editor.

• For a complete list of formatting options in Markdown, see Markdown Syntax.

If the issue that you want to create is somehow related to other issues that already exist in YouTrack, you can add links to your issue draft.

Click the Link issue link above the panel for attachments, then add links to one or more target issues.

If the issue you want to link to doesn't already exist, use the Create action at the bottom of the list to create it. The text that you enter to search for existing issues is used as the summary for the new issue.

To learn more about linking issues in YouTrack, see Link Issues.

If the issue that you want to create is somehow related to other issues that already exist in YouTrack, you can add links to your issue draft.

Click the Link issues option in the toolbar, then add links to one or more target issues.

The panel for issue links will either appear directly below the issue summary or below the issue description, depending on the option that is stored in the Workspace settings of your YouTrack profile.

To learn more about linking issues in YouTrack, see Link Issues.

The form for reporting new issues has a drop zone for adding files as attachments.

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

• Drag files to the drop zone.

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

To learn more about attachments, see Attach Files.

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

• 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.

To learn more about attachments, see Attach Files.

Below the issue description (and text fields, when present) you'll find an option 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.

The current visibility settings are also shown at the top of the page. These two controls perform the same action and are always in sync.

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.

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

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.

• 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 other information on the form.

• You can add links to similar issues without leaving the page.

For more information, see Find 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.

• 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.

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.

The first issue field that is shown in this panel selects the project that the issue belongs to.

• Every issue belongs to a single project — you never have the option to select an empty value.

• The set of custom fields can vary from project to project. If you move the issue to another project, the set of available fields may change as well.

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.

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.

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 Settings.

At the bottom of the field list is a set of controls for Boards.

Here, you see a list of agile boards where the issue will be added once created. These boards are configured to use a filter to add issues automatically. The current issue matches the filter query on each of these boards.

• Click the Remove icon to exclude the issue from the board when it is reported.

• Click the plus icon to add the issue to a specific board. For agile boards that use sprints, the select sprint link opens a secondary menu that lets you add the issue to a specific sprint.

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

• Click the > icon to view a list of agile boards to which the issue will be added automatically when it is reported. The 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.

There are two action buttons at the bottom of the page for reporting new issues. These actions let you decide what you want to happen next.

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