[{release_main_version}] Release {release_version}

These are the instructions for releasing {release_version}, scheduled for {release_date}.

---

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. Pre-build checks

• Confirm GitHub services are operational.
• Verify no open issues or pull requests exist against the {release_milestone} milestone. 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 tag value in the readme.txt on the release branch matches the one on WordPress.org's trunk.

2. Build the release package

• Run workflow Release: Bump version number: enter {release_main_version} as Release branch and stable as 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 {release_milestone} milestone.
• Run workflow Release: Compile changelog: enter {release_main_version} as Version and leave Release date empty, except when building the package ahead of schedule.
• Review and merge the PRs that were generated: one against trunk and 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 {release_main_version} as Release branch and check Create GitHub release.
• Confirm that a draft {release_version} release was created in the repository with an attached woocommerce.zip asset.

3. Upload the release to WordPress.org

• Run workflow Release: Upload release to WordPress.org: enter {release_version} as 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 {release_version} exists on WordPress.org SVN.
• Log into WordPress.org using the credentials from the WordPress.org "WooCommerce" user account secret in the secret store and approve the release.
• After a few minutes, confirm that {release_version} is available for download.

4. Deploy to the staging environment

• Follow the guide to deploy to the staging environment and monitor for at least {release_monitoring_time} hours after deploy.
• Share the #atomic staging thread in #woo-core-releases for visibility. If monitoring surfaces an issue, create a dedicated #woo-core-releases thread 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.

5. Publish the release

• Run workflow Release: Update stable tag: enter {release_version} as 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 {release_version} release draft that was previously created, as well as any other {release_main_version} drafts that might exist from previous attempts. Ensure that "Set as the latest release" is checked for {release_version}.

6. Post-release tasks

• Wait at least 1 hour for all automations to complete and make sure to merge any follow-up PRs under the {release_milestone} milestone.
• Continue monitoring for bugs related to the release for at least 3 days. See the release monitoring guide for more details.