> ## Documentation Index
> Fetch the complete documentation index at: https://backstage.spotify.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# GitHub Issues

> Display and filter GitHub issues with labels, assignees, and status on Portal entity pages for centralized issue tracking.

Track and manage GitHub issues

# Metadata

* Maintainer: [@backstage-community](https://github.com/backstage/community-plugins)
* NPM: [@backstage-community/plugin-github-issues](https://www.npmjs.com/package/@backstage-community/plugin-github-issues)
* Repository: [https://github.com/backstage/community-plugins/tree/main/workspaces/github-issues](https://github.com/backstage/community-plugins/tree/main/workspaces/github-issues)

# Packages

```
- @backstage-community/plugin-github-issues
```

## Overview

The GitHub Issues plugin integrates issue tracking into Portal, allowing teams to view and manage GitHub issues directly from the portal. This plugin provides developers with quick access to issue lists, details, and status information without leaving their development environment, improving productivity and reducing context-switching.

## Key Features

* **Issue list display** — shows open and closed issues associated with a repository directly on entity pages.
* **Issue details and metadata** — displays issue titles, descriptions, labels, assignees, milestones, and status information.
* **Filtering capabilities** — allows filtering issues by state (open/closed), labels, assignees, and other criteria.
* **Real-time synchronization** — keeps issue information up-to-date with GitHub's latest data.
* **Entity mapping** — links Backstage components to GitHub repositories via annotations (`github.com/project-slug`).
* **Quick navigation** — provides direct links to GitHub for detailed issue management and editing.
* **Label visualization** — displays issue labels with proper color coding for easy identification.
* **Issue counts and statistics** — shows summary statistics for quick health assessment of a repository.
* **IDP benefit** — centralizes issue tracking visibility, reduces tool-switching, and enables developers to stay informed about bugs, features, and tasks.

## References

* [GitHub Issues Plugin Documentation](https://github.com/backstage/community-plugins/tree/main/workspaces/github-issues/plugins/github-issues)