# GitHub Issues

> GitHub's list of bugs, ideas and tasks, kept beside the code.

**Field:** Software Development  
**Category:** Version Control  
**Also known as:** GitHub Issue, Issue (GitHub), Issue Tracker (GitHub)

## Think of it like

Think of it like a to-do board pinned beside the code. Anyone on the team can add a card or tick one off.

## Definition

GitHub Issues is the place in a GitHub repository to track bugs, ideas and tasks. Each issue gets a number, a title and a thread for talk. You can label it, assign it to a person and add it to a project board. A pull request can close an issue when it merges. You write Closes followed by the issue number in the pull request.

## Example

Emma opens issue #42: the order page shows the wrong price. Jack's pull request says Closes #42, and the issue closes when it merges.

## Why it matters

Work and code sit side by side, so you can see why each change was made.

## Common mistake

Opening issues with no steps to repeat the bug. Others cannot fix what they cannot see.

## Three principles

- **One issue, one problem.** Keep each issue to one thing.
- **Linked to code.** Pull requests can close issues.
- **Labels and owners.** Sort issues and assign them.

## Related terms

- [GitHub](https://learn.benibix.com/term/development/github)
- [Pull Request](https://learn.benibix.com/term/development/pull-request)
- [Bug](https://learn.benibix.com/term/development/bug)
- [Issue Log](https://learn.benibix.com/term/business/issue-log)
- [Bug Report](https://learn.benibix.com/term/development/bug-report)

## Taught in

- [GitHub, GitLab and Bitbucket](https://learn.benibix.com/learn/development-version-control/github-gitlab-and-bitbucket): Git and GitHub, 10/13

![A pull request flows from a feature branch toward a protected main branch drawn with a lock. On the way it must pass two gates: one review approved, and all tests passed. Beside the flow, an issue numbered 42 is linked, with the words Closes #42, and it closes when the merge lands. Below, three hosts that run this flow are named: GitHub, GitLab and Bitbucket.](https://learn.benibix.com/diagrams/dev3-git-hosting.svg)

---

Source: https://learn.benibix.com/term/development/github-issues
Author: Behnia Zarei (a developer in Vienna, Austria, who builds and teaches data, AI and business intelligence at BENIBIX)
Publisher: BENIBIX Learn (https://learn.benibix.com/)
Last updated: 2026-11-17
Licence: CC BY 4.0 (https://creativecommons.org/licenses/by/4.0/). Quote freely with attribution.
