Update GitHub Artifact Actions to v5 (major)
Notable changes
- Update README.md by @nebuk89 in #407
- BREAKING fix: inconsistent path behavior for single artifact downloads by ID by @GrantBirki in #416
- By name:
name: my-artifact→ extracted topath/(direct) - By ID:
artifact-ids: 12345→ extracted topath/my-artifact/(nested) - By name:
name: my-artifact→ extracted topath/(unchanged) - By ID:
artifact-ids: 12345→ extracted topath/(fixed - now direct) - You download artifacts by name
- You download multiple artifacts by ID
- You already use
merge-multiple: trueas a workaround - uses: actions/download-artifact@v4
- uses: actions/download-artifact@v5
- @nebuk89 made their first contribution in #407
- feat: implement new
artifact-idsinput by @GrantBirki in #401 - Fix workflow example for downloading by artifact ID by @joshmgross in #402
- Prep for v4.3.0 release by @robherley in #404
- @GrantBirki made their first contribution in #401
- Add unit tests by @GhadimiR in #392
- Fix bug introduced in 4.2.0 by @GhadimiR in #391
- Update README.md by @lkfortuna in #384
- Bump artifact version, do digest check by @GhadimiR in #383
- @lkfortuna made their first contribution in #384
- @GhadimiR made their first contribution in #383 -actions/upload-artifact (actions/upload-artifact)
actions/download-artifact (actions/download-artifact)
### [`v5.0.0`](https://redirect.github.com/actions/download-artifact/releases/tag/v5.0.0) [Compare Source](https://redirect.github.com/actions/download-artifact/compare/v4.3.0...v5.0.0) #### What's Changed - Update README.md by [@nebuk89](https://redirect.github.com/nebuk89) in [#407](https://redirect.github.com/actions/download-artifact/pull/407) - BREAKING fix: inconsistent path behavior for single artifact downloads by ID by [@GrantBirki](https://redirect.github.com/GrantBirki) in [#416](https://redirect.github.com/actions/download-artifact/pull/416) #### v5.0.0 ##### 🚨 Breaking Change This release fixes an inconsistency in path behavior for single artifact downloads by ID. **If you're downloading single artifacts by ID, the output path may change.** ##### What Changed Previously, **single artifact downloads** behaved differently depending on how you specified the artifact: - **By name**: `name: my-artifact` → extracted to `path/` (direct) - **By ID**: `artifact-ids: 12345` → extracted to `path/my-artifact/` (nested) Now both methods are consistent: - **By name**: `name: my-artifact` → extracted to `path/` (unchanged) - **By ID**: `artifact-ids: 12345` → extracted to `path/` (fixed - now direct) ##### Migration Guide ##### ✅ No Action Needed If: - You download artifacts by **name** - You download **multiple** artifacts by ID - You already use `merge-multiple: true` as a workaround ##### ⚠️ Action Required If: You download **single artifacts by ID** and your workflows expect the nested directory structure. **Before v5 (nested structure):** :::yaml - uses: actions/download-artifact@v4 with: artifact-ids: 12345 path: dist # Files were in: dist/my-artifact/ > Where `my-artifact` is the name of the artifact you previously uploaded **To maintain old behavior (if needed):** :::yaml - uses: actions/download-artifact@v5 with: artifact-ids: 12345 path: dist/my-artifact # Explicitly specify the nested path #### New Contributors - [@nebuk89](https://redirect.github.com/nebuk89) made their first contribution in [#407](https://redirect.github.com/actions/download-artifact/pull/407) **Full Changelog**: <https://github.com/actions/download-artifact/compare/v4...v5.0.0> ### [`v4.3.0`](https://redirect.github.com/actions/download-artifact/releases/tag/v4.3.0) [Compare Source](https://redirect.github.com/actions/download-artifact/compare/v4.2.1...v4.3.0) #### What's Changed - feat: implement new `artifact-ids` input by [@GrantBirki](https://redirect.github.com/GrantBirki) in [#401](https://redirect.github.com/actions/download-artifact/pull/401) - Fix workflow example for downloading by artifact ID by [@joshmgross](https://redirect.github.com/joshmgross) in [#402](https://redirect.github.com/actions/download-artifact/pull/402) - Prep for v4.3.0 release by [@robherley](https://redirect.github.com/robherley) in [#404](https://redirect.github.com/actions/download-artifact/pull/404) #### New Contributors - [@GrantBirki](https://redirect.github.com/GrantBirki) made their first contribution in [#401](https://redirect.github.com/actions/download-artifact/pull/401) **Full Changelog**: <https://github.com/actions/download-artifact/compare/v4.2.1...v4.3.0> ### [`v4.2.1`](https://redirect.github.com/actions/download-artifact/releases/tag/v4.2.1) [Compare Source](https://redirect.github.com/actions/download-artifact/compare/v4.2.0...v4.2.1) #### What's Changed - Add unit tests by [@GhadimiR](https://redirect.github.com/GhadimiR) in [#392](https://redirect.github.com/actions/download-artifact/pull/392) - Fix bug introduced in 4.2.0 by [@GhadimiR](https://redirect.github.com/GhadimiR) in [#391](https://redirect.github.com/actions/download-artifact/pull/391) **Full Changelog**: <https://github.com/actions/download-artifact/compare/v4.2.0...v4.2.1> ### [`v4.2.0`](https://redirect.github.com/actions/download-artifact/releases/tag/v4.2.0) [Compare Source](https://redirect.github.com/actions/download-artifact/compare/v4.1.9...v4.2.0) #### What's Changed - Update README.md by [@lkfortuna](https://redirect.github.com/lkfortuna) in [#384](https://redirect.github.com/actions/download-artifact/pull/384) - Bump artifact version, do digest check by [@GhadimiR](https://redirect.github.com/GhadimiR) in [#383](https://redirect.github.com/actions/download-artifact/pull/383) #### New Contributors - [@lkfortuna](https://redirect.github.com/lkfortuna) made their first contribution in [#384](https://redirect.github.com/actions/download-artifact/pull/384) - [@GhadimiR](https://redirect.github.com/GhadimiR) made their first contribution in [#383](https://redirect.github.com/actions/download-artifact/pull/383) **Full Changelog**: <https://github.com/actions/download-artifact/compare/v4.1.9...v4.2.0>actions/upload-artifact (actions/upload-artifact)
### [`v5`](https://redirect.github.com/actions/upload-artifact/compare/v4...v5) [Compare Source](https://redirect.github.com/actions/upload-artifact/compare/v4...v5)List of commits
baa5edad (Update GitHub Artifact Actions to v5, 2025-11-13)