GitLab quick actions

Quick actions provide text-based shortcuts for common actions in GitLab. Quick actions:

• Execute common actions without using the user interface.
• Support working with issues, merge requests, epics, and commits.
• Run automatically when you save descriptions or comments.
• Respond to specific contexts and conditions.
• Process multiple commands when entered on separate lines.

For example, you can use quick actions to:

• Assign users.
• Add labels.
• Set due dates.
• Change status.
• Set other attributes.

Each command starts with a forward slash (/) and must be entered on a separate line. Many quick actions accept parameters, which you can enter with quotation marks (") or specific formatting.

Parameters

Many quick actions require a parameter. For example, the /assign quick action requires a username. GitLab uses autocomplete characters with quick actions to help users enter parameters, by providing a list of available values.

If you manually enter a parameter, it must be enclosed in double quotation marks ("), unless it contains only these characters:

• ASCII letters
• Numbers (0-9)
• Underscore (_), hyphen (-), question mark (?), dot (.), ampersand (&) or at (@)

Parameters are case-sensitive. Autocomplete handles this, and the insertion of quotation marks, automatically.

Issues, merge requests, and epics

The following quick actions are applicable to descriptions, discussions, and threads. Some quick actions might not be available to all subscription tiers.

Work items

Work items in GitLab include:

• Tasks
• OKRs
• Epics (see Issues, merge requests, and epics)

The following quick actions can be applied through the description field when editing or commenting on work items.

Commit comments

You can use quick actions when commenting on individual commits. These quick actions work only in commit comment threads, not in commit messages or other GitLab contexts.

To use quick actions in commit comments:

1. Go to a commit page by selecting a commit from the commits list, merge request, or other commit links.
2. In the comment form at the bottom of the commit page, enter your quick action.
3. Select Comment.

The following quick actions are applicable for commit comments:

Here is an example Git tag:

Ready for release after security fix.
/tag v2.1.1 Security patch release

This comment creates a Git tag named `v2.1.1` pointing to the commit, with the
message "Security patch release".

## Troubleshooting

### Quick action isn't executed

If you run a quick action, but nothing happens, check if the quick action appears in the autocomplete
box as you type it.
If it doesn't, it's possible that:

- The feature related to the quick action isn't available to you based on your subscription tier or
  user role for the group or project.
- A required condition for the quick action isn't met.
  For example, you're running `/unlabel` on an issue without any labels.