2017-05-31 01:50:53 -04:00
# GitLab quick actions
2018-09-22 04:07:20 -04:00
Quick actions are textual shortcuts for common actions on issues, epics, merge requests,
2018-10-02 13:33:43 -04:00
and commits that are usually done by clicking buttons or dropdowns in GitLab's UI.
You can enter these commands while creating a new issue or merge request, or
2018-09-22 04:07:20 -04:00
in comments of issues, epics, merge requests, and commits. Each command should be
2018-10-02 13:33:43 -04:00
on a separate line in order to be properly detected and executed. Once executed,
the commands are removed from the text body and not visible to anyone else.
## Quick actions for issues and merge requests
The following quick actions are applicable to both issues and merge requests threads,
discussions, and descriptions:
| Command | Action | Issue | Merge request |
|:---------------------------|:------------------------------ |:------|:--------------|
| `/tableflip <Comment>` | Append the comment with `(╯°□°)╯︵ ┻━┻` | ✓ | ✓ |
| `/shrug <Comment>` | Append the comment with `¯\_ (ツ)_ /¯` | ✓ | ✓ |
| `/todo` | Add a todo | ✓ | ✓ |
| `/done` | Mark todo as done | ✓ | ✓ |
| `/subscribe` | Subscribe | ✓ | ✓ |
| `/unsubscribe` | Unsubscribe | ✓ | ✓ |
| `/close` | Close | ✓ | ✓ |
| `/reopen` | Reopen | ✓ | ✓ |
| `/title <New title>` | Change title | ✓ | ✓ |
| `/award :emoji:` | Toggle emoji award | ✓ | ✓ |
2018-10-19 17:01:39 -04:00
| `/assign me` | Assign yourself | ✓ | ✓ |
2018-10-02 13:33:43 -04:00
| `/assign @user` | Assign one user | ✓ | ✓ |
| `/assign @user1 @user2` | Assign multiple users ** [STARTER]** | ✓ | |
| `/unassign` | Remove assignee(s) | ✓ | ✓ |
| `/reassign @user1 @user2` | Change assignee | ✓ | ✓ |
| `/milestone %milestone` | Set milestone | ✓ | ✓ |
| `/remove_milestone` | Remove milestone | ✓ | ✓ |
| `/label ~label1 ~label2` | Add label(s) | ✓ | ✓ |
| `/unlabel ~label1 ~label2` | Remove all or specific label(s)| ✓ | ✓ |
| `/relabel ~label1 ~label2` | Replace label | ✓ | ✓ |
| < code > /copy_metadata #issue | !merge_request</ code > | Copy labels and milestone from other issue or merge request | ✓ | ✓ |
| < code > /estimate < 1w 3d 2h 14m> < / code > | Set time estimate | ✓ | ✓ |
| `/remove_estimate` | Remove time estimate | ✓ | ✓ |
| < code > /spend < time(1h 30m | -1h 5m)> < date(YYYY-MM-DD)> < / code > | Add or subtract spent time; optionally, specify the date that time was spent on | ✓ | ✓ |
| `/remove_time_spent` | Remove time spent | ✓ | ✓ |
2018-10-03 14:01:31 -04:00
| `/lock` | Lock the discussion | ✓ | ✓ |
| `/unlock` | Unlock the discussion | ✓ | ✓ |
| < code > /due < in 2 days | this Friday | December 31st> < / code > | Set due date | ✓ | |
2018-10-02 13:33:43 -04:00
| `/remove_due_date` | Remove due date | ✓ | |
| `/weight 0,1,2, ...` | Set weight ** [STARTER]** | ✓ | |
| `/clear_weight` | Clears weight ** [STARTER]** | ✓ | |
| `/epic <group&epic | Epic URL>` | Add to epic ** [ULTIMATE]** | ✓ | |
| `/remove_epic` | Removes from epic ** [ULTIMATE]** | ✓ | |
| `/confidential` | Make confidential | ✓ | |
| `/duplicate #issue` | Mark this issue as a duplicate of another issue | ✓ |
| `/move path/to/project` | Move this issue to another project | ✓ | |
| `/target_branch <Local branch Name>` | Set target branch | | ✓ |
| `/wip` | Toggle the Work In Progress status | | ✓ |
| `/merge` | Merge (when pipeline succeeds) | | ✓ |
2018-10-19 03:16:58 -04:00
| `/create_merge_request <branch name>` | Create a new merge request starting from the current issue | ✓ | |
2018-10-02 13:33:43 -04:00
## Quick actions for commit messages
The following quick actions are applicable for commit messages:
| Command | Action |
|:------------------------|:------------------------------------------|
| `/tag v1.2.3 <message>` | Tags this commit with an optional message |
## Quick actions for Epics **[ULTIMATE]**
The following quick actions are applicable for epics threads and description:
| Command | Action |
|:---------------------------|:----------------------------------------|
| `/tableflip <Comment>` | Append the comment with `(╯°□°)╯︵ ┻━┻` |
| `/shrug <Comment>` | Append the comment with `¯\_ (ツ)_ /¯` |
2018-09-22 04:07:20 -04:00
| `/todo` | Add a todo |
2018-10-02 13:33:43 -04:00
| `/done` | Mark todo as done |
| `/subscribe` | Subscribe |
| `/unsubscribe` | Unsubscribe |
| `/close` | Close |
| `/reopen` | Reopen |
| `/title <New title>` | Change title |
| `/award :emoji:` | Toggle emoji award |
| `/label ~label1 ~label2` | Add label(s) |
| `/unlabel ~label1 ~label2` | Remove all or specific label(s) |
2018-09-22 04:07:20 -04:00
| `/relabel ~label1 ~label2` | Replace label |