> ## 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 Actions

> View, monitor, and re-run GitHub Actions workflow runs with real-time status updates directly from Portal entity pages.

Automate workflows directly in GitHub

# Metadata

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

# Packages

```
- @backstage/plugin-github-actions
```

## Overview

The GitHub Actions plugin brings workflow automation visibility into Portal, allowing developers to monitor and manage their CI/CD pipelines without leaving the portal. This plugin provides a direct view of GitHub Actions workflow runs, their status, and execution history, helping teams stay informed about build and deployment processes.

## Key Features

* **Workflow runs overview** — displays recent workflow runs with status indicators (success, failure, in-progress) directly on entity pages.
* **Real-time status updates** — shows live updates of workflow execution status without leaving Portal.
* **Workflow execution history** — provides a comprehensive view of past workflow runs with filtering capabilities.
* **Quick access to logs** — enables developers to view workflow logs and debug failures directly from Portal.
* **Entity mapping** — links Portal components to GitHub repositories via annotations (`github.com/project-slug`).
* **Multiple workflow support** — displays all workflows associated with a repository.
* **Re-run workflows** — allows triggering workflow re-runs directly from Portal (with proper permissions).
* **Branch and commit information** — shows which branch and commit triggered each workflow run.
* **IDP benefit** — reduces context-switching by centralizing CI/CD visibility and streamlines developer workflows.

## References

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