create_new_issue.md 3.42 KB
Newer Older
Marcia Ramos's avatar
Marcia Ramos committed
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38
# Create a new Issue

Please read through the [GitLab Issue Documentation](index.md) for an overview on GitLab Issues.

When you create a new issue, you'll be prompted to fill in
the information illustrated on the image below.

![New issue from the issues list](img/new_issue.png)

Read through the [issues functionalities documentation](issues_functionalities.md#issues-functionalities)
to understand these fields one by one.

## New issue from the Issue Tracker

Navigate to your **Project's Dashboard** > **Issues** > **New Issue** to create a new issue:

![New issue from the issue list view](img/new_issue_from_tracker_list.png)

## New issue from an opened issue

From an **opened issue** in your project, click **New Issue** to create a new
issue in the same project:

![New issue from an open issue](img/new_issue_from_open_issue.png)

## New issue from the project's dashboard

From your **Project's Dashboard**, click the plus sign (**+**) to open a dropdown
menu with a few options. Select **New Issue** to create an issue in that project:

![New issue from a project's dashboard](img/new_issue_from_projects_dashboard.png)

## New issue from the Issue Board

From an Issue Board, create a new issue by clicking on the plus sign (**+**) on the top of a list.
It opens a new issue for that project labeled after its respective list.

![From the issue board](img/new_issue_from_issue_board.png)
39

40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61
## New issue via email

*This feature needs [incoming email](../../../administration/incoming_email.md)
to be configured by a GitLab administrator to be available for CE/EE users, and
it's available on GitLab.com.*

At the bottom of a project's issue page, click
**Email a new issue to this project**, and you will find an email address
which belongs to you. You could add this address to your contact.

This is a private email address, generated just for you.
**Keep it to yourself** as anyone who gets ahold of it can create issues or
merge requests as if they were you. You can add this address to your contact
list for easy access.

Sending an email to this address will create a new issue on your behalf for
this project, where the email subject becomes the issue title, and the email
body becomes the issue description. [Markdown] and [quick actions] are
supported.

![Bottom of a project issues page](img/new_issue_from_email.png)

62 63 64 65 66 67
## New issue via Service Desk

Enable [Service Desk](../service_desk.md) to your project and offer email support.
By doing so, when your customer sends a new email, a new issue can be created in
the appropriate project and followed up from there.

68
_Service Desk is available only for [GitLab Premium](https://about.gitlab.com/products/)
69
and [GitLab.com Silver](https://about.gitlab.com/gitlab-com/) subscribers._
70 71 72 73

## New issue from the group-level Issue Tracker

Head to the Group dashboard and click "Issues" in the sidebar to visit the Issue Tracker
Bryce Johnson's avatar
Bryce Johnson committed
74 75
for all projects in your Group. Select the project you'd like to add an issue for
using the dropdown button at the top-right of the page.
76

Bryce Johnson's avatar
Bryce Johnson committed
77
![Select project to create issue](img/select_project_from_group_level_issue_tracker.png)
78 79

We'll keep track of the project you selected most recently, and use it as the default
Bryce Johnson's avatar
Bryce Johnson committed
80
for your next visit. This should save you a lot of time and clicks, if you mostly
81 82
create issues for the same project.

Bryce Johnson's avatar
Bryce Johnson committed
83
![Create issue from group-level issue tracker](img/create_issue_from_group_level_issue_tracker.png)
84

85 86
[Markdown]: ../../markdown.md
[quick actions]: ../quick_actions.md