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
What's Changed
- Update README.md by @nebuk89 in #407
- BREAKING fix: inconsistent path behavior for single artifact downloads by ID by @GrantBirki in #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 topath/(direct) - By ID:
artifact-ids: 12345→ extracted topath/my-artifact/(nested)
Now both methods are consistent:
- By name:
name: my-artifact→ extracted topath/(unchanged) - By ID:
artifact-ids: 12345→ extracted topath/(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: trueas a workaround
⚠️ Action Required If:
You download single artifacts by ID and your workflows expect the nested directory structure.
Before v5 (nested structure):
- uses: actions/download-artifact@v4
with:
artifact-ids: 12345
path: dist
# Files were in: dist/my-artifact/Where
my-artifactis the name of the artifact you previously uploaded
To maintain old behavior (if needed):
- uses: actions/download-artifact@v5
with:
artifact-ids: 12345
path: dist/my-artifact # Explicitly specify the nested pathNew Contributors
Full Changelog: actions/download-artifact@v4...v5.0.0
v4.3.0
What's Changed
- 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
New Contributors
- @GrantBirki made their first contribution in #401
Full Changelog: actions/download-artifact@v4.2.1...v4.3.0
v4.2.1
What's Changed
- Add unit tests by @GhadimiR in #392
- Fix bug introduced in 4.2.0 by @GhadimiR in #391
Full Changelog: actions/download-artifact@v4.2.0...v4.2.1
v4.2.0
What's Changed
- Update README.md by @lkfortuna in #384
- Bump artifact version, do digest check by @GhadimiR in #383
New Contributors
- @lkfortuna made their first contribution in #384
- @GhadimiR made their first contribution in #383
Full Changelog: actions/download-artifact@v4.1.9...v4.2.0
List of commits
baa5eda (Update GitHub Artifact Actions to v5, 2025-11-13)