2026-03-14 20:21:43 -04:00
## 2.5.1
`2.5.1` is a patch release focused on regressions introduced in `2.5.0` and on release lookup reliability.
It fixes `#713` , addresses `#703` , and fixes `#724` . Regression testing shows that
current `master` no longer reproduces the finalize-race behavior reported in `#704` and `#709` .
## What's Changed
### Bug fixes 🐛
* fix: fetch correct asset URL after finalization; test; some refactoring by @pzhlkj6612 in https://github.com/softprops/action-gh-release/pull/738
* fix: release marked as 'latest' despite make_latest: false by @Boshen in https://github.com/softprops/action-gh-release/pull/715
* fix: use getReleaseByTag API instead of iterating all releases by @kim -em in https://github.com/softprops/action-gh-release/pull/725
### Other Changes 🔄
* dependency updates, including the ESM/runtime compatibility refresh in https://github.com/softprops/action-gh-release/pull/731
2025-12-01 01:02:34 -05:00
## 2.5.0
## What's Changed
### Exciting New Features 🎉
* feat: mark release as draft until all artifacts are uploaded by @dumbmoron in https://github.com/softprops/action-gh-release/pull/692
### Other Changes 🔄
* dependency updates
2025-11-08 14:21:57 -05:00
## 2.4.2
## What's Changed
### Exciting New Features 🎉
* feat: Ensure generated release notes cannot be over 125000 characters by @BeryJu in https://github.com/softprops/action-gh-release/pull/684
### Other Changes 🔄
2025-12-01 01:02:34 -05:00
* dependency updates
2025-11-08 14:21:57 -05:00
2025-10-11 11:40:52 -04:00
## 2.4.1
## What's Changed
### Other Changes 🔄
* fix(util): support brace expansion globs containing commas in parseInputFiles by @Copilot in https://github.com/softprops/action-gh-release/pull/672
* fix: gracefully fallback to body when body_path cannot be read by @Copilot in https://github.com/softprops/action-gh-release/pull/671
2025-10-06 22:53:32 -04:00
## 2.4.0
## What's Changed
### Exciting New Features 🎉
* feat(action): respect working_directory for files globs by @stephenway in https://github.com/softprops/action-gh-release/pull/667
2025-10-03 14:45:26 -04:00
## 2.3.4
## What's Changed
### Bug fixes 🐛
* fix(action): handle 422 already_exists race condition by @stephenway in https://github.com/softprops/action-gh-release/pull/665
### Other Changes 🔄
- dependency updates
2025-09-07 00:36:40 -04:00
## 2.3.3
## What's Changed
### Exciting New Features 🎉
* feat: add input option `overwrite_files` by @asfernandes in https://github.com/softprops/action-gh-release/pull/343
### Other Changes 🔄
- dependency updates
2025-06-10 18:33:08 -04:00
## 2.3.2
* fix: revert fs `readableWebStream` change
2025-06-10 17:15:05 -04:00
## 2.3.1
### Bug fixes 🐛
* fix: fix file closing issue by @WailGree in https://github.com/softprops/action-gh-release/pull/629
2025-06-09 21:01:02 -04:00
## 2.3.0
* Migrate from jest to vitest
* Replace `mime` with `mime-types`
* Bump to use node 24
* Dependency updates
2025-04-18 17:33:17 -04:00
## 2.2.2
## What's Changed
### Bug fixes 🐛
* fix: updating release draft status from true to false by @galargh in https://github.com/softprops/action-gh-release/pull/316
### Other Changes 🔄
* chore: simplify ref_type test by @steinybot in https://github.com/softprops/action-gh-release/pull/598
* fix(docs): clarify the default for tag_name by @muzimuzhi in https://github.com/softprops/action-gh-release/pull/599
* test(release): add unit tests when searching for a release by @rwaskiewicz in https://github.com/softprops/action-gh-release/pull/603
* dependency updates
2025-01-07 13:45:03 -05:00
## 2.2.1
## What's Changed
### Bug fixes 🐛
* fix: big file uploads by @xen0n in https://github.com/softprops/action-gh-release/pull/562
### Other Changes 🔄
* chore(deps): bump @types/node from 22.10.1 to 22.10.2 by @dependabot in https://github.com/softprops/action-gh-release/pull/559
* chore(deps): bump @types/node from 22.10.2 to 22.10.5 by @dependabot in https://github.com/softprops/action-gh-release/pull/569
* chore: update error and warning messages for not matching files in files field by @ytimocin in https://github.com/softprops/action-gh-release/pull/568
2024-12-10 21:23:24 -05:00
## 2.2.0
## What's Changed
### Exciting New Features 🎉
* feat: read the release assets asynchronously by @xen0n in https://github.com/softprops/action-gh-release/pull/552
### Bug fixes 🐛
* fix(docs): clarify the default for tag_name by @alexeagle in https://github.com/softprops/action-gh-release/pull/544
### Other Changes 🔄
* chore(deps): bump typescript from 5.6.3 to 5.7.2 by @dependabot in https://github.com/softprops/action-gh-release/pull/548
* chore(deps): bump @types/node from 22.9.0 to 22.9.4 by @dependabot in https://github.com/softprops/action-gh-release/pull/547
* chore(deps): bump cross-spawn from 7.0.3 to 7.0.6 by @dependabot in https://github.com/softprops/action-gh-release/pull/545
* chore(deps): bump @vercel/ncc from 0.38.2 to 0.38.3 by @dependabot in https://github.com/softprops/action-gh-release/pull/543
* chore(deps): bump prettier from 3.3.3 to 3.4.1 by @dependabot in https://github.com/softprops/action-gh-release/pull/550
* chore(deps): bump @types/node from 22.9.4 to 22.10.1 by @dependabot in https://github.com/softprops/action-gh-release/pull/551
* chore(deps): bump prettier from 3.4.1 to 3.4.2 by @dependabot in https://github.com/softprops/action-gh-release/pull/554
2024-11-11 15:15:48 -05:00
## 2.1.0
## What's Changed
### Exciting New Features 🎉
* feat: add support for release assets with multiple spaces within the name by @dukhine in https://github.com/softprops/action-gh-release/pull/518
* feat: preserve upload order by @richarddd in https://github.com/softprops/action-gh-release/pull/500
### Other Changes 🔄
* chore(deps): bump @types/node from 22.8.2 to 22.8.7 by @dependabot in https://github.com/softprops/action-gh-release/pull/539
2024-10-31 14:17:14 -04:00
## 2.0.9
- maintenance release with updated dependencies
2024-07-18 17:39:42 -04:00
## 2.0.8
### Other Changes 🔄
* chore(deps): bump prettier from 2.8.0 to 3.3.3 by @dependabot in https://github.com/softprops/action-gh-release/pull/480
* chore(deps): bump @types/node from 20.14.9 to 20.14.11 by @dependabot in https://github.com/softprops/action-gh-release/pull/483
* chore(deps): bump @octokit/plugin -throttling from 9.3.0 to 9.3.1 by @dependabot in https://github.com/softprops/action-gh-release/pull/484
* chore(deps): bump glob from 10.4.2 to 11.0.0 by @dependabot in https://github.com/softprops/action-gh-release/pull/477
* refactor: write jest config in ts by @chenrui333 in https://github.com/softprops/action-gh-release/pull/485
* chore(deps): bump @actions/github from 5.1.1 to 6.0.0 by @dependabot in https://github.com/softprops/action-gh-release/pull/470
2024-07-17 15:51:10 -04:00
## 2.0.7
### Bug fixes 🐛
* Fix missing update release body by @FirelightFlagboy in https://github.com/softprops/action-gh-release/pull/365
### Other Changes 🔄
* Bump @octokit/plugin -retry from 4.0.3 to 7.1.1 by @dependabot in https://github.com/softprops/action-gh-release/pull/443
* Bump typescript from 4.9.5 to 5.5.2 by @dependabot in https://github.com/softprops/action-gh-release/pull/467
* Bump @types/node from 20.14.6 to 20.14.8 by @dependabot in https://github.com/softprops/action-gh-release/pull/469
* Bump @types/node from 20.14.8 to 20.14.9 by @dependabot in https://github.com/softprops/action-gh-release/pull/473
* Bump typescript from 5.5.2 to 5.5.3 by @dependabot in https://github.com/softprops/action-gh-release/pull/472
* Bump ts-jest from 29.1.5 to 29.2.2 by @dependabot in https://github.com/softprops/action-gh-release/pull/479
* docs: document that existing releases are updated by @jvanbruegge in https://github.com/softprops/action-gh-release/pull/474
2024-06-19 17:02:53 -04:00
## 2.0.6
- maintenance release with updated dependencies
2024-05-07 09:26:47 -04:00
## 2.0.5
2024-05-06 09:38:04 -04:00
- Factor in file names with spaces when upserting files [#446 ](https://github.com/softprops/action-gh-release/pull/446 ) via [@MystiPanda ](https://github.com/MystiPanda )
2024-05-07 09:23:27 -04:00
- Improvements to error handling [#449 ](https://github.com/softprops/action-gh-release/pull/449 ) via [@till ](https://github.com/till )
2024-05-06 09:38:04 -04:00
2024-03-12 12:22:52 -04:00
## 2.0.4
- Minor follow up to [#417 ](https://github.com/softprops/action-gh-release/pull/417 ). [#425 ](https://github.com/softprops/action-gh-release/pull/425 )
2024-03-11 09:44:32 -04:00
## 2.0.3
- Declare `make_latest` as an input field in `action.yml` [#419 ](https://github.com/softprops/action-gh-release/pull/419 )
2024-03-10 00:57:11 -05:00
## 2.0.2
2024-03-08 16:35:59 -05:00
2024-03-10 00:56:17 -05:00
- Revisit approach to [#384 ](https://github.com/softprops/action-gh-release/pull/384 ) making unresolved pattern failures opt-in [#417 ](https://github.com/softprops/action-gh-release/pull/417 )
2024-03-08 16:35:59 -05:00
## 2.0.1
2024-03-08 15:50:31 -05:00
2024-03-08 16:30:09 -05:00
- Add support for make_latest property [#304 ](https://github.com/softprops/action-gh-release/pull/304 ) via [@samueljseay ](https://github.com/samueljseay )
2024-03-08 16:13:09 -05:00
- Fail run if files setting contains invalid patterns [#384 ](https://github.com/softprops/action-gh-release/pull/384 ) via [@rpdelaney ](https://github.com/rpdelaney )
2024-03-08 16:00:09 -05:00
- Add support for proxy env variables (don't use node-fetch) [#386 ](https://github.com/softprops/action-gh-release/pull/386/ ) via [@timor-raiman ](https://github.com/timor-raiman )
2024-03-08 16:13:09 -05:00
- Suppress confusing warning when input_files is empty [#389 ](https://github.com/softprops/action-gh-release/pull/389 ) via [@Drowze ](https://github.com/Drowze )
2024-03-08 15:50:31 -05:00
2024-03-08 15:21:48 -05:00
## 2.0.0
2025-12-06 20:00:40 +01:00
- `2.0.0` !? this release corrects a disjunction between git tag versions used in the marketplace and the versions listed in this file. Previous versions should have really been 1.\*. Going forward this should be better aligned.
2024-03-08 16:22:51 -05:00
- Upgrade action.yml declaration to node20 to address deprecations
2024-03-08 15:21:48 -05:00
2022-11-21 01:58:37 -05:00
## 0.1.15
- Upgrade to action.yml declaration to node16 to address deprecations
- Upgrade dependencies
2021-11-26 00:02:50 +01:00
- Add `asset` output as a JSON array containing information about the uploaded assets
2021-11-15 01:30:36 -05:00
## 0.1.14
2025-12-06 20:00:40 +01:00
- provides a new workflow input option `generate_release_notes` which when set to true will automatically generate release notes for you based on GitHub activity [#179 ](https://github.com/softprops/action-gh-release/pull/179 ). Please see the [GitHub docs for this feature ](https://docs.github.com/en/repositories/releasing-projects-on-github/automatically-generated-release-notes ) for more information
2021-11-15 01:30:36 -05:00
2021-09-13 21:46:37 -04:00
## 0.1.13
- fix issue with multiple runs concatenating release bodies [#145 ](https://github.com/softprops/action-gh-release/pull/145 )
2021-08-09 23:59:33 -04:00
## 0.1.12
2025-12-06 20:00:40 +01:00
- fix bug leading to empty strings substituted for inputs users don't provide breaking api calls [#144 ](https://github.com/softprops/action-gh-release/pull/144 )
2021-08-09 23:59:33 -04:00
2021-08-09 09:27:57 -04:00
## 0.1.11
- better error message on release create failed [#143 ](https://github.com/softprops/action-gh-release/pull/143 )
2021-08-09 23:59:33 -04:00
2021-08-08 12:10:40 -04:00
## 0.1.10
- fixed error message formatting for file uploads
2021-08-08 11:55:10 -04:00
## 0.1.9
- add support for linking release to GitHub discussion [#136 ](https://github.com/softprops/action-gh-release/pull/136 )
2021-07-30 18:41:53 -04:00
## 0.1.8
2021-08-08 00:31:19 -04:00
- address recent warnings in assert upload api as well as introduce asset upload overrides, allowing for multiple runs for the same release with the same named asserts [#134 ](https://github.com/softprops/action-gh-release/pull/134 )
2025-12-06 20:00:40 +01:00
- fix backwards compatibility with `GITHUB_TOKEN` resolution. `GITHUB_TOKEN` is now resolved first from an env variable and then from an input [#133 ](https://github.com/softprops/action-gh-release/pull/133 )
2021-07-30 18:43:29 -04:00
- trim white space in provided `tag_name` [#130 ](https://github.com/softprops/action-gh-release/pull/130 )
2021-07-30 18:41:53 -04:00
2021-07-27 00:52:21 -04:00
## 0.1.7
2021-07-25 19:10:56 -04:00
- allow creating draft releases without a tag [#95 ](https://github.com/softprops/action-gh-release/pull/95 )
2021-07-25 20:13:03 -04:00
- Set default token for simpler setup [#83 ](https://github.com/softprops/action-gh-release/pull/83 )
2021-07-27 00:52:21 -04:00
- fix regression with action yml [#126 ](https://github.com/softprops/action-gh-release/pull/126 )
2021-07-25 19:10:56 -04:00
2021-07-25 19:02:03 -04:00
## 0.1.6
2021-07-25 18:58:47 -04:00
This is a release catch up have a hiatus. Future releases will happen more frequently
2025-12-06 20:00:40 +01:00
- Add 'fail_on_unmatched_files' input, useful for catching cases where your `files` input does not actually match what you expect [#55 ](https://github.com/softprops/action-gh-release/pull/55 )
2021-07-25 18:58:47 -04:00
- Add `repository` input, useful for creating a release in an external repository [#61 ](https://github.com/softprops/action-gh-release/pull/61 )
2025-12-06 20:00:40 +01:00
- Add release `id` to outputs, useful for referring to release in workflow steps following the step that uses this action [#60 ](https://github.com/softprops/action-gh-release/pull/60 )
2021-07-25 18:58:47 -04:00
- Add `upload_url` as action output, useful for managing uploads separately [#75 ](https://github.com/softprops/action-gh-release/pull/75 )
- Support custom `target_commitish` value, useful to customize the default [#76 ](https://github.com/softprops/action-gh-release/pull/76 )
2025-12-06 20:00:40 +01:00
- fix `body_path` input first then fall back on `body` input. This was the originally documented precedence but was implemented in the opposite order! [#85 ](https://github.com/softprops/action-gh-release/pull/85 )
2021-07-25 18:58:47 -04:00
- Retain original release info if the keys are not set, useful for filling in blanks for a release you've already started separately [#109 ](https://github.com/softprops/action-gh-release/pull/109 )
2025-12-06 20:00:40 +01:00
- Limit number of times github api request to create a release is retried, useful for avoiding eating up your rate limit and action minutes due to either an invalid token or other circumstance causing the api call to fail [#111 ](https://github.com/softprops/action-gh-release/pull/111 )
2021-07-25 18:58:47 -04:00
2020-01-26 19:31:05 -05:00
## 0.1.5
2021-07-25 18:58:47 -04:00
- Added support for specifying tag name [#39 ](https://github.com/softprops/action-gh-release/pull/39 )
2020-01-26 19:31:05 -05:00
2019-10-20 18:15:51 -04:00
## 0.1.4
2021-07-25 18:58:47 -04:00
- Added support for updating releases body [#36 ](https://github.com/softprops/action-gh-release/pull/36 )
- Steps can now access the url of releases with the `url` output of this Action [#28 ](https://github.com/softprops/action-gh-release/pull/28 )
2025-12-06 20:00:40 +01:00
- Added basic GitHub API retry support to manage API turbulence [#26 ](https://github.com/softprops/action-gh-release/pull/26 )
2019-10-20 18:15:51 -04:00
2019-09-29 08:25:51 -04:00
## 0.1.3
2021-07-25 18:58:47 -04:00
- Fixed where `with: body_path` was not being used in generated GitHub releases
2019-09-29 08:25:51 -04:00
2019-09-17 19:38:31 +09:00
## 0.1.2
2021-07-25 18:58:47 -04:00
- Add support for merging draft releases [#16 ](https://github.com/softprops/action-gh-release/pull/16 )
2019-09-09 21:02:30 +09:00
2019-09-17 19:38:31 +09:00
GitHub's api doesn't explicitly have a way of fetching a draft release by tag name which caused draft releases to appear as separate releases when used in a build matrix.
This is now fixed.
2021-07-25 18:58:47 -04:00
- Add support for newline-delimited asset list [#18 ](https://github.com/softprops/action-gh-release/pull/18 )
2019-09-17 23:21:28 +09:00
2025-12-06 20:00:40 +01:00
GitHub actions inputs don't inherently support lists of things and one might like to append a list of files to include in a release. Previously this was possible using a comma-delimited list of asset path patterns to upload. You can now provide these as a newline delimited list for better readability
2019-09-17 23:21:28 +09:00
```yaml
2021-07-25 18:58:47 -04:00
- name: Release
uses: softprops/action-gh-release@v1
if: startsWith(github.ref, 'refs/tags/')
with:
files: |
filea.txt
fileb.txt
filec.txt
env:
GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
2019-09-17 23:21:28 +09:00
```
2021-07-25 18:58:47 -04:00
- Add support for prerelease annotated GitHub releases with the new input field `with.prerelease: true` [#19 ](https://github.com/softprops/action-gh-release/pull/19 )
2019-09-17 23:30:36 +09:00
2019-09-17 19:38:31 +09:00
---
2019-09-09 21:02:30 +09:00
## 0.1.1
2021-07-25 18:58:47 -04:00
- Add support for publishing releases on all supported virtual hosts
2019-09-09 21:35:52 +09:00
2019-09-17 19:38:31 +09:00
You'll need to remove `docker://` prefix and use the `@v1` action tag
---
## 0.1.0
2021-07-25 18:58:47 -04:00
- Initial release