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

# SamplerOptions

*class* `SamplerOptions(*args, **kwargs)`

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

Options for V2 Sampler.

**Parameters**

- **default\_shots** – The default number of shots to use if none are specified in the PUBs or in the run method. Default: 4096.
- **dynamical\_decoupling** – Suboptions for dynamical decoupling. See [`DynamicalDecouplingOptions`](/docs/api/qiskit-ibm-runtime/0.26/options-dynamical-decoupling-options "qiskit_ibm_runtime.options.DynamicalDecouplingOptions") for all available options.
- **execution** – Execution time options. See [`SamplerExecutionOptionsV2`](/docs/api/qiskit-ibm-runtime/0.26/options-sampler-execution-options-v2 "qiskit_ibm_runtime.options.SamplerExecutionOptionsV2") for all available options.
- **twirling** – Pauli twirling options. See [`TwirlingOptions`](/docs/api/qiskit-ibm-runtime/0.26/options-twirling-options "qiskit_ibm_runtime.options.TwirlingOptions") for all available options.
- **experimental** – Experimental options.

## Attributes

### default\_shots

Type: `UnsetType | int`

Default value: `Unset`

### dynamical\_decoupling

Type: `DynamicalDecouplingOptions | Dict`

Default value: `FieldInfo(annotation=Union[DynamicalDecouplingOptions, Dict], required=False, default_factory=DynamicalDecouplingOptions)`

### environment

Type: `EnvironmentOptions | Dict`

Default value: `FieldInfo(annotation=Union[EnvironmentOptions, Dict], required=False, default_factory=EnvironmentOptions)`

### execution

Type: `SamplerExecutionOptionsV2 | Dict`

Default value: `FieldInfo(annotation=Union[SamplerExecutionOptionsV2, Dict], required=False, default_factory=SamplerExecutionOptionsV2)`

### experimental

Type: `UnsetType | dict`

Default value: `Unset`

### max\_execution\_time

Type: `UnsetType | int`

Default value: `Unset`

### simulator

Type: `SimulatorOptions | Dict`

Default value: `FieldInfo(annotation=Union[SimulatorOptions, Dict], required=False, default_factory=SimulatorOptions)`

### twirling

Type: `TwirlingOptions | Dict`

Default value: `FieldInfo(annotation=Union[TwirlingOptions, Dict], required=False, default_factory=TwirlingOptions)`

## Methods

### update

`update(**kwargs)`

[GitHub](https://github.com/Qiskit/qiskit-ibm-runtime/tree/stable/0.26/qiskit_ibm_runtime/options/options.py#L153-L173)

Update the options.

**Return type**

`None`
