YouTrack Standalone 7.0 Help

Command Reference

The format you use to enter a command is similar to the format used in a search query.

The syntax rules for using colons, curly braces and number signs do not apply to commands. For example:

  • To search for critical issues that are assigned to you and associated with the tag 'YouTrack 6.5', you enter the following search query:
    for: me tag: {YouTrack 6.5} #critical.
  • To assign issues to yourself, associate them with the tag 'YouTrack 6.5' and elevate their priority to critical, you enter the following command:
    for me tag YouTrack 6.5 critical.

Simple Commands

The following commands do not require any additional attributes or values. Simply select one or more issues and apply the command.

CommandDescription
cloneClones the selected issue or issues.
deleteDeletes the selected issue or issues.
voteAdds a vote to the selected issue or issues.
unvoteRemoves a vote from the selected issue or issues.

Link Commands

You can use a command to add link types to one or more issues. To add a link type with a command, select a link type and enter the issue ID of the target issue.

CommandDescription
depends onAdds a Depends on link to a target issue in the selected issue. Also adds an Is required for link to the selected issue in the target issue.
duplicatesAdds a Duplicates link to a target issue in the selected issue. Also adds an Is duplicated by link to the selected issue in the target issue.
is duplicated byAdds an Is duplicated by link to a target issue in the selected issue. Also adds a Duplicates link to the selected issue in the target issue.
is required forAdds an Is required for link to a target issue in the selected issue. Also adds a Depends on link to the selected issue in the target issue.
parent forAdds a Parent for link to a target issue in the selected issue. Also adds a Subtask of link to the selected issue in the target issue.
relates toAdds a Relates to link to a target issue in the selected issue. Also adds a Relates to link to the selected issue in the target issue.
subtask ofAdds a Subtask of link to a target issue in the selected issue. Also adds a Parent for link to the selected issue in the target issue.

Tag Commands

You can use a command to add tags to an issue. You can also remove existing tags from an issue.

CommandValueDescription
tagtag nameAdds the specified tag to the selected issue or issues. If the specified tag does not exist, a new tag is created and added to the selected issue or issues.
untagtag nameRemoves the specified tag from the selected issue or issues.

Star Commands

You can use a command to star or unstar an issue. To star and unstar issues with a command, enter the command and enter the username for whom the action applies.

CommandValueDescription
starusernameAdds a star to the selected issue or issues for the user with the specified username. The user is added as a watcher for the issue.
unstarusernameRemoves a star from the selected issue or issues for the user with the specified username. The user is removed from the list of watchers for the issue.

Custom Field Commands

You can use a command to set the value of any custom field in an issue. To set the value for a field in a command, enter the field name followed by the new value.

Use the following commands to set the value for the Assignee of an issue:

CommandDescription
me
my
Assigns the selected issue or issues to the current user.
usernameAssigns the selected issue or issues to the user with the specified username.
for
assigned to
Assigns the selected issue or issues to the user with the specified username. You can also assign issues to the current user with the command for me or assigned to me.
unassignedClears the current value in the Assignee field.

You can use the following commands to set the value for other custom fields. You can either enter these commands in the format field value or enter the value directly. The actual fields and values vary based on the custom fields that are used in your project. The commands shown here are for default custom fields and values.

CommandValuesDescription
statesubmitted
open
in progress
reopened
resolved
unresolved
fixed
won't fix
can't reproduce
duplicate (see note below)
incomplete
obsolete
to be discussed
Sets the value for the State field.
type bug
task
feature
cosmetics
exception
meta issue
usability problem
performance problem
Sets the value for the Type field.
priority minor
normal
major
critical
show-stopper
Sets the value for the Priority field.
projectadministrator-definedMoves the selected issue or issues to the specified project.
subsystem
in
administrator-definedSets the value for the Subsystem field
<custom field>administrator-definedSets the value for the specified custom field.
affects
that affect
affecting
administrator-definedSets the value for the Affected versions field.
fix foradministrator-definedSets the value for the Fix versions field.
fixed in buildadministrator-definedSets the value for the Fixed in build field.

When you set the state to Duplicate, you must also specify the ID of the issue that is duplicated by the current issue.

Agile Board Commands

You can use the following command to assign an issue to a sprint on an agile board:

CommandValueDescription
Board <board name><sprint name>Assigns the issue to the sprint with the specified name on the specified agile board.

To remove an issue from a sprint, enter the command

remove Board <board name> <sprint name>
.

Last modified: 2 November 2016