---
title: SamplerOptions (latest version)
description: API reference for qiskit_ibm_runtime.options_models.SamplerOptions in the latest version of qiskit-ibm-runtime
source: https://quantum.cloud.ibm.com/docs/en/api/qiskit-ibm-runtime/options-models-sampler-options
---

# qiskit\_ibm\_runtime.options\_models.SamplerOptions

*pydantic model* `SamplerOptions`

[GitHub](https://github.com/Qiskit/qiskit-ibm-runtime/tree/stable/0.50/qiskit_ibm_runtime/options_models/sampler.py#L25-L55)

Bases: `BaseOptionsModel`

Options for the client-side Sampler.

**Config**

- **validate\_assignment**: *bool = True*
- **extra**: *str = forbid*

### default\_shots

*field*

Type: `int` | `None`

Default value: `4096`

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

### dynamical\_decoupling

*field*

Type: [`DynamicalDecouplingOptions`](/docs/api/qiskit-ibm-runtime/options-models-dynamical-decoupling-options "qiskit_ibm_runtime.options_models.DynamicalDecouplingOptions")

Default value: `DynamicalDecouplingOptions(enable=False, sequence_type='XX', extra_slack_distribution='middle', scheduling_method='alap', skip_reset_qubits=False)`

Suboptions for dynamical decoupling.

### environment

*field*

Type: [`EnvironmentOptions`](/docs/api/qiskit-ibm-runtime/options-models-environment-options "qiskit_ibm_runtime.options_models.EnvironmentOptions")

Default value: `EnvironmentOptions(log_level='WARNING', job_tags=[], private=False, max_execution_time=None, image=None)`

Options related to the execution environment.

### execution

*field*

Type: [`SamplerExecutionOptions`](/docs/api/qiskit-ibm-runtime/options-models-sampler-execution-options "qiskit_ibm_runtime.options_models.SamplerExecutionOptions")

Default value: `SamplerExecutionOptions(init_qubits=True, rep_delay=None, scheduler_timing=False, stretch_values=False, meas_type='classified')`

Execution options.

### experimental

*field*

Type: `dict`

Default value: `{}`

Experimental options.

### max\_execution\_time

*field*

Type: `int` | `None`

Default value: `None`

Maximum execution time in seconds.

This value bounds system execution time (not wall clock time). System execution time is the amount of time that the system is dedicated to processing your job. If a job exceeds this time limit, it is forcibly cancelled.

### simulator

*field*

Type: [`SimulatorOptions`](/docs/api/qiskit-ibm-runtime/options-models-simulator-options "qiskit_ibm_runtime.options_models.SimulatorOptions")

Default value: `SimulatorOptions(angle_decimals=5, layer_noise_model=None, seed_simulator=None, warn_absent=True)`

Options related to local mode simulations.

### twirling

*field*

Type: [`TwirlingOptions`](/docs/api/qiskit-ibm-runtime/options-models-twirling-options "qiskit_ibm_runtime.options_models.TwirlingOptions")

Default value: `TwirlingOptions(enable_gates=None, enable_measure=None, group='pauli', num_randomizations='auto', shots_per_randomization='auto', strategy='active-accum')`

Pauli twirling options.

### update

`update(**kwargs)`

[GitHub](https://github.com/Qiskit/qiskit-ibm-runtime/tree/stable/0.50/qiskit_ibm_runtime/options_models/base.py#L46-L54)

Update the options.

**Parameters**

**kwargs** (*Any*)

**Return type**

None