@actions/upload-artifact: GitHub Actions artifact uploader
Store workflow files as versioned zip artifacts.
Learn more about upload-artifact
@actions/upload-artifact is a GitHub Actions action that uploads files and directories as artifacts during workflow execution. It is powered by the @actions/artifact package and integrates with GitHub's artifact storage system. The action supports wildcard patterns, multiple paths with exclusions, configurable compression levels, and retention periods. Artifacts are stored as immutable zip archives and become immediately available via the GitHub UI and REST API upon upload completion.
Immutable Artifact Archives
Uploaded artifacts are stored as read-only archives that cannot be modified by subsequent jobs. Prevents race conditions and accidental corruption when multiple workflow jobs interact with the same artifact namespace.
Immediate Artifact Availability
Artifacts receive unique IDs and appear in the GitHub UI and REST API instantly after upload completes. No need to wait for the entire workflow run to finish before accessing or downloading artifacts.
Configurable Compression Levels
Manually adjust compression settings to optimize for upload speed or storage efficiency. Enables fine-tuning based on artifact size, network conditions, and workflow performance requirements.
name: Upload Build Artifacts
on: [push]
jobs:
build:
runs-on: ubuntu-latest
steps:
- uses: actions/checkout@v4
- run: npm run build
- uses: actions/upload-artifact@v4
with:
name: build-output
path: dist/Requires Node v24.x runtime; workflows on older runners will fail until updated.
- –Upgrade GitHub Actions runner to support Node v24.x before adopting this version.
- –Bump to @actions/artifact v4.0.0 internally; no user-facing API changes documented.
Maintenance release updating internal artifact package to 2.3.2; no user-facing changes documented.
- –Release notes do not specify breaking changes, new requirements, or migration steps.
- –Update appears limited to internal dependency bump with no documented behavior or API changes.
Updates internal artifact package to 2.2.2; release notes do not specify breaking changes, new requirements, or user-facing impact.
- –Review your workflows if you rely on artifact upload behavior, as the underlying package changed.
- –No migration steps or configuration changes are documented in the release notes.
Top in Cloud & DevOps
Related Repositories
Discover similar tools and frameworks used by developers
checkout
Clones repositories to workflows with configurable authentication and fetch depth.
compose
YAML-defined container lifecycle management and orchestration tool.
awx
Django-based control plane for centralized Ansible management.
OpenLens
Community-built Kubernetes IDE without authentication requirements.
renovate
Automated dependency updates via pull requests across 90+ package managers.