Release Registry
May 7, 2026 · View on GitHub
Single source of truth regarding past and future releases of the Polkadot SDK.
This repo contains a releases-v1.json file that tracks all SDK releases and a JSON schema to ensure that it is in canonical format.
This Gantt chart shows the released (pink) and planned (grey) releases. The longer bars are the stable releases and the small ones are the patches on top of it.
Calendar
Planned and historic release dates:
| Version | SemVer | Cutoff | Publish | End of Life | State |
|---|---|---|---|---|---|
| stable2606 | 1.23.0 | 2026-05-18 | 2026-07-02 | 2027-07-02 | Planned |
| stable2606-1 | 1.23.1 | 2026-08-03 | 2026-08-06 | Planned | |
| stable2606-2 | 1.23.2 | 2026-09-07 | 2026-09-10 | Planned | |
| 11 more planned | |||||
| stable2603 | 1.22.0 | 2026-02-09 | 2026-03-31 | 2027-03-26 | Released |
| stable2603-1 | 1.22.1 | 2026-05-04 | 2026-05-04 | Released | |
| stable2603-2 | 1.22.2 | 2026-05-25 | 2026-05-28 | Planned | |
| stable2603-3 | 1.22.3 | 2026-06-22 | 2026-06-25 | Planned | |
| 10 more planned | |||||
| stable2512 | 1.21.0 | 2025-11-17 | 2025-12-22 | 2027-01-01 | Released |
| stable2512-2 | 1.21.2 | 2026-02-23 | 2026-02-23 | Released | |
| stable2512-3 | 1.21.3 | 2026-03-23 | 2026-03-23 | Released | |
| stable2512-4 | 1.21.4 | 2026-04-20 | 2026-04-23 | Planned | |
| stable2512-5 | 1.21.5 | 2026-05-18 | 2026-05-21 | Planned | |
| 1 more past, 7 more planned | |||||
| stable2509 | 1.20.0 | 2025-08-18 | 2025-10-08 | 2026-10-02 | Released |
| stable2509-5 | 1.20.5 | 2026-02-12 | 2026-02-12 | Released | |
| stable2509-7 | 1.20.7 | 2026-04-13 | 2026-04-16 | Released | |
| stable2509-6 | 1.20.6 | 2026-03-09 | 2026-03-12 | Planned | |
| stable2509-8 | 1.20.8 | 2026-05-11 | 2026-05-14 | Planned | |
| 4 more past, 5 more planned | |||||
| stable2506 | 1.19.0 | 2025-05-15 | 2025-07-24 | 2026-06-30 | Released |
| stable2506-10 | 1.19.10 | 2026-04-10 | 2026-04-10 | Released | |
| stable2506-11 | 1.19.11 | 2026-05-07 | 2026-05-07 | Released | |
| stable2506-12 | 1.19.12 | 2026-06-01 | 2026-06-04 | Planned | |
| 9 more past | |||||
| stable2503 | 1.18.0 | 2025-02-17 | 2025-04-08 | 2026-03-31 | |
| stable2503-13 | 1.18.13 | 2025-12-22 | 2025-12-25 | ||
| stable2503-14 | 1.18.14 | 2026-01-26 | 2026-01-29 | ||
| 12 more past | |||||
| stable2412 | 1.17.0 | 2024-11-06 | 2024-12-17 | 2025-12-16 | |
| stable2412-12 | 1.17.12 | 2025-11-17 | 2025-11-20 | ||
| stable2412-13 | 1.17.13 | 2025-12-15 | 2025-12-18 | ||
| 11 more past | |||||
| stable2409 | 1.16.0 | 2024-09-02 | 2025-06-12 | 2025-09-25 | |
| stable2409-12 | 1.16.12 | 2025-09-11 | 2025-09-11 | ||
| stable2409-13 | 2025-10-13 | 2025-10-16 | |||
| 11 more past | |||||
| stable2407 | 1.15.0 | 2024-04-29 | 2024-04-29 | 2025-04-29 | |
| stable2407-9 | 1.15.9 | 2025-04-10 | 2025-04-10 | ||
| stable2407-10 | 2025-05-05 | 2025-05-08 | |||
| 8 more past |
Subscribe
Subscribe to the calendar by adding this iCal link to your Google or Apple calendar:
https://raw.githubusercontent.com/paritytech/release-registry/main/releases-v1.ics
Google has an "From URL" and Apple "New Calendar Subscription" option for this:
| Apple | |
|---|---|
 |  |
Schedule
Releases
The Polkadot SDK has a stableYYMM release every 3 months. Each stable release is supported for one year through a monthly patching schedule. The releases are not exactly 3 months apart, but we try to keep it close. The exact dates are in the calendar.
Stable releases undergo a 1.5 month QA period before being published. This explains the difference between the cutoff and published dates.
Patches
Patches have the tag format stableYYMM-PATCH where PATCH ranges from 1 to 99. There is no zero padding present, example: stable2407-1 or stable2409-10.
The patching schedule of each stable release is assigned a week of the month. This works well, since there can be at most four stable releases maintained at once. For example: release stable2407 is always patched in the first week of a month. This means that on the first Monday of each month, a new patch is cut off, and on the first Thursday after that Monday, it is published.
Goals
The two main goals of this repo are to improve:
- Communication: clear information about past and upcoming releases. Hoarding information inside Parity is not helpful. This repo aims to make it easier for the Polkadot Ecosystem to know what's going on. This can be helpful to all departments; developers, marketing, devops, security etc.
- Expectations: set clear expectations by having a public schedule. Know when what is coming.
Maintenance
Release Planning
(how to add a new release to the json)
First, check the calendar when about 3 months passed from the publish date of the last release. Then subtract about 1.5 months from that and call the plan command with that date:
python3 scripts/manage.py release plan stable2412 2024-11-06
Then figure out when the first patch date should be; you have to select a Monday for the patching schedule to be calculated (errors if not a Monday). You should select either a week that is empty and has no schedule, or the one where the oldest release is currently being patched.
The script will then count the how many-th monday of the month it is and begin lining it up with the months like in the image above.
Example where we want the first patch to be cut off on 2024-07-29:
python3 scripts/manage.py backfill-patches stable2407 --start-date 2024-07-29
Then update the README to see the changes by running just.
Release Cutoff / Publish
Run this command to cut off a release:
python3 scripts/manage.py release cutoff stable2407-2 2024-09-02
With publish likewise.
Automation
Two scripts are currently in place to:
- manage.py - manage the releases json file (plan, cutoff, publish, etc)
- update-readme.py - updates the README.md file with the data from the releases.json file
- update-calendar.py - generates an iCal file from the releases.json file
- update-badges.py - re-generate the badges in the
badgesfolder for downstream use.