Skip to content

Creating Issues

Jump to bottom
Ben Eaton edited this page Apr 30, 2024 · 2 revisions

Creating an issue

Issues can be used to keep track of bugs, enhancements, or other requests. For more information, see "About issues."

Creating an issue from a repository

  1. Navigate to the main page of the repository.

  2. Under your repository name, click Issues.

  1. Click New issue.

  2. If the type of issue you'd like to open isn't included in the available options, click Open a blank issue.

  1. In the comment body field, type a description of your issue.

  2. If you're a project maintainer, you can assign the issue to someone, add it to a project (classic), associate it with a milestone, or apply a label.

  3. When you're finished, click Submit new issue.

Creating an issue from a comment

You can open a new issue from a comment in an issue or pull request. When you open an issue from a comment, the issue contains a snippet showing where the comment was originally posted.

  1. Navigate to the comment that you would like to open an issue from.

  2. In that comment, click ...

  1. Click Reference in new issue.

  2. Use the "Repository" dropdown menu, and select the repository you want to open the issue in.

  3. Type a descriptive title and body for the issue.

  4. Click Create issue.

  5. If you're a project maintainer, you can assign the issue to someone, add it to a project (classic), associate it with a milestone, or apply a label.

When you're finished, click Submit new issue.

Creating an issue from discussion

People with triage permission to a repository can create an issue from a discussion.

When you create an issue from a discussion, the contents of the discussion post will be automatically included in the issue body, and any labels will be retained. Creating an issue from a discussion does not convert the discussion to an issue or delete the existing discussion. For more information about GitHub Discussions, see "About discussions."

  1. Under your repository or organization name, click Discussions.

  1. In the list of discussions, click the discussion you want to view.

  2. In the right sidebar, click Create issue from discussion.

  1. In the "Title" field, type a title for your issue.

  2. In the comment body field, type a description of your issue.

  3. If you're a project maintainer, you can assign the issue to someone, add it to a project (classic), associate it with a milestone, or apply a label.

  4. When you're finished, click Submit new issue.

Creating an issue from a project

You can quickly create issues without leaving your project. When using a view that is grouped by a field, creating an issue in that group will automatically set the new issue's field to the group's value. For example, if you group your view by "Status", when you create an issue in the "Todo" group, the new issue's "Status" will automatically be set to "Todo." For more information about Projects, see "About Projects."

  1. Navigate to your project.

  2. At the bottom of a table, group of items, or a column in board layout, click +

  1. Click Create new issue.

  2. At the top of the "Create new issue" dialogue, select the repository where you want the new issue to be created.

  1. Below the repository dropdown, type a title for the new issue.

  2. Optionally, use the fields below the title field to set assignees, labels, and milestones, and add the new issue to other projects.

  3. Optionally, type a description for your issue.

  4. Optionally, if you want to create more issues, select Create more and the dialogue will reopen when you create your issue.

  5. Click Create.

Clone this wiki locally