Skip to main contentIBM Quantum Documentation Preview

Migrate options

All backend.run options are now available through the Qiskit Runtime primitives, but there are additional options available with the V2 primitives. See the API reference for the full list of available options. See End-to-end examples and Advanced Qiskit Runtime options for more information about specifying V2 primitives options.

backend.run optionsV2 Primitive optionsNotes
job_nameN/A: Use job_tags instead.ibmq-provider only
job_share_levelN/A: This is no longer supported.ibmq-provider only
job_tagsoptions.environment.job_tags
experiment_idN/A: Use job_tags instead.ibmq-provider only
headerYou can attach metadata to circuits. The same metadata is returned in the result metadata, under “circuit_metadata”.
shotsAny of the following:
• run([(…, shots)])
• run(…, shots=)
• options.default_shots
memoryUse result.data.<classical_register_name>.get_counts() to get counts.
Use result.data.<classical_register_name>.get_bitstrings() to get per-shot measurements.
qubit_lo_freqN/A: This option only applies to Schedule inputs, which was removed in 2022.
meas_lo_freqN/A: This option only applies to Schedule inputs, which was removed in 2022.
schedule_losN/A: This option only applies to Schedule inputs, which was removed in 2022.
meas_leveloptions.execution.meas_type:
• For meas_level=1 and meas_return="avg", use avg_kerneled
• For meas_level=1 and meas_return="single", use kerneled
• For meas_level=2, use classified
• meas_level=0 is no longer supported by IBM backends.
meas_returnoptions.execution.meas_type (See above.)
memory_slotsN/A: This is automatically determined by the QPU (quantum processing unit).ibmq-provider only
memory_slot_sizeN/A: This is automatically determined by the QPU.ibmq-provider only
rep_timeN/A: Use rep_delay instead.
rep_delayoptions.execution.rep_delay
init_qubitsoptions.execution.init_qubits
parameter_bindsSpecify parameters in PUBs.ibmq-provider only
use_measure_espN/A: This is no longer supported by IBM backends.
live_data_enabledN/A: This feature was removed in 2022.ibmq-provider only
dynamicN/A: No longer needed. SamplerV2 automatically detects dynamic circuits.ibm-provider only
init_circuitN/A: Use init_qubits instead.
init_num_resetsN/A: Use init_qubits instead.
noise_modeloptions.simulator.noise_model
seed_simulatoroptions.simulator.seed_simulator

Algorithm tuning

One of the advantages of the primitives is that they abstract away the circuit execution setup so that algorithm developers can focus on the pure algorithmic components. However, sometimes, to get the most out of an algorithm, you might want to tune certain primitive options. For details, see Advanced runtime options.