# softprops/action-gh-release

📦 :octocat: GitHub Action for creating GitHub Releases

Repository: https://github.com/softprops/action-gh-release
Canonical: https://ross.abutalabs.com/products/action-gh-release
Language: TypeScript
License: MIT
License Family: permissive
Topics: github-actions, github-releases
Last push: 2026-08-16T20:38:52+00:00

## Health v2 (maintenance only)
Score: 97/100 (v2, computed 2026-09-03T02:20:16.233290+00:00)
- activity 98, release rhythm 93, longevity 100
- inputs: {"age_days": 2565, "days_push": 17, "days_rel": 51, "gap_med": 22.5, "n_releases_24m": 23}
- flags: none
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 5745, forks 638 (observed 2026-08-28T04:09:28.461376+00:00)

## What it is
A GitHub Action for creating GitHub Releases from CI workflows, with support for uploading release assets via glob patterns and updating existing releases. It runs on Linux, Windows, and macOS runners and is typically gated on tag pushes.

## Use cases
- automatically create a GitHub release when a tag is pushed
- upload build artifacts to a GitHub release from CI
- attach binaries to releases in a GitHub Actions workflow
- update an existing release with new assets
- use external release notes files for releases

## When to choose
- you want to automate GitHub release creation in GitHub Actions
- you need to upload packaged binaries or files as release assets
- you want releases triggered only on tag pushes

## When to avoid
- you release from a CI system other than GitHub Actions
- you need to publish to package registries rather than GitHub Releases

## Facets
- artifact type: plugin
- maturity: active
- function: deployment, ci-cd, developer-tools
- domain: developer-tools
- platform: windows, cloud
- tags: github-actions, github-releases, release-automation, release-assets, typescript, devops, automation, linux, macos, docker

## Member repositories
- softprops/action-gh-release (main) score 97

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:09:28.461376+00:00.
- Health v2: computed from the inputs above; adoption is never an input.
- Inferred fields (summary, facets, guidance): AI-extracted, prompt v1, taxonomy v1, on 2026-08-29T17:53:20.285868+00:00, confidence not recorded.
  - readme: https://github.com/softprops/action-gh-release (fetched 2026-08-28T04:09:28.461376+00:00, sha d7e3398cb501)
- Data as of 2026-08-30T08:39:29.467469+00:00.