YouTrack Server 2023.3 Help

Apply Commands to Issues

The Apply Command dialog lets you apply a collection of updates to an issue in a single operation. Instead of updating the value for a single field or attribute using the mouse, you can provide instructions for multiple changes and apply them all at once.

The Apply Command dialog.
The Apply Command dialog.

Each command consists of a space-delimited keyword-value pair. For example:

  • To assign the selected issue or a set of issues to yourself, enter for me.

  • To assign issues to yourself and change their state to In progress, enter for me state in progress.

As soon as you start typing, YouTrack displays a completion list with matching keywords or values. For link commands that reference other issues, YouTrack supports full-text search. This feature lets you filter the list of issues to match your search criteria without having to specify the exact issue ID. For example, you can enter duplicates toolbar to show only issues that contain the word "toolbar" and select an issue from the list.

Open the Apply Command Dialog

The Apply Command dialog is basically an extension of the interface for viewing issues in YouTrack. It is accessible from any issue view, including the Issues list, single issue view, and the quick view popup windows used on agile boards and Gantt charts.

To open the Apply Command dialog:

  1. Open an issue in quick view or single issue view.

  2. Open the Show more menu in the issue toolbar and select Open command dialog.

  3. Select the Open command dialog option from the Show more menu.

You can also open the Apply Command dialog using a keyboard shortcut. Ths lets you keep your hands on the keyboard when updating an issue.

In YouTrack Lite, you can choose whether to open the command dialog using a predefined keyboard shortcut or by pressing any alphanumeric key. You can set this preference by selecting one of the available options for the Hotkey configuration.

Hotkey configuration options for the Apply Command dialog.

The standard keyboard shortcut to open the dialog is Ctrl + Alt + J. You can also opt to open the dialog when pressing any key. This applies to any alphanumeric key on a standard keyboard. Keys with auxiliary functions, like Backspace, Enter, and Tab are not mapped to this action.

In YouTrack Classic, you can open the command dialog using a predefined keyboard shortcut or by pressing any alphanumeric key.

  • The standard keyboard shortcut to open the dialog is Ctrl + Alt + J.

  • The option to open the dialog by pressing any key is always active unless your cursor is inside a field that accepts keyboard input. The dialog will open when you press any alphanumeric key on a standard keyboard. Keys with auxiliary functions, like Backspace, Enter, and Tab are not mapped to this action.

Apply a Command to an Issue

With commands, you can apply changes to multiple issues quickly and efficiently.

The required permissions vary based on the type of command to be applied.

To apply a command to an issue:

  1. Open an issue in quick view or single issue view.

  2. Select the Open command dialog option from the Show more menu or press Ctrl + Alt + J.

    • The Apply Command dialog opens.

  3. In the Command input field, enter one or more commands.

  4. Enter an optional comment in the Comment text box.

  5. Click the Apply button or press Ctrl + Enter.

    • The command is applied and the comment is added to the issue.

    To discard the commands and the comment, click the Cancel button or press Esc.

To apply a command to one or more issues:

  1. Click the Issues link in the application header.

  2. Select one or more issues in the list. To select multiple issues, use the arrow keys and Space bar or hold Shift and press the Up Arrow or Down Arrow.

  3. Press Ctrl + Alt + J or any alphabetic key.

    You can also click the Open command dialog button in the toolbar.

    • The Apply Command dialog opens.

  4. In the Command input field, enter one or more commands.

  5. Enter an optional comment in the Comment text box.

  6. Click the Apply button or press Ctrl + Enter.

    • The command is applied and the comment is added to the selected issues.

    To discard the commands and the comment, click the Cancel button or press Esc.

For a list of commands that can be applied to issues, see Command Reference.

Apply Commands Without Notification

When you apply commands without notification, the updates are applied to the selected issues without sending update notifications to users who subscribe to these changes.

This feature comes in handy when you apply batch changes to several issues at once and don't want to spam your team with notifications. You might choose to apply commands without notification when, for example, you move issues to the next release version or add issues to the backlog.

This option is only visible when you have permission to apply commands without notification in a project. To perform this action, you need all the permissions that are required to apply commands to an issue, plus the Apply Commands Silently permission.

To apply a command without notification:

  1. Open an issue in quick view or single issue view.

  2. Select the Open command dialog option from the Show more menu or press Ctrl + Alt + J.

    • The Apply Command dialog opens.

  3. Press Ctrl + Alt + J or any alphabetic key.

    • The Apply Command dialog opens.

    Apply command without notification.
  4. In the Command input field, enter a command.

  5. Enter an optional comment in the Comment field.

  6. Click the Apply without notice button or press Ctrl + Shift + Enter (Windows) / Control + Shift + Return (macOS).

    • The command is applied and the comment is added to the selected issues without generating notification messages.

To apply a command without notification:

  1. Select one or more issues in the Issues list or on an agile board or open an issue in single issue view.

  2. Press Ctrl + Alt + J or any alphabetic key.

    • The Apply Command dialog opens.

    Apply command without notification.
  3. In the Command input field, enter a command.

  4. Enter an optional comment in the Comment field.

  5. Click the Apply without notice button or press Ctrl + Shift + Enter (Windows) / Control + Shift + Return (macOS).

    • The command is applied and the comment is added to the selected issues without generating notification messages.

Sample Commands

The following table provides a few examples of common YouTrack commands:

Command

Description

assigned to me priority major

or

for me priority major

Assigns the selected issues to the current user, sets the priority of each issue to Major.

state fixed

Sets the value of the State field for the selected issues to Fixed.

duplicates TS-2405

Adds a Duplicates link in the selected issues to the issue with the ID TS-2405. An Is duplicated by link for each selected issue is also added to the issue with the ID TS-2405.

type Cosmetics tag fix it this week

Associates the selected issue with the "fix it this week" tag and sets the value of the Type field to Cosmetics.

remove tag fix it this week

Removes the "fix it this week" tags from the selected issues.

project TeamCity

Moves the selected issues to the TeamCity project.

subsystem Documentation

Moves the selected issues to the Documentation subsystem.

Last modified: 22 March 2024