Skip to main content

Tracking your work with issues

Use GitHub Issues to track ideas and work on GitHub

About issues

Use GitHub Issues to track ideas, feedback, tasks, or bugs for work on GitHub.

Quickstart for GitHub Issues

Follow this brief interactive guide to learn about GitHub Issues.

Creating an issue

Issues can be created in a variety of ways, so you can choose the most convenient method for your workflow.

About slash commands

Slash commands can save you time by reducing the typing required to create complex Markdown.

Linking a pull request to an issue

You can link a pull request or branch to an issue to show that a fix is in progress and to automatically close the issue when the pull request or branch is merged.

Creating a branch to work on an issue

You can create a branch to work on an issue directly from the issue page and get started right away.

Assigning issues and pull requests to other GitHub users

Assignees clarify who is working on specific issues and pull requests.

Viewing all of your issues and pull requests

The Issues and Pull Request dashboards list the open issues and pull requests you've created. You can use them to update items that have gone stale, close them, or keep track of where you've been mentioned across all repositories—including those you're not subscribed to.

Filtering and searching issues and pull requests

To find detailed information about a repository on GitHub, you can filter, sort, and search issues and pull requests that are relevant to the repository.

Marking issues or pull requests as a duplicate

Mark an issue or pull request as a duplicate to track similar issues or pull requests together and remove unnecessary burden for both maintainers and collaborators.

Pinning an issue to your repository

You can pin up to three important issues above the issues list in your repository.

Transferring an issue to another repository

To move an issue to a better fitting repository, you can transfer open issues to other repositories.

Closing an issue

You can close an issue when bugs are fixed, feedback is acted on, or to show that work is not planned.

Deleting an issue

People with admin permissions in a repository can permanently delete an issue from a repository.

Planning and tracking work for your team or project

The essentials for using GitHub's planning and tracking tools to manage work on a team or project.