> For a complete index of all SignalWire documentation pages, fetch https://signalwire.com/docs/llms.txt

# SignalWireOptions

> Options for constructing a SignalWire.

Options for constructing a [SignalWire](/docs/browser-sdk/v4/reference/signalwire).

## **Properties**

Debug options for verbose SDK diagnostics (e.g., `{ logWsTraffic: true }`). See [`DebugOptions`](/docs/browser-sdk/v4/reference/interfaces/debug-options).

Custom logger implementation. Must implement the [SDKLogger](/docs/browser-sdk/v4/reference/interfaces/sdk-logger) interface. Pass `null` to restore the built-in logger. **Note:** Logger configuration is global — setting it on one instance affects all instances.

Log level for the built-in logger. Default: `'warn'`. Set to `'debug'` for verbose SDK output. Has no effect when a custom `logger` is provided. **Note:** Logger configuration is global — setting it on one instance affects all instances. See [`LogLevel`](/docs/browser-sdk/v4/reference/type-aliases/log-level).

Persist the session across page reloads. When `true`, credential, authorization state, and protocol are stored in `localStorage` (survives reload). The DPoP key pair is persisted in IndexedDB. On reload, the SDK restores the session from cache without calling `credentialProvider.authenticate()`. When `false` (default), session data lives in `sessionStorage` and is lost on reload. Call [destroy()](/docs/browser-sdk/v4/reference/signalwire) to clear all persisted state (explicit logout).

Whether to reconnect to previously attached calls.

Whether to save preferences.

Skip automatic WebSocket connection on construction.

Skip monitoring media device changes.

Skip automatic user registration on construction.

Custom storage implementation for persistence. See [`Storage`](/docs/browser-sdk/v4/reference/interfaces/storage).

Custom WebRTC API provider. See [`WebRTCApiProvider`](/docs/browser-sdk/v4/reference/interfaces/webrtc-api-provider).

Custom WebSocket constructor. See [`NodeSocketAdapter`](/docs/browser-sdk/v4/reference/interfaces/node-socket-adapter) and [`WebSocketAdapter`](/docs/browser-sdk/v4/reference/type-aliases/web-socket-adapter).