GitHub Action that creates the release ZIP of a WordPress plugin or theme using @wpelevator/wp-release. It's named after the wp-release zip command that it runs.
The ZIP has a {slug}/ root folder, which WordPress.org, plugin updates and WordPress Playground require, and leaves out everything that .distignore lists. The optional exclude-gitattributes: true input also honors Git export-ignore attributes, including nested .gitattributes files. It's reproducible: entries are sorted and use a fixed timestamp and file mode, so the same files and deterministic metadata give the same ZIP. Embedded minisign signatures include a signing timestamp, and custom codec callbacks control their own encoded bytes. It needs no zip or rsync and works on any runner.
Use true or false for boolean inputs; the action validates these values before running the command.
These actions require a runner with the Node.js 24 action runtime. Keep self-hosted runners updated before using them.
Pin uses: to the latest released version from the releases page. Upgrades are intentionally manual: floating major or minor tags are not published.
jobs:
release:
runs-on: ubuntu-24.04
permissions:
contents: write
steps:
- uses: actions/checkout@v7
- run: npm ci && npm run build
- id: zip
uses: wpelevator/wp-release-zip@0.6.0
with:
source-dir: dist
sign: true
sign-checksums: true
signing-key: ${{ secrets.WP_RELEASE_SIGNING_KEY }}
- uses: softprops/action-gh-release@v3
with:
files: |
${{ steps.zip.outputs.zip-path }}
${{ steps.zip.outputs.checksums-path }}
${{ steps.zip.outputs.signatures }}In a repository with a wp-release.config.js, zip a package with the files config of its package group, the same files that its deploys ship:
- id: zip
uses: wpelevator/wp-release-zip@0.6.0
with:
package: plugins/my-plugin
# config: release/custom.mjs # Optional custom release config.
checksums: trueSet sign: true to sign only the ZIP. Set sign-checksums: true to generate and sign the manifest; it implies checksums: true and does not sign the ZIP. Use both to sign both artifacts. sign-format: wordpress,minisign,ssh selects formats for requested signatures and requires ZIP or manifest signing through inputs or configuration; it does not enable signing. The signing-key input overrides WP_RELEASE_SIGNING_KEY and is masked in the logs. The key, formats and existing signature destinations are validated before the ZIP or manifest is written. These explicit targets replace the former behavior where sign also signed a manifest and sign-format implied signing.
Pass zip-path to wp-release-deploy-svn as from-zip to deploy to WordPress.org exactly the files of the release asset, or use wp-release-sign to sign files separately.
The action itself needs only contents: read for checkout. This example grants contents: write because softprops/action-gh-release uploads assets to a GitHub release; jobs that only create ZIPs should use contents: read.
- id: zip
uses: wpelevator/wp-release-zip@0.6.0
with:
source-dir: dist
checksums-file: checksums.json
embed-checksums: true
sign-checksums: true
sign: true
signing-key: ${{ secrets.WP_RELEASE_SIGNING_KEY }}Upload zip-path and signatures as release assets. checksums-path is empty here; checksums-embedded and signatures-embedded name entries inside the package and are not local files. Verify the archive with npx wp-release verify --zip <zip-path> --checksums-file checksums.json --public-key "$PUBLIC_KEY", using a trusted key distributed outside the ZIP.
For a GNU manifest, set checksums-format: sha256sum, checksums-file: SHA256SUMS, checksums-algorithms: sha256 and sign-format: minisign, then verify with --checksums-format sha256sum --signature-format minisign. Custom codecs require a trusted JavaScript config supplied through config.
| Input | Default | Description |
|---|---|---|
package |
Package of wp-release.config.js, by identifier or path under the configured root like plugins/my-plugin, to zip its directory with the files config of its package group, the same files that its deploys ship. The slug defaults to the directory name, so the slug input is ignored, and source-dir and the file selection inputs can't be combined with it. |
|
config |
conventional config in the repository root | JavaScript release config path for package selection and integrity settings, passed as --config. |
source-dir |
. |
Directory to archive. |
slug |
repository name | Plugin or theme slug. |
version |
Version header |
Version for the ZIP and its filename. |
filename-format |
{slug}.{version} |
Filename with {slug} and {version}. |
output |
the filename in the repository root | Path of the ZIP. |
distignore |
.distignore in source-dir when present |
Path to the ignore file, or false to not read one. |
exclude |
Extra gitignore-style patterns separated by commas or new lines, like build/,assets/*,images/**/*. They're applied after the ignore file, so a ! pattern can re-include a file. |
|
exclude-gitattributes |
false |
Also exclude paths marked export-ignore by Git attributes. Requires source-dir to be inside a Git repository. |
root-folder |
slug |
Folder inside the ZIP, or false to put the files at the ZIP root. |
checksums |
false |
Generate the checksums manifest of the archived files next to the ZIP, with .checksums.json instead of .zip by default; checksums-file, codec selection and embedding can change its name or location. |
checksums-file |
integrity.file, else versioned JSON filename or codec default |
Relative manifest filename independent of the ZIP name; implies checksums. Resolves beside the ZIP or inside its package root when embedded. Nested paths are allowed; absolute paths and dot segments are rejected. |
checksums-format |
integrity.codec, else wordpress-json |
wordpress-json or sha256sum; the latter defaults to SHA256SUMS. |
checksums-algorithms |
integrity.algorithms, else md5,sha256 |
Comma-separated digest fields, replacing configured fields. sha256sum requires SHA-256. |
embed-checksums |
integrity.embed, else false |
Generate the manifest inside the ZIP instead of beside it; implies checksums. Explicit false disables configured embedding. |
sign |
false |
Sign only the ZIP, writing a WordPress .sig next to it. |
sign-checksums |
integrity.sign, else false |
Generate and sign the manifest; implies checksums. Explicit false disables configured manifest signing. |
sign-format |
integrity.sign.formats, else wordpress |
Comma-separated signature formats: wordpress (.sig), minisign (.minisig), ssh (.sshsig). Requires ZIP or manifest signing through inputs or configuration; does not enable signing. |
signing-key |
WP_RELEASE_SIGNING_KEY env var |
Base64 32-byte Ed25519 seed or 64-byte libsodium secret key. Pass it from a secret. Setting the key alone does not enable signing. |
force |
false |
Overwrite existing ZIP, manifest and signature files. |
A ZIP or manifest written inside source-dir, and their .sig, .minisig and .sshsig signatures, are never archived. Use embed-checksums: true to generate a manifest and its requested signatures inside the ZIP without changing the source directory. For a manifest also shipped through a source-directory SVN deploy or published as a separate asset, use the separate checksum and signing steps.
| Output | Description |
|---|---|
zip-path |
Absolute path of the ZIP. |
checksums-path |
Absolute path of the external manifest; empty when disabled or embedded. |
files |
Number of archived files. |
signatures |
Absolute paths of external signatures, one per line, suitable for asset uploads; excludes embedded signatures. |
checksums-embedded |
Package-relative manifest path inside the ZIP; empty without embedding. |
signatures-embedded |
Package-relative signature paths inside the ZIP, one per line; empty without embedded manifest signing. |
public-key |
Base64 public key of the signing key; empty without signing. |
Each run adds a section to the job summary of the run with the ZIP, its number of files and the checksums manifest, when manifest generation is enabled by inputs or integrity configuration. Embedded manifests are shown by their package-relative paths. Signing also adds the signature files and the public key in each selected format. A failed run adds its error instead, and the run fails. The paths are relative to the workspace.
When you can't use a GitHub Action, such as on another CI system or in a local release script, add the same tooling as a development dependency and run the CLI command that the action runs, passing the signing key through the WP_RELEASE_SIGNING_KEY environment variable:
npm install --save-dev @wpelevator/wp-release
npx wp-release zip dist --sign --sign-checksumsThe inputs map to the flags of wp-release zip: source-dir is the first argument, package, config, filename-format, output, distignore, exclude, exclude-gitattributes, checksums, checksums-file, checksums-format, checksums-algorithms, sign, sign-checksums, sign-format and force keep their names, root-folder: false is --no-root-folder and distignore: false is --no-distignore. embed-checksums and sign-checksums map explicit false to their --no- flags; omitting them preserves integrity configuration. Add --json to read the paths of the ZIP and the manifest from the output. The CLI needs Node.js 22.12 or later, and has no other dependencies on the runner. Run npx wp-release zip --help for all options.
src/run.ts reads the inputs with @actions/core, maps them to the arguments of the wp-release zip command and runs it through the execute() function of @wpelevator/wp-release, so the action and the CLI always behave the same. The action runs dist/index.js, a single file bundled with esbuild that includes wp-release and all other dependencies, so nothing is installed from npm when the action runs. The tooling version is fixed by the action ref you pin.
The source is TypeScript in src/. dist/ is git-ignored in the monorepo. npm run build bundles the @wpelevator/wp-release dependency at the version that the action's package.json pins. The dependents policy of the monorepo release configuration re-releases the actions whenever a later version falls outside their pins and rewrites them, so they don't need a manual update. A pin that drifts from the published version, like a deliberate pin to an older release, selects a registry install instead, and changeset status warns until the pin resolves the package again. The split-push workflow commits the bundle to the action's release repository. npm test runs the input mapping and action execution tests with Node.js type stripping, and npm run lint runs ESLint and a tsc type check.
npm run build --workspace @wpelevator/wp-release-zip-action