Skip to content

Roadmap

Jump to bottom
Luciano Bello edited this page Dec 5, 2025 · 108 revisions

If you want to learn more about the Qiskit version strategy, check qisk.it/semver

Disclaimer This roadmap is intended to provide guidance and does not constitute a contractual commitment. Items that do not make it into a specific version will be shifted to subsequent releases. Priorities may be adjusted or items deprioritized as needed. To ensure compatibility with upcoming changes, we recommend running your tests against the main branch, which remains functional and up-to-date. Additionally, most minor releases are preceded by a release candidate, available two weeks before, which can also be used for testing purposes.
upcoming later releases...

Qiskit 3.0

🏁 3.0.0 milestone

  • Compilation of circuits + observables
  • Building C FFI:
    • for custom passmanagers
  • Work towards fault tolerant architectures and error correction

Qiskit 2.N

Qiskit 2.N will be the final minor release in the 2.x series and, as such, will receive extended bug-fix support for at least 6 months after the release of Qiskit 3.0, and security fixes for 12 months.

The release date of Qiskit 2.N depends on when Qiskit 3.0 ships, which is not yet scheduled but is likely in 2026.
Until then, the 2.x series will continue with minor releases (and new backwards-compatibility features) on the usual ~3-month cadence. The last minor release in the 2.x series (2.N) will have no new features and will be released just before Qiskit 3.0.

  • No new features
  • Probably some minimal last-minute deprecations

Qiskit 2.5

🏁 2.5.0 milestone (TBD)

  • Deferred from previous releases
  • Rust/C pass manager
  • Circuit "floor planning” for fitting “larger” virtual circuits into smaller physical devices by reuse, etc
  • Some support for doing resource estimation
  • New OpenQASM 3 handling
  • BasisConstructor as a more efficient alternative to BasisTranslator

Qiskit 2.4

📋 Qiskit 2.4 backlog board
🏁 2.4.0 milestone

  • Building C FFI: Move Qiskit closer to safe transpiler passes with custom gates as a pip install-able C extension module
    • remove libpython from libqiskit
    • P0: be able to define custom gates in Rust or C
    • P0: support safe Python extension modules
    • P1: Parameterized circuit
    • P1: extend the interface to call passes with DAGCircuit
  • Transpiler improvements: New transpiler features and performance improvements in runtime and algorithms.
    • new UnitarySynthesis work to enable parallel 2Q optimization
    • Audit preset pass manager to to remove or adjust transpilation pipelines
  • Dynamic circuits:
    • Annotations for individual PackedInstructions to prepare for Rust-native annotations later
    • Custom call instruction based on the new ControlFlow structure
  • Work toward fault tolerance: Improve optimization of fault-tolerant circuits
    • what is needed for a preset passmanager that support FT circuits?
    • port PauliEvolutionGate to Rust
Priority Status
P0 Blocker for this release
P1 Important, but not a blocker
P2 A nice-to-have
DP Deprioritized		 ⏸️ Not yet started
▶️ On track. On the right path to make it into the release
⚠️ At risk. There’s a chance this might need to be bumped to the next release
⤴️ Deferred to the next release. Very low chances to get in this release
🛑 On hold or blocked
✅ Done or practically done

Qiskit 2.3

Tip

This release is not yet final and it is under development. However, you can install it from source by running pip install . in the directory containing the code from the main branch.

📋 Qiskit 2.3 backlog board
🏁 2.3.0 milestone

Legend
Priority Status
P0 Blocker for this release
P1 Important, but not a blocker
P2 A nice-to-have
DP Deprioritized		 ⏸️ Not yet started
▶️ On track. On the right path to make it into the release
⚠️ At risk. There’s a chance this might need to be bumped to the next release
⤴️ Deferred to the next release. Very low chances to get in this release
🛑 On hold or blocked
✅ Done or practically done

Qiskit 2.2

Tip

Qiskit 2.2 is the current stable release. Bug fixes are delivered through patch releases or in the next minor release, which typically follows about 3 months after 2.2.0.

🏁 2.2.4 milestone unreleased
🏁 2.2.3 milestone
🏁 2.2.2 milestone
🏁 2.2.1 milestone
🏁 2.2.0 milestone

Qiskit 1.4

📝 Release Notes
🏁 1.4.6 milestone (only security bug fixes)
🏁 1.4.5 milestone
🏁 1.4.4 milestone
🏁 1.4.3 milestone
🏁 1.4.1 milestone
🏁 1.4.0 milestone

Important

Qiskit 1.4 is the last minor release of 1.*. As such, it had extended bug-fix support until Oct 13, 2025 (with the release of 1.4.5. 1.4 is the transitional release. Therefore, if no deprecation warnings are raised in 1.4, you are probably ready to move to 2.0. The 1.4 series has security support until April 2026.

Show unmaintained releases

These Qiskit versions are unmaintained. This means that if a bug or issue is found in these versions, they will not be updated, and the recommended action is to upgrade to a maintained version.

Qiskit 2.1

Qiskit 2.1 (released on Jun 19, 2025) was superseded by Qiskit 2.2 (released on Sep 18, 2025), which is fully backward compatible. Upgrading to the latest Qiskit 2.x version is highly recommended.

Qiskit 2.0

Qiskit 2.0 (released on Mar 31, 2025) was superseded by Qiskit 2.1 (released on Jun 19, 2025), which is fully backward-compatible. Moving to the latest Qiskit 2.* version is highly encouraged.

Qiskit 1.3

Qiskit 1.3 (released on Nov 28, 2024) was superseded by Qiskit 1.4 (released on Feb 21, 2025), which is fully backward-compatible. Moving to the latest Qiskit 1.* version is highly encouraged.

  • Most transpiler passes in Rust
  • Oxidized synthesis library
  • Circuit library generators in Rust

Qiskit 1.2

Qiskit 1.2 (released on Aug 15, 2024) was superseded by Qiskit 1.3 (released on Nov 28, 2024), which is fully backward-compatible. Moving to the latest Qiskit 1.* version is highly encouraged.

  • Rust representation of Quantum Circuits
  • 10x faster circuit construction with standard gates
  • Oxidized synthesis functions
  • Improvements to transpiler quality for optimization and layout

Qiskit 0.46

Qiskit 0.46.3 is the last 0.* and reached end-of-life on Sep 27, 2024. Qiskit 0.* is now not supported and moving to a higher version is highly encouraged. In the same direction, qiskit-terra has no updates since then.

Clone this wiki locally