YouTrack Standalone 2017.1 Help

Commands

The Apply Command dialog lets you modify the attributes of an issue or a set of issues with a command. For example, you can:

  • Assign issues to a user.
  • Change the issue type or priority.
  • Add tags to issues.
  • Set dependencies between issues.

The issues list and full page view use an older version of the Apply Command dialog.

/help/img/youtrack/2017.1/commandDialogOld.png

A newer version of this dialog appears on the agile board.

/help/img/youtrack/2017.1/commandWindow_thumbnail.png

Both dialogs support the same functionality with a different set of controls.

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 features lets you filter the list of issue 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.

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. Select one or more issues in the list. To select multiple issues, use the arrow keys and spacebar or hold Shift and press the Up Arrow or Down Arrow.
  2. Press Ctrl + Alt + J or any alphabetic key.
    • 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 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 Silently

When you apply commands silently, users are not notified of changes that were made by the 'silent' command.
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 silently 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 silently in a project. To perform this action, you need all of the permissions that are required to apply commands to an issue, plus the Update Project permission.

The procedure for applying commands varies based on where you apply the command in YouTrack. The issues list and full page view use an older version of the Apply Command dialog. A newer version of this dialog appears on the agile board.

To apply a command silently from the issues list or full page view:

  1. Select one or more issues in the list or open an issue in full page view.
  2. Press Ctrl + Alt + J or any alphabetic key.
    • The Apply Command dialog opens.
    /help/img/youtrack/2017.1/commandsSilentApplyOld.png
  3. In the Command input field, enter a command.
  4. Enter an optional comment in the Comment text box.
  5. Click the Silent Apply button or press Ctrl + Shift + Enter (Windows) / Control + Shift + Return (Mac).
    • The command is applied and the comment is added to the selected issues silently.

To apply a command silently on an agile board:

  1. Select one or more issues on the board.
  2. Press Ctrl + Alt + J or any alphabetic key.
    • The Apply Command dialog opens.
    /help/img/youtrack/2017.1/commandsSilentApply_thumbnail.png
  3. In the Command input field, enter a command.
  4. Enter an optional comment in the Comment text box.
  5. Deselect the Notify subscribers option.
  6. Click the Apply command button or press Ctrl + Enter (Windows) / Control + Return (Mac).
    • The command is applied and the comment is added to the selected issues silently.

Sample Commands

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

CommandDescription
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 weekAssociates 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 weekRemoves the "fix it this week" tags from the selected issues.
project TeamCityMoves the selected issues to the TeamCity project.
subsystem DocumentationMoves the selected issues to the Documentation subsystem.

See Also

Last modified: 18 April 2017