---
title: SamplerOptions (v0.41)
description: API reference for qiskit_ibm_runtime.options.SamplerOptions in qiskit-ibm-runtime v0.41
source: https://eu-de.quantum.cloud.ibm.com/docs/en/api/qiskit-ibm-runtime/0.41/options-sampler-options
---

# SamplerOptions

*class* `SamplerOptions(_VERSION=2, max_execution_time=Unset, environment=<factory>, simulator=<factory>, default_shots=Unset, dynamical_decoupling=<factory>, execution=<factory>, twirling=<factory>, experimental=Unset)`

[GitHub](https://github.com/Qiskit/qiskit-ibm-runtime/tree/stable/0.41/qiskit_ibm_runtime/options/sampler_options.py#L27-L57)

Bases: `OptionsV2`

Options for V2 Sampler.

## Attributes

**Parameters**

- **\_VERSION** (*int*)
- **max\_execution\_time** (*UnsetType | int*)
- **environment** ([*EnvironmentOptions*](/docs/api/qiskit-ibm-runtime/0.41/options-environment-options "qiskit_ibm_runtime.options.environment_options.EnvironmentOptions") *| Dict*)
- **simulator** ([*SimulatorOptions*](/docs/api/qiskit-ibm-runtime/0.41/options-simulator-options "qiskit_ibm_runtime.options.simulator_options.SimulatorOptions") *| Dict*)
- **default\_shots** (*UnsetType | int*)
- **dynamical\_decoupling** ([*DynamicalDecouplingOptions*](/docs/api/qiskit-ibm-runtime/0.41/options-dynamical-decoupling-options "qiskit_ibm_runtime.options.dynamical_decoupling_options.DynamicalDecouplingOptions") *| Dict*)
- **execution** ([*SamplerExecutionOptionsV2*](/docs/api/qiskit-ibm-runtime/0.41/options-sampler-execution-options-v2 "qiskit_ibm_runtime.options.sampler_execution_options.SamplerExecutionOptionsV2") *| Dict*)
- **twirling** ([*TwirlingOptions*](/docs/api/qiskit-ibm-runtime/0.41/options-twirling-options "qiskit_ibm_runtime.options.twirling_options.TwirlingOptions") *| Dict*)
- **experimental** (*UnsetType | dict*)

### default\_shots

Type: `UnsetType | int`

Default value: `Unset`

The default number of shots to use if none are specified in the PUBs or in the run method.

Default: 4096.

### dynamical\_decoupling

Type: `DynamicalDecouplingOptions | Dict`

Default value: `FieldInfo(annotation=NoneType, required=False, default_factory=DynamicalDecouplingOptions)`

Suboptions for dynamical decoupling. See [`DynamicalDecouplingOptions`](/docs/api/qiskit-ibm-runtime/0.41/options-dynamical-decoupling-options "qiskit_ibm_runtime.options.DynamicalDecouplingOptions") for all available options.

### environment

Type: `EnvironmentOptions | Dict`

Default value: `FieldInfo(annotation=NoneType, required=False, default_factory=EnvironmentOptions)`

### execution

Type: `SamplerExecutionOptionsV2 | Dict`

Default value: `FieldInfo(annotation=NoneType, required=False, default_factory=SamplerExecutionOptionsV2)`

Execution time options. See [`SamplerExecutionOptionsV2`](/docs/api/qiskit-ibm-runtime/0.41/options-sampler-execution-options-v2 "qiskit_ibm_runtime.options.SamplerExecutionOptionsV2") for all available options.

### experimental

Type: `UnsetType | dict`

Default value: `Unset`

Experimental options.

### max\_execution\_time

Type: `UnsetType | int`

Default value: `Unset`

### simulator

Type: `SimulatorOptions | Dict`

Default value: `FieldInfo(annotation=NoneType, required=False, default_factory=SimulatorOptions)`

### twirling

Type: `TwirlingOptions | Dict`

Default value: `FieldInfo(annotation=NoneType, required=False, default_factory=TwirlingOptions)`

Pauli twirling options. See [`TwirlingOptions`](/docs/api/qiskit-ibm-runtime/0.41/options-twirling-options "qiskit_ibm_runtime.options.TwirlingOptions") for all available options.

## Methods

### update

`update(**kwargs)`

[GitHub](https://github.com/Qiskit/qiskit-ibm-runtime/tree/stable/0.41/qiskit_ibm_runtime/options/options.py#L146-L155)

Update the options.

**Parameters**

**kwargs** (*Any*)

**Return type**

None