[11.1] Release `11.1.1`
These are the instructions for releasing 11.1.1, scheduled for 2026-09-18.
Perform all the steps below in order. When running any GitHub workflow, ensure you do it from the trunk branch (the default) and input the release version or branch as indicated.
Keep the Release Troubleshooting & Recovery guide handy, in case you encounter any issues.
1. Go/no-go
For scheduled stable releases, hold this 24-48 hours before the release date, with the Product DRI (named on the parent tracking issue). Bring in QualityOps and the Atomic contact when staging or monitoring left open questions. See the readiness guide for details.
- The readiness review is complete and its verdicts still hold.
- No new blocking findings since the readiness review (check
#woo-core-releasesthreads and the newest issues). - Decision recorded as a comment on this issue - go, no-go, or go with conditions - with the names behind it.
For scheduled releases, the readiness review is the one in the RC sub-issue. Point releases have no RC: run the readiness criteria over the changes being shipped as part of this go/no-go. For unscheduled point releases shipping an urgent fix, a quick go/no-go with the Product DRI in #woo-core-releases is enough - record the outcome here all the same.
2. Pre-build checks
- Confirm GitHub services are operational.
- Verify no open issues or pull requests exist against the
11.1.0milestone. Ping authors as needed to merge or close. - Ensure that there aren't any pull requests with label "cherry pick failed" that apply to this release that haven't been actioned.
- Confirm the
Stable tagvalue in the readme.txt on the release branch matches the one on WordPress.org'strunk.
3. Build the release package
- Run workflow Release: Bump version number: enter
11.1as Release branch andstableas Type of version bump to perform. - Review and merge the PR that was generated against the release branch. Check for remaining open issues or pull requests in the
11.1.0milestone. - Run workflow Release: Compile changelog: enter
11.1as Version and leave Release date empty, except when building the package ahead of schedule. - Review and merge the PRs that were generated: one against
trunkand another one against the release branch. Both are linked in the workflow run. - Run workflow Release: Build ZIP file to build the asset and create the GitHub release: enter
11.1as Release branch and check Create GitHub release. - Confirm that a draft
11.1.1release was created in the repository with an attachedwoocommerce.zipasset.
4. Upload the release to WordPress.org
- Run workflow Release: Upload release to WordPress.org: enter
11.1.1as Release tag to upload and make sure to check 'I confirm that I want to upload a release to WordPress.org.' - Confirm that SVN tag
11.1.1exists on WordPress.org SVN. - Log into WordPress.org using the credentials from the
WordPress.org "WooCommerce" user accountsecret in the secret store and approve the release. - After a few minutes, confirm that
11.1.1is available for download.
5. Deploy to the staging environment
- Follow the guide to deploy to the staging environment and monitor for at least 2 hours after deploy.
- Share the
#atomicstaging thread in#woo-core-releasesfor visibility. If monitoring surfaces an issue, create a dedicated#woo-core-releasesthread for that issue.
If a critical issue was detected while monitoring...
- Request a revert in the staging environment.
- Pause the release process and do not continue with any steps on this issue. Follow the procedure in the troubleshooting guide instead.
6. Publish the release
- Run workflow Release: Update stable tag: enter
11.1.1as Version and make sure to check 'I confirm that I want to update the stable tag (this will update the SVN and GitHub stable tags).' - Publish the
11.1.1release draft that was previously created, as well as any other11.1drafts that might exist from previous attempts. Ensure that "Set as the latest release" is checked for11.1.1. - If this is the stable release of a new major version: move the supported-version floor forward in the security support policy page (last 21 major versions).
7. Post-release tasks
- Wait at least 1 hour for all automations to complete and make sure to merge any follow-up PRs under the
11.1.0milestone. - Continue monitoring for bugs related to the release for at least 3 days. See the release monitoring guide for more details.
Source: woocommerce/woocommerce