2020-05-26 23:08:26 -04:00
---
stage: Plan
group: Project Management
2020-11-26 01:09:20 -05:00
info: To determine the technical writer assigned to the Stage/Group associated with this page, see https://about.gitlab.com/handbook/engineering/ux/technical-writing/#assignments
2020-05-26 23:08:26 -04:00
---
2019-04-08 16:09:41 -04:00
# Issue Data and Actions
2017-05-08 04:35:38 -04:00
Please read through the [GitLab Issue Documentation ](index.md ) for an overview on GitLab Issues.
2019-04-08 16:09:41 -04:00
## Parts of an Issue
2017-05-08 04:35:38 -04:00
2020-12-11 10:10:04 -05:00
The image below illustrates what an issue may look like. Certain parts
look slightly different or are absent, depending on the GitLab version
and the user's permissions.
2017-05-08 04:35:38 -04:00
2020-12-11 10:10:04 -05:00
You can find all of an issue's information on one page.
2017-05-08 04:35:38 -04:00
2020-04-21 11:21:10 -04:00
![Issue view ](img/issues_main_view_numbered.png )
2020-12-11 10:10:04 -05:00
The numbers in the image correspond to the following features:
2020-11-16 19:09:16 -05:00
- **1.** [Issue actions ](#issue-actions )
2020-04-21 11:21:10 -04:00
- **2.** [To Do ](#to-do )
- **3.** [Assignee ](#assignee )
2020-09-07 11:09:04 -04:00
- **3.1.** [Multiple Assignees **(STARTER)** ](#multiple-assignees )
- **4.** [Epic **(PREMIUM)** ](#epic )
2020-04-21 11:21:10 -04:00
- **5.** [Milestone ](#milestone )
- **6.** [Time tracking ](#time-tracking )
- **7.** [Due date ](#due-date )
- **8.** [Labels ](#labels )
2020-09-07 11:09:04 -04:00
- **9.** [Weight **(STARTER)** ](#weight )
2020-04-21 11:21:10 -04:00
- **10.** [Confidentiality ](#confidentiality )
- **11.** [Lock issue ](#lock-issue )
- **12.** [Participants ](#participants )
- **13.** [Notifications ](#notifications )
- **14.** [Reference ](#reference )
2021-01-12 19:10:50 -05:00
- [Issue email ](#email )
2020-04-21 11:21:10 -04:00
- **15.** [Edit ](#edit )
- **16.** [Description ](#description )
- **17.** [Mentions ](#mentions )
2020-09-18 20:09:50 -04:00
- **18.** [Related Issues ](#related-issues )
2020-04-21 11:21:10 -04:00
- **19.** [Related Merge Requests ](#related-merge-requests )
- **20.** [Award emoji ](#award-emoji )
- **21.** [Show all activity ](#show-all-activity )
- **22.** [Create Merge Request ](#create-merge-request )
- **23.** [Issue history ](#issue-history )
- [Activity sort order ](#activity-sort-order )
- **24.** [Comments ](#comments )
- **25.** [Submit comment, start a thread, or comment and close ](#submit-comment-start-a-thread-or-comment-and-close )
- **26.** [Zoom meetings ](#zoom-meetings )
2017-05-08 04:35:38 -04:00
2019-06-11 13:59:19 -04:00
Many of the elements of the issue screen refresh automatically, such as the title and
description, when they are changed by another user. Comments and system notes also
update automatically in response to various actions and content updates.
2017-05-19 10:43:59 -04:00
2020-11-16 19:09:16 -05:00
### Issue actions
2017-05-08 04:35:38 -04:00
2020-11-16 19:09:16 -05:00
In an open issue, you can close it by selecting the **Close issue** button.
The issue is marked as closed but is not deleted.
2019-06-11 13:59:19 -04:00
2020-11-16 19:09:16 -05:00
To reopen a closed issue, select the **Reopen issue** button.
A reopened issue is no different from any other open issue.
2019-06-11 13:59:19 -04:00
2020-11-16 19:09:16 -05:00
To access additional actions, select the vertical ellipsis
(**{ellipsis_v}**) button:
2019-06-11 13:59:19 -04:00
2020-11-16 19:09:16 -05:00
- To create a new issue in the same project, select **New issue** in the dropdown menu.
- If you are not the issue author, you can [submit an abuse report ](../../abuse_reports.md ).
Select **Report abuse** in the dropdown menu.
2017-05-08 04:35:38 -04:00
2020-04-21 11:21:10 -04:00
### To Do
2017-05-08 04:35:38 -04:00
2019-10-28 02:06:30 -04:00
You can add issues to and remove issues from your [GitLab To-Do List ](../../todos.md ).
2019-07-04 11:45:54 -04:00
2020-04-21 11:21:10 -04:00
The button to do this has a different label depending on whether the issue is already on your To-Do
List or not. If the issue is:
2019-07-04 11:45:54 -04:00
- Already on your To-Do List: The button is labeled **Mark as done** . Click the button to remove the issue from your To-Do List.
2020-10-08 05:08:40 -04:00
- Not on your To-Do List: The button is labeled **Add a to do** . Click the button to add the issue to your To-Do List.
2017-05-08 04:35:38 -04:00
2020-04-21 11:21:10 -04:00
### Assignee
2017-05-08 04:35:38 -04:00
2019-08-14 20:30:56 -04:00
An issue can be assigned to:
- Yourself.
- Another person.
2020-09-07 11:09:04 -04:00
- [Many people ](#multiple-assignees ). ** (STARTER)**
2019-08-14 20:30:56 -04:00
2020-12-11 10:10:04 -05:00
The assignees can be changed as often as needed. The idea is that the assignees are
2019-06-11 13:59:19 -04:00
responsible for that issue until it's reassigned to someone else to take it from there.
2020-12-11 10:10:04 -05:00
When assigned to someone, it appears in their assigned issues list.
2017-05-08 04:35:38 -04:00
2020-12-07 22:09:37 -05:00
NOTE:
2019-06-11 13:59:19 -04:00
If a user is not member of that project, it can only be
2017-05-08 04:35:38 -04:00
assigned to them if they created the issue themselves.
2020-04-21 11:21:10 -04:00
#### Multiple Assignees **(STARTER)**
2017-05-20 07:10:49 -04:00
2020-12-11 10:10:04 -05:00
Often, multiple people work on the same issue together. This can be difficult
2019-06-11 13:59:19 -04:00
to track in large teams where there is shared ownership of an issue.
2017-05-20 07:10:49 -04:00
2019-02-04 19:21:20 -05:00
In [GitLab Starter ](https://about.gitlab.com/pricing/ ), you can
2019-06-11 13:59:19 -04:00
[assign multiple people ](multiple_assignees_for_issues.md ) to an issue.
2020-05-14 20:08:06 -04:00
### Epic **(PREMIUM)**
2019-06-11 13:59:19 -04:00
You can assign issues to an [Epic ](../../group/epics/index.md ), which allows better
management of groups of related issues.
2017-05-20 07:10:49 -04:00
2020-04-21 11:21:10 -04:00
### Milestone
2017-05-20 07:10:49 -04:00
2019-06-11 13:59:19 -04:00
Select a [milestone ](../milestones/index.md ) to attribute that issue to.
2017-05-08 04:35:38 -04:00
2020-04-21 11:21:10 -04:00
### Time tracking
2017-05-08 04:35:38 -04:00
2020-12-11 10:10:04 -05:00
Use [GitLab Quick Actions ](../quick_actions.md ) to [track estimates and time
spent on issues](../time_tracking.md). You can add a [time estimate ](../time_tracking.md#estimates )
for resolving the issue, and also add [the time spent ](../time_tracking.md#time-spent )
to resolve the issue.
2017-05-08 04:35:38 -04:00
2020-04-21 11:21:10 -04:00
### Due date
2017-05-08 04:35:38 -04:00
2019-06-11 13:59:19 -04:00
When you work on a tight schedule, it's important to have a way to set a deadline for
implementations and for solving problems. This can be done in the [due date ](due_dates.md )
element. Due dates can be changed as many times as needed.
2017-05-08 04:35:38 -04:00
2020-04-21 11:21:10 -04:00
### Labels
2017-05-08 04:35:38 -04:00
2019-06-11 13:59:19 -04:00
Categorize issues by giving them [labels ](../labels.md ). They help to organize workflows,
and they enable you to work with the [GitLab Issue Board ](index.md#issue-boards ).
2017-05-08 04:35:38 -04:00
2020-12-11 10:10:04 -05:00
Group Labels, which allow you to use the same labels for all projects in the same
group, can also be given to issues. They work exactly the same, but are immediately
2019-06-11 13:59:19 -04:00
available to all projects in the group.
2017-05-08 04:35:38 -04:00
2020-12-11 10:10:04 -05:00
If a label doesn't exist yet, you can create one by clicking **Edit**
followed by **Create new label** in the dropdown menu.
2017-05-08 04:35:38 -04:00
2020-04-21 11:21:10 -04:00
### Weight **(STARTER)**
2017-05-08 04:35:38 -04:00
2019-10-27 02:06:30 -04:00
[Assign a weight ](issue_weight.md ) to an issue.
2019-06-11 13:59:19 -04:00
Larger values are used to indicate more effort is required to complete the issue. Only
positive values or zero are allowed.
2017-05-08 04:35:38 -04:00
2020-04-21 11:21:10 -04:00
### Confidentiality
2017-05-08 04:35:38 -04:00
2020-12-11 10:10:04 -05:00
You can [set an issue to be confidential ](confidential_issues.md ). Unauthorized users
cannot access the issue, and it is not listed in the project's issue boards nor list for them.
2017-05-08 04:35:38 -04:00
2020-04-21 11:21:10 -04:00
### Lock issue
2017-05-08 04:35:38 -04:00
2019-07-15 02:10:32 -04:00
You can [lock the threads ](../../discussions/index.md#lock-discussions ) in the issue,
2019-06-11 13:59:19 -04:00
to prevent further comments from being added.
2017-05-08 04:35:38 -04:00
2020-04-21 11:21:10 -04:00
### Participants
2017-05-08 04:35:38 -04:00
2019-07-15 02:10:32 -04:00
All the users involved in that issue. Either they participated in the [thread ](../../discussions/index.md ),
or were mentioned in the description or threads.
2017-05-08 04:35:38 -04:00
2020-04-21 11:21:10 -04:00
### Notifications
2017-05-08 04:35:38 -04:00
2019-10-27 02:06:30 -04:00
Click on the icon to enable/disable [notifications ](../../profile/notifications.md#issue--epics--merge-request-events )
2020-12-11 10:10:04 -05:00
for the issue. Notifications are automatically enabled after you participate in the issue in any way.
2019-06-11 13:59:19 -04:00
- **Enable**: If you are not a participant in the discussion on that issue, but
want to receive notifications on each update, subscribe to it.
- **Disable**: If you are receiving notifications for updates to that issue but no
2019-02-22 08:17:10 -05:00
longer want to receive them, unsubscribe from it.
2017-05-08 04:35:38 -04:00
2020-04-21 11:21:10 -04:00
### Reference
2019-06-11 13:59:19 -04:00
2019-10-09 08:06:13 -04:00
- A quick "copy" button for that issue's reference, which looks like
`foo/bar#xxx` , where `foo` is the `username` or `groupname` , `bar` is the
`project-name` , and `xxx` is the issue number.
2019-06-11 13:59:19 -04:00
2021-01-12 19:10:50 -05:00
### Email
> [Introduced](https://gitlab.com/gitlab-org/gitlab/-/issues/18816) in GitLab 13.8.
Guest users can see a button to copy the email address for the issue. Sending an email to this address creates a comment containing the email body.
2020-04-21 11:21:10 -04:00
### Edit
2019-06-11 13:59:19 -04:00
2020-12-11 10:10:04 -05:00
Clicking this icon opens the issue for editing. All the fields which
were shown when the issue was created are displayed for editing.
This icon is only displayed if the user has permission to edit the issue.
2019-06-11 13:59:19 -04:00
2020-04-21 11:21:10 -04:00
### Description
2019-06-11 13:59:19 -04:00
The plain text title and description of the issue fill the top center of the issue page.
The description fully supports [GitLab Flavored Markdown ](../../markdown.md#gitlab-flavored-markdown-gfm ),
allowing many formatting options.
2020-12-16 19:09:53 -05:00
> [In GitLab 12.6](https://gitlab.com/gitlab-org/gitlab/-/issues/10103) and later, changes to an issue's description are listed in the [issue history](#issue-history). **(STARTER)**
2019-11-18 22:06:07 -05:00
2020-04-21 11:21:10 -04:00
### Mentions
2019-06-11 13:59:19 -04:00
You can mention a user or a group present in your GitLab instance with `@username` or
2020-12-11 10:10:04 -05:00
`@groupname` . All mentioned users are notified via to-do items and emails,
unless they have disabled all notifications in their profile settings.
This is controlled in the [notification settings ](../../profile/notifications.md ).
2019-06-11 13:59:19 -04:00
2020-12-11 10:10:04 -05:00
Mentions for yourself (the current logged in user) are highlighted
in a different color, which allows you to quickly see which comments involve you.
2019-06-11 13:59:19 -04:00
Avoid mentioning `@all` in issues and merge requests, as it sends an email notification
2020-12-11 10:10:04 -05:00
to all the members of that project's group. This might be interpreted as spam.
2019-06-11 13:59:19 -04:00
2020-09-18 20:09:50 -04:00
### Related Issues
2019-06-11 13:59:19 -04:00
Issues that were mentioned as [related issues ](related_issues.md ) are listed here.
You can also click the `+` to add more related issues.
2020-04-21 11:21:10 -04:00
### Related Merge Requests
2017-05-08 04:35:38 -04:00
2019-08-29 22:25:44 -04:00
Merge requests that were mentioned in that issue's description or in the issue thread
2019-07-15 02:10:32 -04:00
are listed as [related merge requests ](crosslinking_issues.md#from-merge-requests ) here.
2019-06-11 13:59:19 -04:00
Also, if the current issue was mentioned as related in another merge request, that
2020-12-11 10:10:04 -05:00
merge request is also listed here.
2017-05-08 04:35:38 -04:00
2020-04-21 11:21:10 -04:00
### Award emoji
2017-05-08 04:35:38 -04:00
2020-12-11 10:10:04 -05:00
You can award emojis to issues. You can select the "thumbs up" and "thumbs down",
or the gray "smiley-face" to choose from the list of available
[GitLab Flavored Markdown Emoji ](../../markdown.md#emoji ).
2017-05-08 04:35:38 -04:00
2020-12-07 22:09:37 -05:00
NOTE:
2019-06-11 13:59:19 -04:00
Posting "+1" as a comment in a thread spams all subscribed participants of that issue,
2019-07-15 02:10:32 -04:00
clutters the threads, and is not recommended. Awarding an emoji is a way
2020-12-11 10:10:04 -05:00
to let them know your reaction without notifying them.
2017-05-08 04:35:38 -04:00
2020-04-21 11:21:10 -04:00
### Show all activity
2017-05-08 04:35:38 -04:00
2019-06-11 13:59:19 -04:00
You can filter what is displayed in the issue history by clicking on **Show all activity**
2020-03-05 04:08:31 -05:00
and selecting either:
- **Show comments only**, which only shows threads and hides updates to the issue.
- **Show history only**, which hides threads and only shows updates.
Also:
2017-05-08 04:35:38 -04:00
2019-07-04 11:45:54 -04:00
- You can mention a user or a group present in your GitLab instance with
2020-12-11 10:10:04 -05:00
`@username` or `@groupname` and they are notified via to-do items
and emails, unless they have [disabled all notifications ](#notifications )
2019-07-04 11:45:54 -04:00
in their profile settings.
2020-12-11 10:10:04 -05:00
- Mentions for yourself (the current logged-in user) are highlighted
in a different color, which allows you to quickly see which comments involve you.
2019-07-04 11:45:54 -04:00
2019-06-11 13:59:19 -04:00
![Show all activity ](img/show-all-activity.png )
2017-05-08 04:35:38 -04:00
2020-04-21 11:21:10 -04:00
### Create Merge Request
2017-05-08 04:35:38 -04:00
2020-07-16 14:09:35 -04:00
Create a new branch and [**Draft** merge request ](../merge_requests/work_in_progress_merge_requests.md )
2020-12-11 10:10:04 -05:00
in one action. The branch is named `issuenumber-title` by default, but you can
choose any name, and GitLab verifies that it is not already in use. The merge request
inherits the milestone and labels of the issue, and is set to automatically
2019-06-11 13:59:19 -04:00
close the issue when it is merged.
2017-05-08 04:35:38 -04:00
2019-06-11 13:59:19 -04:00
![Create MR from issue ](img/create_mr_from_issue.png )
2017-05-08 04:35:38 -04:00
2019-06-11 13:59:19 -04:00
Optionally, you can choose to create a [new branch ](../repository/web_editor.md#create-a-new-branch-from-an-issue )
only, named after that issue.
2017-05-08 04:35:38 -04:00
2020-04-21 11:21:10 -04:00
### Issue history
2017-05-08 04:35:38 -04:00
2019-06-11 13:59:19 -04:00
All comments and updates to the issue are tracked and listed here, but this can be
filtered, as shown above.
2017-05-08 04:35:38 -04:00
2020-04-21 11:21:10 -04:00
#### Activity sort order
> [Introduced](https://gitlab.com/gitlab-org/gitlab/-/issues/14588) in GitLab 12.10.
You can reverse the default order and interact with the activity feed sorted by most recent items
at the top. Your preference is saved via local storage and automatically applied to every issue
you view.
To change the activity sort order, click the **Oldest first** dropdown menu and select either oldest
or newest items to be shown first.
![Issue activity sort order dropdown button ](img/issue_activity_sort_order_v12_10.png )
### Comments
2017-05-08 04:35:38 -04:00
2019-06-11 13:59:19 -04:00
Collaborate in the issue by posting comments in its thread. This text field also fully
supports [GitLab Flavored Markdown ](../../markdown.md#gitlab-flavored-markdown-gfm ).
2017-05-08 04:35:38 -04:00
2020-04-21 11:21:10 -04:00
### Submit comment, start a thread, or comment and close
2017-05-08 04:35:38 -04:00
2020-12-11 10:10:04 -05:00
After you write a comment, you can:
2017-05-08 04:35:38 -04:00
2020-12-11 10:10:04 -05:00
- Click **Comment** and to publish your comment.
2019-07-15 02:10:32 -04:00
- Choose **Start thread** from the dropdown list and start a new [thread ](../../discussions/index.md#threaded-discussions )
2020-12-11 10:10:04 -05:00
in that issue's main thread to discuss specific points. This invites other participants
2019-07-15 02:10:32 -04:00
to reply directly to your thread, keeping related comments grouped together.
2017-05-08 04:35:38 -04:00
2019-07-15 02:10:32 -04:00
![Comment or thread ](img/comment-or-discussion.png )
2017-05-12 16:14:37 -04:00
2019-06-11 13:59:19 -04:00
You can also close the issue from here, so you don't need to scroll to the top of the issue page.
2019-09-17 08:06:48 -04:00
2020-04-21 11:21:10 -04:00
### Zoom meetings
2019-09-17 08:06:48 -04:00
2020-05-21 23:08:28 -04:00
> [Introduced](https://gitlab.com/gitlab-org/gitlab/-/issues/31103) in GitLab 12.3.
2019-09-17 08:06:48 -04:00
You can attach and remove Zoom meetings to issues using the `/zoom` and `/remove_zoom` [quick actions ](../quick_actions.md ) as part of
[GitLab Flavored Markdown ](../../markdown.md#gitlab-flavored-markdown-gfm ).
Attaching a [Zoom ](https://zoom.us ) call an issue
results in a **Join Zoom meeting** button at the top of the issue, just under the header.
2019-11-13 16:06:45 -05:00
Read more how to [add or remove a zoom meeting ](associate_zoom_meeting.md ).
2020-05-27 17:08:05 -04:00
### Publish an issue **(ULTIMATE)**
> [Introduced](https://gitlab.com/gitlab-org/gitlab/-/merge_requests/30906) in [GitLab Ultimate](https://about.gitlab.com/pricing/) 13.1.
2020-07-23 20:09:34 -04:00
If a status page application is associated with the project, you can use the `/publish` [quick action ](../quick_actions.md ) to publish the issue. Refer to [GitLab Status Page ](../../../operations/incident_management/status_page.md ) for more information.