Roadmap

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 2.7

📋 Qiskit 2.7 backlog board
🏁 2.7.0 milestone (with planned release dates)

• ...

Qiskit 2.6

📋 Qiskit 2.6 backlog board
🏁 2.6.0 milestone (with planned release dates)

• ...

Qiskit 2.5

📋 Qiskit 2.5 backlog board
🏁 2.5.0 milestone (with planned release dates)

• Add BackendV3 as abstraction interface definition for executor ^{BackendV3 full board}
• Clifford measurement post-processing
• Deepen Python independence of core Qiskit infrastructure
• DP BasisConstructor as a more efficient alternative to BasisTranslator

C interface - Work that extends or enhances the C API and its use
^{C API full board}

• Control Flow:
  • Expose low-level creation
  • Expose traversing operations
• P1: initial support for custom gates in Rust
• P1: remove libpython from libqiskit

General transpiler improvements: New transpiler features and performance improvements in runtime and algorithms
^{Performance full board}

• P2: new UnitarySynthesis work to enable parallel 2Q optimization
• P2: Audit preset pass manager to remove or adjust transpilation pipelines
• Some form of constant propagation, similar to https://github.com/1ucian0/rpo

Dynamic circuits

• Range support
• support for variable in the measurment

Work towards fault-tolerance: Improve compiling and optimization of fault-tolerant ISA circuits
^{fault tolerance full board}

• Dedicated transpiler pipeline to compile to PBC
• Introduction of Block Encoding notions/structures in Qiskit
  • rust (module/crate?) block encoding representation, independently of Qiskit
  • abstract gate-type that can be decomposed and treated by transpiler

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.4

Tip

Qiskit 2.4 is not released yet 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.4 backlog board
🏁 2.4.0 milestone (with planned release dates)

• Building C FFI: Move Qiskit closer to safe transpiler passes with custom gates as a pip install-able C extension module
  • P1⤴️: remove libpython from libqiskit
  • Towards custom gates in Rust and C:
    • P0⤴️: initial support for custom gates in Rust
  • P0✅: support safe Python extension modules
  • P1✅: support for parameterized circuit
  • P1✅: extend the interface to call passes with DAGCircuit as a parameter
  • QPY serialization
    • P1✅: port to Rust
    • P2✅: support for loading older QPY versions
• Transpiler improvements: New transpiler features and performance improvements in runtime and algorithms.
  • P2⤴️: new UnitarySynthesis work to enable parallel 2Q optimization
  • P2⤴️: Audit preset pass manager to remove or adjust transpilation pipelines
• Dynamic circuits:
  • P0✅ 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?
    • P0✅: Improved clifford-T pipeline
    • P2✅: new SynthesizeRZRotations pass
  • P1✅: Add PauliProductRotationGate to eventually replace PauliEvolutionGate

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.3

Important

Qiskit 2.3 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.3.0.

📝 1.4 Release Notes
🚀 2.3 Release Summary
🏁 2.3.1 milestone
🏁 2.3.0 milestone

• Building C FFI: Make it possible to write passes in C. For that:
  • DAGCircuit C FFI: To build custom transpiler passes in C
• Oxidizing: moving components to Rust usually give performance improvements or/and allows to expose a C FFI on those components
  • Control flow
  • Unitary synthesis QSD
• Work towards fault-tolerance: Improve optimization of fault-tolerant circuits
  • New plugin for better Clifford+T synthesis: gridsynth
  • Adding PauliProductMeasurement instruction to support Pauli measurements
  • Optimize the OptimizeCliffordT transpiler pass
  • Speedup LitinskiTransformation pass
• Transpiler performance:
  • Faster VF2 (which probably also means better output)
  • Unitary synthesis CX count improvement

Qiskit 1.4

📝 1.4 Release Notes
🏁 1.4.6 milestone to be released, if necessary (only security bug fixes)

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.2

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

• Expand C FFI: Transpiler function and passes
• Keep oxidizing:
  • Transpiler passes for preset passmanagers
  • Parameter classes
  • QPY serialization
• Working towards building a fault-tolerant transpiler:
  • Litinski transform
• Expand target model for more constraints on instruction parameters

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.

• Expand C FFI to include:
  • Circuit construction with standard gates
  • Target construction and interaction
• Rust parameter expressions
• Support annotations in boxes
• Easier compilation to discrete basis sets
• OpenQASM 3 exporters in Rust
• Context aware DD
• Clifford+T transpilation
• Pending deprecations from circuit library should move to deprecations
• Initial work for improving ObservablesArray ergonomics

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.

• Initial support to build Qiskit C FFI as a standalone dynamic library
  • Sparse Observable C API
• Add structures to support deferred timing of dynamic circuits
  • Add QASM3 stretch operation
  • Initial support for stretch operations
• Initial support for boxes in circuits
• Improvements in synthesis with fractional gates
• Removal of deprecated code in 1.*

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.