Creating an issue

Issues can be used to keep track of bugs, enhancements, or other requests.

People with read permissions can create an issue in a repository where issues are enabled.

You can open a new issue based on code from an existing pull request. For more information, see "Opening an issue from code."

You can open a new issue directly from a comment in an issue or a pull request review. For more information, see "Opening an issue from a comment."

Tip: You can also create an issue using the GitHub CLI. For more information, see "gh issue create" in the GitHub CLI documentation.

If you're using a project board to track and prioritize your work, you can convert project board notes to issues. For more information, see "About project boards" and "Adding notes to a project board."

Tips: Project maintainers can choose to:

  • Create an issue template for a repository. Templates include prompts for information in the body of an issue. For more information, see "About issue and pull request templates."
  • Disable issues for a repository. For more information, see "Disabling issues." Pull requests can't be turned off and are always available.
  1. On GitHub Enterprise Server, navigate to the main page of the repository.

  2. Under your repository name, click Issues.

    Issues tab

  3. Click New issue. New Issues button

  4. If there are multiple issue types, click Get started next to the type of issue you'd like to open. Select the type of issue you want to create

  5. Optionally, click Open a blank issue. if the type of issue you'd like to open isn't included in the available options. Link to open a blank issue

  6. Type a title and description for your issue. A sample issue

  7. If you're a project maintainer, you can assign the issue to someone, add it to a project board, associate it with a milestone, or apply a label.

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

Further reading

Did this doc help you? Privacy policy

Help us make these docs great!

All GitHub docs are open source. See something that's wrong or unclear? Submit a pull request.

Make a contribution

Or, learn how to contribute.