About GitHub Issues

Issues let you track your work on GitHub, where development happens.

Quickly create issues

Issues can be created in a variety of ways, so you can choose the most convenient method for your workflow. For example, you can create an issue from a repository, an item in a task list, a note in a project, a comment in an issue or pull request, a specific line of code, or a URL query. You can also create an issue from your platform of choice: through the web UI, GitHub Desktop, GitHub CLI, GraphQL and REST APIs, or GitHub Mobile. For more information, see "Creating an issue."

Track work

You can organize and prioritize issues with projects. To track issues as part of a larger issue, you can use task lists. To categorize related issues, you can use labels and milestones.

Stay up to date To stay updated on the most recent comments in an issue, you can subscribe to an issue to receive notifications about the latest comments.

Community management

To help contributors open meaningful issues that provide the information that you need, you can use issue forms and issue templates. To maintain a healthy community, you can report comments that violate GitHub's Community Guidelines.

Efficient communication

You can @mention collaborators who have access to your repository in an issue to draw their attention to a comment. To link related issues in the same repository, you can type # followed by part of the issue title and then clicking the issue that you want to link. To communicate responsibility, you can assign issues. If you find yourself frequently typing the same comment, you can use saved replies.

Comparing issues and discussions

Some conversations are more suitable for GitHub Discussions. You can use GitHub Discussions to ask and answer questions, share information, make announcements, and conduct or participate in conversations about a project.