[!IMPORTANT]
actions/download-artifact@v8 has been migrated to an ESM module. This should be transparent to the caller but forks might need to make significant changes.
[!IMPORTANT]
Hash mismatches will now error by default. Users can override this behavior with a setting change (see below).
Direct downloads
To support direct uploads in actions/upload-artifact, the action will no longer attempt to unzip all downloaded files. Instead, the action checks the Content-Type header ahead of unzipping and skips non-zipped files. Callers wishing to download a zipped file as-is can also set the new skip-decompress parameter to true.
Enforced checks (breaking)
A previous release introduced digest checks on the download. If a download hash didn't match the expected hash from the server, the action would log a warning. Callers can now configure the behavior on mismatch with the digest-mismatch parameter. To be secure by default, we are now defaulting the behavior to error which will fail the workflow run.
ESM
To support new versions of the @actions/* packages, we've upgraded the package to ESM.
[!IMPORTANT]
actions/download-artifact@v7 now runs on Node.js 24 (runs.using: node24) and requires a minimum Actions Runner version of 2.327.1. If you are using self-hosted runners, ensure they are updated before upgrading.
Node.js 24
This release updates the runtime to Node.js 24. v6 had preliminary support for Node 24, however this action was by default still running on Node.js 20. Now this action by default will run on Node.js 24.
What's Changed
Update GHES guidance to include reference to Node 20 version by @patrikpolyak in #440
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 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):
- uses:actions/download-artifact@v4with:artifact-ids:12345path: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):
- uses:actions/download-artifact@v5with:artifact-ids:12345path:dist/my-artifact # Explicitly specify the nested path
The release of upload-artifact@v4 and download-artifact@v4 are major changes to the backend architecture of Artifacts. They have numerous performance and behavioral improvements.
ℹ️ However, this is a major update that includes breaking changes. Artifacts created with versions v3 and below are not compatible with the v4 actions. Uploads and downloads must use the same major actions versions. There are also key differences from previous versions that may require updates to your workflows.
As well as the underlying npm package, @actions/artifact documentation.
Breaking Changes
download-artifact@v4+ is not currently supported on GitHub Enterprise Server (GHES) yet. If you are on GHES, you must use v3 (Node 16) or v3-node20 (Node 20).
On self hosted runners, additional firewall rules may be required.
Downloading artifacts that were created from action/upload-artifact@v3 and below are not supported.
For assistance with breaking changes, see MIGRATION.md.
Improvements
Downloads are significantly faster, upwards of 90% improvement in worst case scenarios.
Artifacts can be downloaded from other workflow runs and repositories when supplied with a PAT.
[!Important]
actions/download-artifact@v3.1.0 runs on Node.js 24 (runs.using: node24) and requires a minimum Actions Runner version of 2.327.1. If you are using self-hosted runners, ensure they are updated before upgrading.
This is a backport security updates release for GHES users. This version is deprecated on github.com and should not be used!
Node.js 24
This release updates the runtime to Node.js 24. The previous v3.0.2 ran on Node.js 16, which has reached end-of-life. Now this action will run on Node.js 24.
Fixed a bug in Node16 where if an HTTP download finished too quickly (<1ms, e.g. when it's mocked) we attempt to delete a temp file that has not been created yet actions/toolkit#1278
Adds support for uploading single files directly (unzipped). Callers can set the new archive parameter to false to skip zipping the file during upload. Right now, we only support single files. The action will fail if the glob passed resolves to multiple files. The name parameter is also ignored with this setting. Instead, the name of the artifact will be the name of the uploaded file.
ESM
To support new versions of the @actions/* packages, we've upgraded the package to ESM.
[!IMPORTANT]
actions/upload-artifact@v6 now runs on Node.js 24 (runs.using: node24) and requires a minimum Actions Runner version of 2.327.1. If you are using self-hosted runners, ensure they are updated before upgrading.
Node.js 24
This release updates the runtime to Node.js 24. v5 had preliminary support for Node.js 24, however this action was by default still running on Node.js 20. Now this action by default will run on Node.js 24.
We will no longer include hidden files and folders by default in the upload-artifact action of this version. This reduces the risk that credentials are accidentally uploaded into artifacts. Customers who need to continue to upload these files can use a new option, include-hidden-files, to continue to do so.
The release of upload-artifact@v4 and download-artifact@v4 are major changes to the backend architecture of Artifacts. They have numerous performance and behavioral improvements.
ℹ️ However, this is a major update that includes breaking changes. Artifacts created with versions v3 and below are not compatible with the v4 actions. Uploads and downloads must use the same major actions versions. There are also key differences from previous versions that may require updates to your workflows.
[!Important]
actions/upload-artifact@v3.2.2 now runs on Node.js 24 (runs.using: node24) and requires a minimum Actions Runner version of 2.327.1. If you are using self-hosted runners, ensure they are updated before upgrading.
This is a backport security updates release for GHES users. This version is deprecated on github.com and should not be used!
Node.js 24
This release updates the runtime to Node.js 24. The previous v3.2.1 ran on Node.js 16, which has reached end-of-life. Now this action will run on Node.js 24.
We will no longer include hidden files and folders by default in the upload-artifact action of this version. This reduces the risk that credentials are accidentally uploaded into artifacts. Customers who need to continue to upload these files can use a new option, include-hidden-files, to continue to do so.
This PR contains the following updates:
| Package | Type | Update | Change |
|---|---|---|---|
| [actions/download-artifact](https://github.com/actions/download-artifact) | action | major | `v3` → `v8` |
| [actions/upload-artifact](https://github.com/actions/upload-artifact) | action | major | `v3` → `v7` |
---
### Release Notes
<details>
<summary>actions/download-artifact (actions/download-artifact)</summary>
### [`v8.0.1`](https://github.com/actions/download-artifact/releases/tag/v8.0.1)
[Compare Source](https://github.com/actions/download-artifact/compare/v8...v8.0.1)
##### What's Changed
- Support for CJK characters in the artifact name by [@​danwkennedy](https://github.com/danwkennedy) in [#​471](https://github.com/actions/download-artifact/pull/471)
- Add a regression test for artifact name + content-type mismatches by [@​danwkennedy](https://github.com/danwkennedy) in [#​472](https://github.com/actions/download-artifact/pull/472)
**Full Changelog**: <https://github.com/actions/download-artifact/compare/v8...v8.0.1>
### [`v8.0.0`](https://github.com/actions/download-artifact/releases/tag/v8.0.0)
[Compare Source](https://github.com/actions/download-artifact/compare/v8...v8)
##### v8 - What's new
> \[!IMPORTANT]
> actions/download-artifact\@​v8 has been migrated to an ESM module. This should be transparent to the caller but forks might need to make significant changes.
> \[!IMPORTANT]
> Hash mismatches will now error by default. Users can override this behavior with a setting change (see below).
##### Direct downloads
To support direct uploads in `actions/upload-artifact`, the action will no longer attempt to unzip all downloaded files. Instead, the action checks the `Content-Type` header ahead of unzipping and skips non-zipped files. Callers wishing to download a zipped file as-is can also set the new `skip-decompress` parameter to `true`.
##### Enforced checks (breaking)
A previous release introduced digest checks on the download. If a download hash didn't match the expected hash from the server, the action would log a warning. Callers can now configure the behavior on mismatch with the `digest-mismatch` parameter. To be secure by default, we are now defaulting the behavior to `error` which will fail the workflow run.
##### ESM
To support new versions of the @​actions/\* packages, we've upgraded the package to ESM.
##### What's Changed
- Don't attempt to un-zip non-zipped downloads by [@​danwkennedy](https://github.com/danwkennedy) in [#​460](https://github.com/actions/download-artifact/pull/460)
- Add a setting to specify what to do on hash mismatch and default it to `error` by [@​danwkennedy](https://github.com/danwkennedy) in [#​461](https://github.com/actions/download-artifact/pull/461)
**Full Changelog**: <https://github.com/actions/download-artifact/compare/v7...v8.0.0>
### [`v8`](https://github.com/actions/download-artifact/compare/v7.0.0...v8)
[Compare Source](https://github.com/actions/download-artifact/compare/v7.0.0...v8)
### [`v7.0.0`](https://github.com/actions/download-artifact/releases/tag/v7.0.0)
[Compare Source](https://github.com/actions/download-artifact/compare/v7.0.0...v7.0.0)
##### v7 - What's new
> \[!IMPORTANT]
> actions/download-artifact\@​v7 now runs on Node.js 24 (`runs.using: node24`) and requires a minimum Actions Runner version of 2.327.1. If you are using self-hosted runners, ensure they are updated before upgrading.
##### Node.js 24
This release updates the runtime to Node.js 24. v6 had preliminary support for Node 24, however this action was by default still running on Node.js 20. Now this action by default will run on Node.js 24.
##### What's Changed
- Update GHES guidance to include reference to Node 20 version by [@​patrikpolyak](https://github.com/patrikpolyak) in [#​440](https://github.com/actions/download-artifact/pull/440)
- Download Artifact Node24 support by [@​salmanmkc](https://github.com/salmanmkc) in [#​415](https://github.com/actions/download-artifact/pull/415)
- fix: update [@​actions/artifact](https://github.com/actions/artifact) to fix Node.js 24 punycode deprecation by [@​salmanmkc](https://github.com/salmanmkc) in [#​451](https://github.com/actions/download-artifact/pull/451)
- prepare release v7.0.0 for Node.js 24 support by [@​salmanmkc](https://github.com/salmanmkc) in [#​452](https://github.com/actions/download-artifact/pull/452)
##### New Contributors
- [@​patrikpolyak](https://github.com/patrikpolyak) made their first contribution in [#​440](https://github.com/actions/download-artifact/pull/440)
- [@​salmanmkc](https://github.com/salmanmkc) made their first contribution in [#​415](https://github.com/actions/download-artifact/pull/415)
**Full Changelog**: <https://github.com/actions/download-artifact/compare/v6.0.0...v7.0.0>
### [`v7`](https://github.com/actions/download-artifact/compare/v6.0.0...v7.0.0)
[Compare Source](https://github.com/actions/download-artifact/compare/v6.0.0...v7.0.0)
### [`v6.0.0`](https://github.com/actions/download-artifact/releases/tag/v6.0.0)
[Compare Source](https://github.com/actions/download-artifact/compare/v6.0.0...v6.0.0)
##### What's Changed
**BREAKING CHANGE:** this update supports Node `v24.x`. This is not a breaking change per-se but we're treating it as such.
- Update README for download-artifact v5 changes by [@​yacaovsnc](https://github.com/yacaovsnc) in [#​417](https://github.com/actions/download-artifact/pull/417)
- Update README with artifact extraction details by [@​yacaovsnc](https://github.com/yacaovsnc) in [#​424](https://github.com/actions/download-artifact/pull/424)
- Readme: spell out the first use of GHES by [@​danwkennedy](https://github.com/danwkennedy) in [#​431](https://github.com/actions/download-artifact/pull/431)
- Bump `@actions/artifact` to `v4.0.0`
- Prepare `v6.0.0` by [@​danwkennedy](https://github.com/danwkennedy) in [#​438](https://github.com/actions/download-artifact/pull/438)
##### New Contributors
- [@​danwkennedy](https://github.com/danwkennedy) made their first contribution in [#​431](https://github.com/actions/download-artifact/pull/431)
**Full Changelog**: <https://github.com/actions/download-artifact/compare/v5...v6.0.0>
### [`v6`](https://github.com/actions/download-artifact/compare/v5.0.0...v6.0.0)
[Compare Source](https://github.com/actions/download-artifact/compare/v5.0.0...v6.0.0)
### [`v5.0.0`](https://github.com/actions/download-artifact/releases/tag/v5.0.0)
[Compare Source](https://github.com/actions/download-artifact/compare/v5.0.0...v5.0.0)
##### What's Changed
- Update README.md by [@​nebuk89](https://github.com/nebuk89) in [#​407](https://github.com/actions/download-artifact/pull/407)
- BREAKING fix: inconsistent path behavior for single artifact downloads by ID by [@​GrantBirki](https://github.com/GrantBirki) in [#​416](https://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://github.com/nebuk89) made their first contribution in [#​407](https://github.com/actions/download-artifact/pull/407)
**Full Changelog**: <https://github.com/actions/download-artifact/compare/v4...v5.0.0>
### [`v5`](https://github.com/actions/download-artifact/compare/v4.3.0...v5.0.0)
[Compare Source](https://github.com/actions/download-artifact/compare/v4.3.0...v5.0.0)
### [`v4.3.0`](https://github.com/actions/download-artifact/releases/tag/v4.3.0)
[Compare Source](https://github.com/actions/download-artifact/compare/v4.2.1...v4.3.0)
##### What's Changed
- feat: implement new `artifact-ids` input by [@​GrantBirki](https://github.com/GrantBirki) in [#​401](https://github.com/actions/download-artifact/pull/401)
- Fix workflow example for downloading by artifact ID by [@​joshmgross](https://github.com/joshmgross) in [#​402](https://github.com/actions/download-artifact/pull/402)
- Prep for v4.3.0 release by [@​robherley](https://github.com/robherley) in [#​404](https://github.com/actions/download-artifact/pull/404)
##### New Contributors
- [@​GrantBirki](https://github.com/GrantBirki) made their first contribution in [#​401](https://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://github.com/actions/download-artifact/releases/tag/v4.2.1)
[Compare Source](https://github.com/actions/download-artifact/compare/v4.2.0...v4.2.1)
##### What's Changed
- Add unit tests by [@​GhadimiR](https://github.com/GhadimiR) in [#​392](https://github.com/actions/download-artifact/pull/392)
- Fix bug introduced in 4.2.0 by [@​GhadimiR](https://github.com/GhadimiR) in [#​391](https://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://github.com/actions/download-artifact/releases/tag/v4.2.0)
[Compare Source](https://github.com/actions/download-artifact/compare/v4.1.9...v4.2.0)
##### What's Changed
- Update README.md by [@​lkfortuna](https://github.com/lkfortuna) in [#​384](https://github.com/actions/download-artifact/pull/384)
- Bump artifact version, do digest check by [@​GhadimiR](https://github.com/GhadimiR) in [#​383](https://github.com/actions/download-artifact/pull/383)
##### New Contributors
- [@​lkfortuna](https://github.com/lkfortuna) made their first contribution in [#​384](https://github.com/actions/download-artifact/pull/384)
- [@​GhadimiR](https://github.com/GhadimiR) made their first contribution in [#​383](https://github.com/actions/download-artifact/pull/383)
**Full Changelog**: <https://github.com/actions/download-artifact/compare/v4.1.9...v4.2.0>
### [`v4.1.9`](https://github.com/actions/download-artifact/releases/tag/v4.1.9)
[Compare Source](https://github.com/actions/download-artifact/compare/v4.1.8...v4.1.9)
##### What's Changed
- Add workflow file for publishing releases to immutable action package by [@​Jcambass](https://github.com/Jcambass) in [#​354](https://github.com/actions/download-artifact/pull/354)
- docs: small migration fix by [@​froblesmartin](https://github.com/froblesmartin) in [#​370](https://github.com/actions/download-artifact/pull/370)
- Update MIGRATION.md by [@​andyfeller](https://github.com/andyfeller) in [#​372](https://github.com/actions/download-artifact/pull/372)
- Update artifact package to 2.2.2 by [@​yacaovsnc](https://github.com/yacaovsnc) in [#​380](https://github.com/actions/download-artifact/pull/380)
##### New Contributors
- [@​Jcambass](https://github.com/Jcambass) made their first contribution in [#​354](https://github.com/actions/download-artifact/pull/354)
- [@​froblesmartin](https://github.com/froblesmartin) made their first contribution in [#​370](https://github.com/actions/download-artifact/pull/370)
- [@​andyfeller](https://github.com/andyfeller) made their first contribution in [#​372](https://github.com/actions/download-artifact/pull/372)
- [@​yacaovsnc](https://github.com/yacaovsnc) made their first contribution in [#​380](https://github.com/actions/download-artifact/pull/380)
**Full Changelog**: <https://github.com/actions/download-artifact/compare/v4.1.8...v4.1.9>
### [`v4.1.8`](https://github.com/actions/download-artifact/releases/tag/v4.1.8)
[Compare Source](https://github.com/actions/download-artifact/compare/v4.1.7...v4.1.8)
##### What's Changed
- Update [@​actions/artifact](https://github.com/actions/artifact) version, bump dependencies by [@​robherley](https://github.com/robherley) in [#​341](https://github.com/actions/download-artifact/pull/341)
**Full Changelog**: <https://github.com/actions/download-artifact/compare/v4.1.7...v4.1.8>
### [`v4.1.7`](https://github.com/actions/download-artifact/releases/tag/v4.1.7)
[Compare Source](https://github.com/actions/download-artifact/compare/v4.1.6...v4.1.7)
##### What's Changed
- Update [@​actions/artifact](https://github.com/actions/artifact) dependency by [@​bethanyj28](https://github.com/bethanyj28) in [#​325](https://github.com/actions/download-artifact/pull/325)
**Full Changelog**: <https://github.com/actions/download-artifact/compare/v4.1.6...v4.1.7>
### [`v4.1.6`](https://github.com/actions/download-artifact/releases/tag/v4.1.6)
[Compare Source](https://github.com/actions/download-artifact/compare/v4.1.5...v4.1.6)
##### What's Changed
- updating `@actions/artifact` dependency to v2.1.6 by [@​eggyhead](https://github.com/eggyhead) in [#​324](https://github.com/actions/download-artifact/pull/324)
**Full Changelog**: <https://github.com/actions/download-artifact/compare/v4.1.5...v4.1.6>
### [`v4.1.5`](https://github.com/actions/download-artifact/releases/tag/v4.1.5)
[Compare Source](https://github.com/actions/download-artifact/compare/v4.1.4...v4.1.5)
##### What's Changed
- Update readme with v3/v2/v1 deprecation notice by [@​robherley](https://github.com/robherley) in [#​322](https://github.com/actions/download-artifact/pull/322)
- Update dependencies `@actions/core` to v1.10.1 and `@actions/artifact` to v2.1.5
**Full Changelog**: <https://github.com/actions/download-artifact/compare/v4.1.4...v4.1.5>
### [`v4.1.4`](https://github.com/actions/download-artifact/releases/tag/v4.1.4)
[Compare Source](https://github.com/actions/download-artifact/compare/v4.1.3...v4.1.4)
##### What's Changed
- Update [@​actions/artifact](https://github.com/actions/artifact) by [@​bethanyj28](https://github.com/bethanyj28) in [#​307](https://github.com/actions/download-artifact/pull/307)
**Full Changelog**: <https://github.com/actions/download-artifact/compare/v4...v4.1.4>
### [`v4.1.3`](https://github.com/actions/download-artifact/releases/tag/v4.1.3)
[Compare Source](https://github.com/actions/download-artifact/compare/v4.1.2...v4.1.3)
##### What's Changed
- Update release-new-action-version.yml by [@​konradpabjan](https://github.com/konradpabjan) in [#​292](https://github.com/actions/download-artifact/pull/292)
- Update toolkit dependency with updated unzip logic by [@​bethanyj28](https://github.com/bethanyj28) in [#​299](https://github.com/actions/download-artifact/pull/299)
- Update [@​actions/artifact](https://github.com/actions/artifact) by [@​bethanyj28](https://github.com/bethanyj28) in [#​303](https://github.com/actions/download-artifact/pull/303)
##### New Contributors
- [@​bethanyj28](https://github.com/bethanyj28) made their first contribution in [#​299](https://github.com/actions/download-artifact/pull/299)
**Full Changelog**: <https://github.com/actions/download-artifact/compare/v4...v4.1.3>
### [`v4.1.2`](https://github.com/actions/download-artifact/releases/tag/v4.1.2)
[Compare Source](https://github.com/actions/download-artifact/compare/v4.1.1...v4.1.2)
- Bump [@​actions/artifacts](https://github.com/actions/artifacts) to latest version to include [updated GHES host check](https://github.com/actions/toolkit/pull/1648)
### [`v4.1.1`](https://github.com/actions/download-artifact/releases/tag/v4.1.1)
[Compare Source](https://github.com/actions/download-artifact/compare/v4.1.0...v4.1.1)
- Fix transient request timeouts [#​249](https://github.com/actions/download-artifact/issues/249)
- Bump `@actions/artifacts` to latest version
### [`v4.1.0`](https://github.com/actions/download-artifact/releases/tag/v4.1.0)
[Compare Source](https://github.com/actions/download-artifact/compare/v4...v4.1.0)
##### What's Changed
- Some cleanup by [@​robherley](https://github.com/robherley) in [#​247](https://github.com/actions/download-artifact/pull/247)
- Fix default for run-id by [@​stchr](https://github.com/stchr) in [#​252](https://github.com/actions/download-artifact/pull/252)
- Support pattern matching to filter artifacts & merge to same directory by [@​robherley](https://github.com/robherley) in [#​259](https://github.com/actions/download-artifact/pull/259)
##### New Contributors
- [@​stchr](https://github.com/stchr) made their first contribution in [#​252](https://github.com/actions/download-artifact/pull/252)
**Full Changelog**: <https://github.com/actions/download-artifact/compare/v4...v4.1.0>
### [`v4.0.0`](https://github.com/actions/download-artifact/releases/tag/v4.0.0)
[Compare Source](https://github.com/actions/download-artifact/compare/v4...v4)
##### What's Changed
The release of upload-artifact\@​v4 and download-artifact\@​v4 are major changes to the backend architecture of Artifacts. They have numerous performance and behavioral improvements.
ℹ️ However, this is a major update that includes breaking changes. Artifacts created with versions v3 and below are not compatible with the v4 actions. Uploads and downloads *must* use the same major actions versions. There are also key differences from previous versions that may require updates to your workflows.
For more information, please see:
1. The [changelog](https://github.blog/changelog/2023-12-14-github-actions-artifacts-v4-is-now-generally-available/) post.
2. The [migration documentation](https://github.com/actions/upload-artifact/blob/main/docs/MIGRATION.md).
3. As well as the underlying npm package, [@​actions/artifact](https://github.com/actions/toolkit/tree/main/packages/artifact) documentation.
##### Breaking Changes
1. download-artifact\@​v4+ is not currently supported on GitHub Enterprise Server (GHES) yet. If you are on GHES, you must use [v3](https://github.com/actions/download-artifact/releases/tag/v3) (Node 16) or [v3-node20](https://github.com/actions/download-artifact/releases/tag/v3-node20) (Node 20).
2. On self hosted runners, additional [firewall rules](https://github.com/actions/toolkit/tree/main/packages/artifact#breaking-changes) may be required.
3. Downloading artifacts that were created from `action/upload-artifact@v3` and below are not supported.
For assistance with breaking changes, see [MIGRATION.md](https://github.com/actions/upload-artifact/blob/main/docs/MIGRATION.md).
##### Improvements
1. Downloads are significantly faster, upwards of 90% improvement in worst case scenarios.
2. Artifacts can be downloaded from other workflow runs and repositories when supplied with a PAT.
##### New Contributors
- [@​bflad](https://github.com/bflad) made their first contribution in [#​194](https://github.com/actions/download-artifact/pull/194)
**Full Changelog**: <https://github.com/actions/download-artifact/compare/v3...v4.0.0>
### [`v4`](https://github.com/actions/download-artifact/compare/v3.1.0...v4)
[Compare Source](https://github.com/actions/download-artifact/compare/v3.1.0...v4)
### [`v3.1.0`](https://github.com/actions/download-artifact/releases/tag/v3.1.0)
[Compare Source](https://github.com/actions/download-artifact/compare/v3.0.2...v3.1.0)
##### v3.1.0 - What's new
> \[!Important]
> actions/download-artifact\@​v3.1.0 runs on Node.js 24 (runs.using: node24) and requires a minimum Actions Runner version of `2.327.1`. If you are using self-hosted runners, ensure they are updated before upgrading.
>
> **This is a backport security updates release for GHES users. This version is deprecated on github.com and should not be used!**
##### Node.js 24
This release updates the runtime to Node.js 24. The previous v3.0.2 ran on Node.js 16, which has reached end-of-life. Now this action will run on Node.js 24.
Pin your workflows to: <https://github.com/actions/download-artifact/releases/tag/v3.1.0-node20> which is available if you're still in the process of phasing out Node 20.
##### What's Changed
- Upgrade [@​actions/artifact](https://github.com/actions/artifact) to 1.1.3 by [@​Link-](https://github.com/Link-)
- Security updates for direct and transitive dependencies
**Full Changelog**: <https://github.com/actions/download-artifact/compare/v3.0.2...v3.1.0-node20>
### [`v3.0.2`](https://github.com/actions/download-artifact/releases/tag/v3.0.2)
[Compare Source](https://github.com/actions/download-artifact/compare/v3.0.1...v3.0.2)
- Bump `@actions/artifact` to v1.1.1 - [#​195](https://github.com/actions/download-artifact/pull/195)
- Fixed a bug in Node16 where if an HTTP download finished too quickly (<1ms, e.g. when it's mocked) we attempt to delete a temp file that has not been created yet [actions/toolkit#1278](hhttps://github.com/actions/toolkit/pull/1278)
### [`v3.0.1`](https://github.com/actions/download-artifact/releases/tag/v3.0.1)
[Compare Source](https://github.com/actions/download-artifact/compare/v3...v3.0.1)
- [Bump @​actions/core to 1.10.0](https://github.com/actions/download-artifact/pull/178)
</details>
<details>
<summary>actions/upload-artifact (actions/upload-artifact)</summary>
### [`v7.0.1`](https://github.com/actions/upload-artifact/releases/tag/v7.0.1)
[Compare Source](https://github.com/actions/upload-artifact/compare/v7...v7.0.1)
##### What's Changed
- Update the readme with direct upload details by [@​danwkennedy](https://github.com/danwkennedy) in [#​795](https://github.com/actions/upload-artifact/pull/795)
- Readme: bump all the example versions to v7 by [@​danwkennedy](https://github.com/danwkennedy) in [#​796](https://github.com/actions/upload-artifact/pull/796)
- Include changes in typespec/ts-http-runtime 0.3.5 by [@​yacaovsnc](https://github.com/yacaovsnc) in [#​797](https://github.com/actions/upload-artifact/pull/797)
**Full Changelog**: <https://github.com/actions/upload-artifact/compare/v7...v7.0.1>
### [`v7.0.0`](https://github.com/actions/upload-artifact/releases/tag/v7.0.0)
[Compare Source](https://github.com/actions/upload-artifact/compare/v7...v7)
##### v7 What's new
##### Direct Uploads
Adds support for uploading single files directly (unzipped). Callers can set the new `archive` parameter to `false` to skip zipping the file during upload. Right now, we only support single files. The action will fail if the glob passed resolves to multiple files. The `name` parameter is also ignored with this setting. Instead, the name of the artifact will be the name of the uploaded file.
##### ESM
To support new versions of the `@actions/*` packages, we've upgraded the package to ESM.
##### What's Changed
- Add proxy integration test by [@​Link-](https://github.com/Link-) in [#​754](https://github.com/actions/upload-artifact/pull/754)
- Upgrade the module to ESM and bump dependencies by [@​danwkennedy](https://github.com/danwkennedy) in [#​762](https://github.com/actions/upload-artifact/pull/762)
- Support direct file uploads by [@​danwkennedy](https://github.com/danwkennedy) in [#​764](https://github.com/actions/upload-artifact/pull/764)
##### New Contributors
- [@​Link-](https://github.com/Link-) made their first contribution in [#​754](https://github.com/actions/upload-artifact/pull/754)
**Full Changelog**: <https://github.com/actions/upload-artifact/compare/v6...v7.0.0>
### [`v7`](https://github.com/actions/upload-artifact/compare/v6.0.0...v7)
[Compare Source](https://github.com/actions/upload-artifact/compare/v6.0.0...v7)
### [`v6.0.0`](https://github.com/actions/upload-artifact/releases/tag/v6.0.0)
[Compare Source](https://github.com/actions/upload-artifact/compare/v6.0.0...v6.0.0)
##### v6 - What's new
> \[!IMPORTANT]
> actions/upload-artifact\@​v6 now runs on Node.js 24 (`runs.using: node24`) and requires a minimum Actions Runner version of 2.327.1. If you are using self-hosted runners, ensure they are updated before upgrading.
##### Node.js 24
This release updates the runtime to Node.js 24. v5 had preliminary support for Node.js 24, however this action was by default still running on Node.js 20. Now this action by default will run on Node.js 24.
##### What's Changed
- Upload Artifact Node 24 support by [@​salmanmkc](https://github.com/salmanmkc) in [#​719](https://github.com/actions/upload-artifact/pull/719)
- fix: update [@​actions/artifact](https://github.com/actions/artifact) for Node.js 24 punycode deprecation by [@​salmanmkc](https://github.com/salmanmkc) in [#​744](https://github.com/actions/upload-artifact/pull/744)
- prepare release v6.0.0 for Node.js 24 support by [@​salmanmkc](https://github.com/salmanmkc) in [#​745](https://github.com/actions/upload-artifact/pull/745)
**Full Changelog**: <https://github.com/actions/upload-artifact/compare/v5.0.0...v6.0.0>
### [`v6`](https://github.com/actions/upload-artifact/compare/v5.0.0...v6.0.0)
[Compare Source](https://github.com/actions/upload-artifact/compare/v5.0.0...v6.0.0)
### [`v5.0.0`](https://github.com/actions/upload-artifact/releases/tag/v5.0.0)
[Compare Source](https://github.com/actions/upload-artifact/compare/v5.0.0...v5.0.0)
##### What's Changed
**BREAKING CHANGE:** this update supports Node `v24.x`. This is not a breaking change per-se but we're treating it as such.
- Update README.md by [@​GhadimiR](https://github.com/GhadimiR) in [#​681](https://github.com/actions/upload-artifact/pull/681)
- Update README.md by [@​nebuk89](https://github.com/nebuk89) in [#​712](https://github.com/actions/upload-artifact/pull/712)
- Readme: spell out the first use of GHES by [@​danwkennedy](https://github.com/danwkennedy) in [#​727](https://github.com/actions/upload-artifact/pull/727)
- Update GHES guidance to include reference to Node 20 version by [@​patrikpolyak](https://github.com/patrikpolyak) in [#​725](https://github.com/actions/upload-artifact/pull/725)
- Bump `@actions/artifact` to `v4.0.0`
- Prepare `v5.0.0` by [@​danwkennedy](https://github.com/danwkennedy) in [#​734](https://github.com/actions/upload-artifact/pull/734)
##### New Contributors
- [@​GhadimiR](https://github.com/GhadimiR) made their first contribution in [#​681](https://github.com/actions/upload-artifact/pull/681)
- [@​nebuk89](https://github.com/nebuk89) made their first contribution in [#​712](https://github.com/actions/upload-artifact/pull/712)
- [@​danwkennedy](https://github.com/danwkennedy) made their first contribution in [#​727](https://github.com/actions/upload-artifact/pull/727)
- [@​patrikpolyak](https://github.com/patrikpolyak) made their first contribution in [#​725](https://github.com/actions/upload-artifact/pull/725)
**Full Changelog**: <https://github.com/actions/upload-artifact/compare/v4...v5.0.0>
### [`v5`](https://github.com/actions/upload-artifact/compare/v4.6.2...v5.0.0)
[Compare Source](https://github.com/actions/upload-artifact/compare/v4.6.2...v5.0.0)
### [`v4.6.2`](https://github.com/actions/upload-artifact/releases/tag/v4.6.2)
[Compare Source](https://github.com/actions/upload-artifact/compare/v4.6.1...v4.6.2)
##### What's Changed
- Update to use artifact 2.3.2 package & prepare for new upload-artifact release by [@​salmanmkc](https://github.com/salmanmkc) in [#​685](https://github.com/actions/upload-artifact/pull/685)
##### New Contributors
- [@​salmanmkc](https://github.com/salmanmkc) made their first contribution in [#​685](https://github.com/actions/upload-artifact/pull/685)
**Full Changelog**: <https://github.com/actions/upload-artifact/compare/v4...v4.6.2>
### [`v4.6.1`](https://github.com/actions/upload-artifact/releases/tag/v4.6.1)
[Compare Source](https://github.com/actions/upload-artifact/compare/v4.6.0...v4.6.1)
##### What's Changed
- Update to use artifact 2.2.2 package by [@​yacaovsnc](https://github.com/yacaovsnc) in [#​673](https://github.com/actions/upload-artifact/pull/673)
**Full Changelog**: <https://github.com/actions/upload-artifact/compare/v4...v4.6.1>
### [`v4.6.0`](https://github.com/actions/upload-artifact/releases/tag/v4.6.0)
[Compare Source](https://github.com/actions/upload-artifact/compare/v4.5.0...v4.6.0)
##### What's Changed
- Expose env vars to control concurrency and timeout by [@​yacaovsnc](https://github.com/yacaovsnc) in [#​662](https://github.com/actions/upload-artifact/pull/662)
**Full Changelog**: <https://github.com/actions/upload-artifact/compare/v4...v4.6.0>
### [`v4.5.0`](https://github.com/actions/upload-artifact/releases/tag/v4.5.0)
[Compare Source](https://github.com/actions/upload-artifact/compare/v4.4.3...v4.5.0)
##### What's Changed
- fix: deprecated `Node.js` version in action by [@​hamirmahal](https://github.com/hamirmahal) in [#​578](https://github.com/actions/upload-artifact/pull/578)
- Add new `artifact-digest` output by [@​bdehamer](https://github.com/bdehamer) in [#​656](https://github.com/actions/upload-artifact/pull/656)
##### New Contributors
- [@​hamirmahal](https://github.com/hamirmahal) made their first contribution in [#​578](https://github.com/actions/upload-artifact/pull/578)
- [@​bdehamer](https://github.com/bdehamer) made their first contribution in [#​656](https://github.com/actions/upload-artifact/pull/656)
**Full Changelog**: <https://github.com/actions/upload-artifact/compare/v4.4.3...v4.5.0>
### [`v4.4.3`](https://github.com/actions/upload-artifact/releases/tag/v4.4.3)
[Compare Source](https://github.com/actions/upload-artifact/compare/v4.4.2...v4.4.3)
##### What's Changed
- Undo indirect dependency updates from [#​627](https://github.com/actions/upload-artifact/issues/627) by [@​joshmgross](https://github.com/joshmgross) in [#​632](https://github.com/actions/upload-artifact/pull/632)
**Full Changelog**: <https://github.com/actions/upload-artifact/compare/v4.4.2...v4.4.3>
### [`v4.4.2`](https://github.com/actions/upload-artifact/releases/tag/v4.4.2)
[Compare Source](https://github.com/actions/upload-artifact/compare/v4.4.1...v4.4.2)
##### What's Changed
- Bump `@actions/artifact` to 2.1.11 by [@​robherley](https://github.com/robherley) in [#​627](https://github.com/actions/upload-artifact/pull/627)
- Includes fix for relative symlinks not resolving properly
**Full Changelog**: <https://github.com/actions/upload-artifact/compare/v4.4.1...v4.4.2>
### [`v4.4.1`](https://github.com/actions/upload-artifact/releases/tag/v4.4.1)
[Compare Source](https://github.com/actions/upload-artifact/compare/v4.4.0...v4.4.1)
##### What's Changed
- Add a section about hidden files by [@​joshmgross](https://github.com/joshmgross) in [#​607](https://github.com/actions/upload-artifact/pull/607)
- Add workflow file for publishing releases to immutable action package by [@​Jcambass](https://github.com/Jcambass) in [#​621](https://github.com/actions/upload-artifact/pull/621)
- Update [@​actions/artifact](https://github.com/actions/artifact) to latest version, includes symlink and timeout fixes by [@​robherley](https://github.com/robherley) in [#​625](https://github.com/actions/upload-artifact/pull/625)
##### New Contributors
- [@​Jcambass](https://github.com/Jcambass) made their first contribution in [#​621](https://github.com/actions/upload-artifact/pull/621)
**Full Changelog**: <https://github.com/actions/upload-artifact/compare/v4.4.0...v4.4.1>
### [`v4.4.0`](https://github.com/actions/upload-artifact/releases/tag/v4.4.0)
[Compare Source](https://github.com/actions/upload-artifact/compare/v4.3.6...v4.4.0)
##### Notice: Breaking Changes :warning:
We will no longer include hidden files and folders by default in the `upload-artifact` action of this version. This reduces the risk that credentials are accidentally uploaded into artifacts. Customers who need to continue to upload these files can use a new option, `include-hidden-files`, to continue to do so.
See ["Notice of upcoming deprecations and breaking changes in GitHub Actions runners"](https://github.blog/changelog/2024-08-19-notice-of-upcoming-deprecations-and-breaking-changes-in-github-actions-runners/) changelog and [this issue](https://github.com/actions/upload-artifact/issues/602) for more details.
##### What's Changed
- Exclude hidden files by default by [@​joshmgross](https://github.com/joshmgross) in [#​598](https://github.com/actions/upload-artifact/pull/598)
**Full Changelog**: <https://github.com/actions/upload-artifact/compare/v4.3.6...v4.4.0>
### [`v4.3.6`](https://github.com/actions/upload-artifact/releases/tag/v4.3.6)
[Compare Source](https://github.com/actions/upload-artifact/compare/v4.3.5...v4.3.6)
##### What's Changed
- Revert to [@​actions/artifact](https://github.com/actions/artifact) 2.1.8 by [@​robherley](https://github.com/robherley) in [#​594](https://github.com/actions/upload-artifact/pull/594)
**Full Changelog**: <https://github.com/actions/upload-artifact/compare/v4...v4.3.6>
### [`v4.3.5`](https://github.com/actions/upload-artifact/releases/tag/v4.3.5)
[Compare Source](https://github.com/actions/upload-artifact/compare/v4.3.4...v4.3.5)
##### What's Changed
- Bump [@​actions/artifact](https://github.com/actions/artifact) to v2.1.9 by [@​robherley](https://github.com/robherley) in [#​588](https://github.com/actions/upload-artifact/pull/588)
- Fixed artifact upload chunk timeout logic [#​1774](https://github.com/actions/toolkit/pull/1774)
- Use lazy stream to prevent issues with open file limits [#​1771](https://github.com/actions/toolkit/pull/1771)
**Full Changelog**: <https://github.com/actions/upload-artifact/compare/v4.3.4...v4.3.5>
### [`v4.3.4`](https://github.com/actions/upload-artifact/releases/tag/v4.3.4)
[Compare Source](https://github.com/actions/upload-artifact/compare/v4.3.3...v4.3.4)
##### What's Changed
- Update [@​actions/artifact](https://github.com/actions/artifact) version, bump dependencies by [@​robherley](https://github.com/robherley) in [#​584](https://github.com/actions/upload-artifact/pull/584)
**Full Changelog**: <https://github.com/actions/upload-artifact/compare/v4.3.3...v4.3.4>
### [`v4.3.3`](https://github.com/actions/upload-artifact/releases/tag/v4.3.3)
[Compare Source](https://github.com/actions/upload-artifact/compare/v4.3.2...v4.3.3)
##### What's Changed
- updating `@actions/artifact` dependency to v2.1.6 by [@​eggyhead](https://github.com/eggyhead) in [#​565](https://github.com/actions/upload-artifact/pull/565)
**Full Changelog**: <https://github.com/actions/upload-artifact/compare/v4.3.2...v4.3.3>
### [`v4.3.2`](https://github.com/actions/upload-artifact/releases/tag/v4.3.2)
[Compare Source](https://github.com/actions/upload-artifact/compare/v4.3.1...v4.3.2)
##### What's Changed
- Update release-new-action-version.yml by [@​konradpabjan](https://github.com/konradpabjan) in [#​516](https://github.com/actions/upload-artifact/pull/516)
- Minor fix to the migration readme by [@​andrewakim](https://github.com/andrewakim) in [#​523](https://github.com/actions/upload-artifact/pull/523)
- Update readme with v3/v2/v1 deprecation notice by [@​robherley](https://github.com/robherley) in [#​561](https://github.com/actions/upload-artifact/pull/561)
- updating `@actions/artifact` dependency to v2.1.5 and `@actions/core` to v1.0.1 by [@​eggyhead](https://github.com/eggyhead) in [#​562](https://github.com/actions/upload-artifact/pull/562)
##### New Contributors
- [@​andrewakim](https://github.com/andrewakim) made their first contribution in [#​523](https://github.com/actions/upload-artifact/pull/523)
**Full Changelog**: <https://github.com/actions/upload-artifact/compare/v4.3.1...v4.3.2>
### [`v4.3.1`](https://github.com/actions/upload-artifact/releases/tag/v4.3.1)
[Compare Source](https://github.com/actions/upload-artifact/compare/v4.3.0...v4.3.1)
- Bump [@​actions/artifacts](https://github.com/actions/artifacts) to latest version to include [updated GHES host check](https://github.com/actions/toolkit/pull/1648)
### [`v4.3.0`](https://github.com/actions/upload-artifact/releases/tag/v4.3.0)
[Compare Source](https://github.com/actions/upload-artifact/compare/v4.2.0...v4.3.0)
##### What's Changed
- Reorganize upload code in prep for merge logic & add more tests by [@​robherley](https://github.com/robherley) in [#​504](https://github.com/actions/upload-artifact/pull/504)
- Add sub-action to merge artifacts by [@​robherley](https://github.com/robherley) in [#​505](https://github.com/actions/upload-artifact/pull/505)
**Full Changelog**: <https://github.com/actions/upload-artifact/compare/v4...v4.3.0>
### [`v4.2.0`](https://github.com/actions/upload-artifact/releases/tag/v4.2.0)
[Compare Source](https://github.com/actions/upload-artifact/compare/v4.1.0...v4.2.0)
##### What's Changed
- Ability to overwrite an Artifact by [@​robherley](https://github.com/robherley) in [#​501](https://github.com/actions/upload-artifact/pull/501)
**Full Changelog**: <https://github.com/actions/upload-artifact/compare/v4...v4.2.0>
### [`v4.1.0`](https://github.com/actions/upload-artifact/releases/tag/v4.1.0)
[Compare Source](https://github.com/actions/upload-artifact/compare/v4...v4.1.0)
##### What's Changed
- Add migrations docs by [@​robherley](https://github.com/robherley) in [#​482](https://github.com/actions/upload-artifact/pull/482)
- Update README.md by [@​samuelwine](https://github.com/samuelwine) in [#​492](https://github.com/actions/upload-artifact/pull/492)
- Support artifact-url output by [@​konradpabjan](https://github.com/konradpabjan) in [#​496](https://github.com/actions/upload-artifact/pull/496)
- Update readme to reflect new 500 artifact per job limit by [@​robherley](https://github.com/robherley) in [#​497](https://github.com/actions/upload-artifact/pull/497)
##### New Contributors
- [@​samuelwine](https://github.com/samuelwine) made their first contribution in [#​492](https://github.com/actions/upload-artifact/pull/492)
**Full Changelog**: <https://github.com/actions/upload-artifact/compare/v4...v4.1.0>
### [`v4.0.0`](https://github.com/actions/upload-artifact/releases/tag/v4.0.0)
[Compare Source](https://github.com/actions/upload-artifact/compare/v4...v4)
##### What's Changed
The release of upload-artifact\@​v4 and download-artifact\@​v4 are major changes to the backend architecture of Artifacts. They have numerous performance and behavioral improvements.
ℹ️ However, this is a major update that includes breaking changes. Artifacts created with versions v3 and below are not compatible with the v4 actions. Uploads and downloads *must* use the same major actions versions. There are also key differences from previous versions that may require updates to your workflows.
For more information, please see:
1. The [changelog](https://github.blog/changelog/2023-12-14-github-actions-artifacts-v4-is-now-generally-available/) post.
2. The [README](https://github.com/actions/upload-artifact/blob/main/README.md).
3. The [migration documentation](https://github.com/actions/upload-artifact/blob/main/docs/MIGRATION.md).
4. As well as the underlying npm package, [@​actions/artifact](https://github.com/actions/toolkit/tree/main/packages/artifact) documentation.
##### New Contributors
- [@​vmjoseph](https://github.com/vmjoseph) made their first contribution in [#​464](https://github.com/actions/upload-artifact/pull/464)
**Full Changelog**: <https://github.com/actions/upload-artifact/compare/v3...v4.0.0>
### [`v4`](https://github.com/actions/upload-artifact/compare/v3.2.2...v4)
[Compare Source](https://github.com/actions/upload-artifact/compare/v3.2.2...v4)
### [`v3.2.2`](https://github.com/actions/upload-artifact/releases/tag/v3.2.2)
[Compare Source](https://github.com/actions/upload-artifact/compare/v3.2.1...v3.2.2)
##### v3.2.2 - What's new
> \[!Important]
> actions/upload-artifact\@​v3.2.2 now runs on Node.js 24 (runs.using: node24) and requires a minimum Actions Runner version of `2.327.1`. If you are using self-hosted runners, ensure they are updated before upgrading.
>
> **This is a backport security updates release for GHES users. This version is deprecated on github.com and should not be used!**
##### Node.js 24
This release updates the runtime to Node.js 24. The previous v3.2.1 ran on Node.js 16, which has reached end-of-life. Now this action will run on Node.js 24.
Pin your workflows to: <https://github.com/actions/upload-artifact/releases/tag/v3.2.2-node20> which is available if you're still in the process of phasing out Node 20.
##### What's Changed
- Upgrade [@​actions/artifact](https://github.com/actions/artifact) to 1.1.3 by [@​Link-](https://github.com/Link-)
- Security updates for direct and transitive dependencies
- Use node20 by [@​robherley](https://github.com/robherley) in [#​606](https://github.com/actions/upload-artifact/issues/606)
- Ensure hidden files input is used by [@​joshmgross](https://github.com/joshmgross) in [#​608](https://github.com/actions/upload-artifact/issues/608)
- Upgrade the actions used in workflows by [@​Link-](https://github.com/Link-)
**Full Changelog**: <https://github.com/actions/upload-artifact/compare/v3.2.1...v3.2.2>
### [`v3.2.1`](https://github.com/actions/upload-artifact/releases/tag/v3.2.1)
[Compare Source](https://github.com/actions/upload-artifact/compare/v3.2.0...v3.2.1)
##### What's Changed
This fixes the `include-hidden-files` input introduced in <https://github.com/actions/upload-artifact/releases/tag/v3.2.0>
- Ensure hidden files input is used by [@​joshmgross](https://github.com/joshmgross) in [#​609](https://github.com/actions/upload-artifact/pull/609)
**Full Changelog**: <https://github.com/actions/upload-artifact/compare/v3.2.0...v3.2.1>
### [`v3.2.0`](https://github.com/actions/upload-artifact/releases/tag/v3.2.0)
[Compare Source](https://github.com/actions/upload-artifact/compare/v3.1.3...v3.2.0)
##### Notice: Breaking Changes :warning:
We will no longer include hidden files and folders by default in the `upload-artifact` action of this version. This reduces the risk that credentials are accidentally uploaded into artifacts. Customers who need to continue to upload these files can use a new option, `include-hidden-files`, to continue to do so.
See ["Notice of upcoming deprecations and breaking changes in GitHub Actions runners"](https://github.blog/changelog/2024-08-19-notice-of-upcoming-deprecations-and-breaking-changes-in-github-actions-runners/) changelog and [this issue](https://github.com/actions/upload-artifact/issues/602) for more details.
##### What's Changed
- V3 backport: Exclude hidden files by default by [@​SrRyan](https://github.com/SrRyan) in [#​604](https://github.com/actions/upload-artifact/pull/604)
**Full Changelog**: <https://github.com/actions/upload-artifact/compare/v3.1.3...v3.2.0>
### [`v3.1.3`](https://github.com/actions/upload-artifact/releases/tag/v3.1.3)
[Compare Source](https://github.com/actions/upload-artifact/compare/v3.1.2...v3.1.3)
##### What's Changed
- chore(github): remove trailing whitespaces by [@​ljmf00](https://github.com/ljmf00) in [#​313](https://github.com/actions/upload-artifact/pull/313)
- Bump [@​actions/artifact](https://github.com/actions/artifact) version to v1.1.2 by [@​bethanyj28](https://github.com/bethanyj28) in [#​436](https://github.com/actions/upload-artifact/pull/436)
**Full Changelog**: <https://github.com/actions/upload-artifact/compare/v3...v3.1.3>
### [`v3.1.2`](https://github.com/actions/upload-artifact/releases/tag/v3.1.2)
[Compare Source](https://github.com/actions/upload-artifact/compare/v3.1.1...v3.1.2)
- Update all `@actions/*` NPM packages to their latest versions- [#​374](https://github.com/actions/upload-artifact/issues/374)
- Update all dev dependencies to their most recent versions - [#​375](https://github.com/actions/upload-artifact/issues/375)
### [`v3.1.1`](https://github.com/actions/upload-artifact/releases/tag/v3.1.1)
[Compare Source](https://github.com/actions/upload-artifact/compare/v3.1.0...v3.1.1)
- Update actions/core package to latest version to remove `set-output` deprecation warning [#​351](https://github.com/actions/upload-artifact/issues/351)
### [`v3.1.0`](https://github.com/actions/upload-artifact/releases/tag/v3.1.0)
[Compare Source](https://github.com/actions/upload-artifact/compare/v3...v3.1.0)
##### What's Changed
- Bump [@​actions/artifact](https://github.com/actions/artifact) to v1.1.0 ([#​327](https://github.com/actions/upload-artifact/pull/327))
- Adds checksum headers on artifact upload ([actions/toolkit#1095](https://github.com/actions/toolkit/pull/1095)) ([actions/toolkit#1063](https://github.com/actions/toolkit/pull/1063))
</details>
---
### Configuration
📅 **Schedule**: (UTC)
- Branch creation
- At any time (no schedule defined)
- Automerge
- At any time (no schedule defined)
🚦 **Automerge**: Disabled by config. Please merge this manually once you are satisfied.
♻ **Rebasing**: Whenever PR becomes conflicted, or you tick the rebase/retry checkbox.
👻 **Immortal**: This PR will be recreated if closed unmerged. Get [config help](https://github.com/renovatebot/renovate/discussions) if that's undesired.
---
- [ ] <!-- rebase-check -->If you want to rebase/retry this PR, check this box
---
This PR has been generated by [Mend Renovate](https://github.com/renovatebot/renovate).
<!--renovate-debug:eyJjcmVhdGVkSW5WZXIiOiI0My4zOS4yIiwidXBkYXRlZEluVmVyIjoiNDMuMTc3LjkiLCJ0YXJnZXRCcmFuY2giOiJtYWluIiwibGFiZWxzIjpbXX0=-->
Blocking a user prevents them from interacting with repositories, such as opening or commenting on pull requests or issues. Learn more about blocking a user.
This PR contains the following updates:
v3→v8v3→v7Release Notes
actions/download-artifact (actions/download-artifact)
v8.0.1Compare Source
What's Changed
Full Changelog: https://github.com/actions/download-artifact/compare/v8...v8.0.1
v8.0.0Compare Source
v8 - What's new
Direct downloads
To support direct uploads in
actions/upload-artifact, the action will no longer attempt to unzip all downloaded files. Instead, the action checks theContent-Typeheader ahead of unzipping and skips non-zipped files. Callers wishing to download a zipped file as-is can also set the newskip-decompressparameter totrue.Enforced checks (breaking)
A previous release introduced digest checks on the download. If a download hash didn't match the expected hash from the server, the action would log a warning. Callers can now configure the behavior on mismatch with the
digest-mismatchparameter. To be secure by default, we are now defaulting the behavior toerrorwhich will fail the workflow run.ESM
To support new versions of the @actions/* packages, we've upgraded the package to ESM.
What's Changed
errorby @danwkennedy in #461Full Changelog: https://github.com/actions/download-artifact/compare/v7...v8.0.0
v8Compare Source
v7.0.0Compare Source
v7 - What's new
Node.js 24
This release updates the runtime to Node.js 24. v6 had preliminary support for Node 24, however this action was by default still running on Node.js 20. Now this action by default will run on Node.js 24.
What's Changed
New Contributors
Full Changelog: https://github.com/actions/download-artifact/compare/v6.0.0...v7.0.0
v7Compare Source
v6.0.0Compare Source
What's Changed
BREAKING CHANGE: this update supports Node
v24.x. This is not a breaking change per-se but we're treating it as such.@actions/artifacttov4.0.0v6.0.0by @danwkennedy in #438New Contributors
Full Changelog: https://github.com/actions/download-artifact/compare/v5...v6.0.0
v6Compare Source
v5.0.0Compare Source
What's Changed
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:
name: my-artifact→ extracted topath/(direct)artifact-ids: 12345→ extracted topath/my-artifact/(nested)Now both methods are consistent:
name: my-artifact→ extracted topath/(unchanged)artifact-ids: 12345→ extracted topath/(fixed - now direct)Migration Guide
✅ No Action Needed If:
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):
To maintain old behavior (if needed):
New Contributors
Full Changelog: https://github.com/actions/download-artifact/compare/v4...v5.0.0
v5Compare Source
v4.3.0Compare Source
What's Changed
artifact-idsinput by @GrantBirki in #401New Contributors
Full Changelog: https://github.com/actions/download-artifact/compare/v4.2.1...v4.3.0
v4.2.1Compare Source
What's Changed
Full Changelog: https://github.com/actions/download-artifact/compare/v4.2.0...v4.2.1
v4.2.0Compare Source
What's Changed
New Contributors
Full Changelog: https://github.com/actions/download-artifact/compare/v4.1.9...v4.2.0
v4.1.9Compare Source
What's Changed
New Contributors
Full Changelog: https://github.com/actions/download-artifact/compare/v4.1.8...v4.1.9
v4.1.8Compare Source
What's Changed
Full Changelog: https://github.com/actions/download-artifact/compare/v4.1.7...v4.1.8
v4.1.7Compare Source
What's Changed
Full Changelog: https://github.com/actions/download-artifact/compare/v4.1.6...v4.1.7
v4.1.6Compare Source
What's Changed
@actions/artifactdependency to v2.1.6 by @eggyhead in #324Full Changelog: https://github.com/actions/download-artifact/compare/v4.1.5...v4.1.6
v4.1.5Compare Source
What's Changed
@actions/coreto v1.10.1 and@actions/artifactto v2.1.5Full Changelog: https://github.com/actions/download-artifact/compare/v4.1.4...v4.1.5
v4.1.4Compare Source
What's Changed
Full Changelog: https://github.com/actions/download-artifact/compare/v4...v4.1.4
v4.1.3Compare Source
What's Changed
New Contributors
Full Changelog: https://github.com/actions/download-artifact/compare/v4...v4.1.3
v4.1.2Compare Source
v4.1.1Compare Source
@actions/artifactsto latest versionv4.1.0Compare Source
What's Changed
New Contributors
Full Changelog: https://github.com/actions/download-artifact/compare/v4...v4.1.0
v4.0.0Compare Source
What's Changed
The release of upload-artifact@v4 and download-artifact@v4 are major changes to the backend architecture of Artifacts. They have numerous performance and behavioral improvements.
ℹ️ However, this is a major update that includes breaking changes. Artifacts created with versions v3 and below are not compatible with the v4 actions. Uploads and downloads must use the same major actions versions. There are also key differences from previous versions that may require updates to your workflows.
For more information, please see:
Breaking Changes
action/upload-artifact@v3and below are not supported.For assistance with breaking changes, see MIGRATION.md.
Improvements
New Contributors
Full Changelog: https://github.com/actions/download-artifact/compare/v3...v4.0.0
v4Compare Source
v3.1.0Compare Source
v3.1.0 - What's new
Node.js 24
This release updates the runtime to Node.js 24. The previous v3.0.2 ran on Node.js 16, which has reached end-of-life. Now this action will run on Node.js 24.
Pin your workflows to: https://github.com/actions/download-artifact/releases/tag/v3.1.0-node20 which is available if you're still in the process of phasing out Node 20.
What's Changed
Full Changelog: https://github.com/actions/download-artifact/compare/v3.0.2...v3.1.0-node20
v3.0.2Compare Source
@actions/artifactto v1.1.1 - #195v3.0.1Compare Source
actions/upload-artifact (actions/upload-artifact)
v7.0.1Compare Source
What's Changed
Full Changelog: https://github.com/actions/upload-artifact/compare/v7...v7.0.1
v7.0.0Compare Source
v7 What's new
Direct Uploads
Adds support for uploading single files directly (unzipped). Callers can set the new
archiveparameter tofalseto skip zipping the file during upload. Right now, we only support single files. The action will fail if the glob passed resolves to multiple files. Thenameparameter is also ignored with this setting. Instead, the name of the artifact will be the name of the uploaded file.ESM
To support new versions of the
@actions/*packages, we've upgraded the package to ESM.What's Changed
New Contributors
Full Changelog: https://github.com/actions/upload-artifact/compare/v6...v7.0.0
v7Compare Source
v6.0.0Compare Source
v6 - What's new
Node.js 24
This release updates the runtime to Node.js 24. v5 had preliminary support for Node.js 24, however this action was by default still running on Node.js 20. Now this action by default will run on Node.js 24.
What's Changed
Full Changelog: https://github.com/actions/upload-artifact/compare/v5.0.0...v6.0.0
v6Compare Source
v5.0.0Compare Source
What's Changed
BREAKING CHANGE: this update supports Node
v24.x. This is not a breaking change per-se but we're treating it as such.@actions/artifacttov4.0.0v5.0.0by @danwkennedy in #734New Contributors
Full Changelog: https://github.com/actions/upload-artifact/compare/v4...v5.0.0
v5Compare Source
v4.6.2Compare Source
What's Changed
New Contributors
Full Changelog: https://github.com/actions/upload-artifact/compare/v4...v4.6.2
v4.6.1Compare Source
What's Changed
Full Changelog: https://github.com/actions/upload-artifact/compare/v4...v4.6.1
v4.6.0Compare Source
What's Changed
Full Changelog: https://github.com/actions/upload-artifact/compare/v4...v4.6.0
v4.5.0Compare Source
What's Changed
Node.jsversion in action by @hamirmahal in #578artifact-digestoutput by @bdehamer in #656New Contributors
Full Changelog: https://github.com/actions/upload-artifact/compare/v4.4.3...v4.5.0
v4.4.3Compare Source
What's Changed
Full Changelog: https://github.com/actions/upload-artifact/compare/v4.4.2...v4.4.3
v4.4.2Compare Source
What's Changed
@actions/artifactto 2.1.11 by @robherley in #627Full Changelog: https://github.com/actions/upload-artifact/compare/v4.4.1...v4.4.2
v4.4.1Compare Source
What's Changed
New Contributors
Full Changelog: https://github.com/actions/upload-artifact/compare/v4.4.0...v4.4.1
v4.4.0Compare Source
Notice: Breaking Changes ⚠️
We will no longer include hidden files and folders by default in the
upload-artifactaction of this version. This reduces the risk that credentials are accidentally uploaded into artifacts. Customers who need to continue to upload these files can use a new option,include-hidden-files, to continue to do so.See "Notice of upcoming deprecations and breaking changes in GitHub Actions runners" changelog and this issue for more details.
What's Changed
Full Changelog: https://github.com/actions/upload-artifact/compare/v4.3.6...v4.4.0
v4.3.6Compare Source
What's Changed
Full Changelog: https://github.com/actions/upload-artifact/compare/v4...v4.3.6
v4.3.5Compare Source
What's Changed
Full Changelog: https://github.com/actions/upload-artifact/compare/v4.3.4...v4.3.5
v4.3.4Compare Source
What's Changed
Full Changelog: https://github.com/actions/upload-artifact/compare/v4.3.3...v4.3.4
v4.3.3Compare Source
What's Changed
@actions/artifactdependency to v2.1.6 by @eggyhead in #565Full Changelog: https://github.com/actions/upload-artifact/compare/v4.3.2...v4.3.3
v4.3.2Compare Source
What's Changed
@actions/artifactdependency to v2.1.5 and@actions/coreto v1.0.1 by @eggyhead in #562New Contributors
Full Changelog: https://github.com/actions/upload-artifact/compare/v4.3.1...v4.3.2
v4.3.1Compare Source
v4.3.0Compare Source
What's Changed
Full Changelog: https://github.com/actions/upload-artifact/compare/v4...v4.3.0
v4.2.0Compare Source
What's Changed
Full Changelog: https://github.com/actions/upload-artifact/compare/v4...v4.2.0
v4.1.0Compare Source
What's Changed
New Contributors
Full Changelog: https://github.com/actions/upload-artifact/compare/v4...v4.1.0
v4.0.0Compare Source
What's Changed
The release of upload-artifact@v4 and download-artifact@v4 are major changes to the backend architecture of Artifacts. They have numerous performance and behavioral improvements.
ℹ️ However, this is a major update that includes breaking changes. Artifacts created with versions v3 and below are not compatible with the v4 actions. Uploads and downloads must use the same major actions versions. There are also key differences from previous versions that may require updates to your workflows.
For more information, please see:
New Contributors
Full Changelog: https://github.com/actions/upload-artifact/compare/v3...v4.0.0
v4Compare Source
v3.2.2Compare Source
v3.2.2 - What's new
Node.js 24
This release updates the runtime to Node.js 24. The previous v3.2.1 ran on Node.js 16, which has reached end-of-life. Now this action will run on Node.js 24.
Pin your workflows to: https://github.com/actions/upload-artifact/releases/tag/v3.2.2-node20 which is available if you're still in the process of phasing out Node 20.
What's Changed
Full Changelog: https://github.com/actions/upload-artifact/compare/v3.2.1...v3.2.2
v3.2.1Compare Source
What's Changed
This fixes the
include-hidden-filesinput introduced in https://github.com/actions/upload-artifact/releases/tag/v3.2.0Full Changelog: https://github.com/actions/upload-artifact/compare/v3.2.0...v3.2.1
v3.2.0Compare Source
Notice: Breaking Changes ⚠️
We will no longer include hidden files and folders by default in the
upload-artifactaction of this version. This reduces the risk that credentials are accidentally uploaded into artifacts. Customers who need to continue to upload these files can use a new option,include-hidden-files, to continue to do so.See "Notice of upcoming deprecations and breaking changes in GitHub Actions runners" changelog and this issue for more details.
What's Changed
Full Changelog: https://github.com/actions/upload-artifact/compare/v3.1.3...v3.2.0
v3.1.3Compare Source
What's Changed
Full Changelog: https://github.com/actions/upload-artifact/compare/v3...v3.1.3
v3.1.2Compare Source
@actions/*NPM packages to their latest versions- #374v3.1.1Compare Source
set-outputdeprecation warning #351v3.1.0Compare Source
What's Changed
Configuration
📅 Schedule: (UTC)
🚦 Automerge: Disabled by config. Please merge this manually once you are satisfied.
♻ Rebasing: Whenever PR becomes conflicted, or you tick the rebase/retry checkbox.
👻 Immortal: This PR will be recreated if closed unmerged. Get config help if that's undesired.
This PR has been generated by Mend Renovate.
9e338b2aafto9529a0b588chore(deps): update github artifact actions (major)to chore(deps): update github artifact actions (major) - autoclosedPull request closed