---
title: "ConversionSettings"
canonical_url: "https://www.nutrient.io/api/python/settings/document/conversion-settings/"
md_url: "https://www.nutrient.io/api/python/settings/document/conversion-settings.md"
last_updated: "2026-06-12T15:43:20.744Z"
description: "Settings for Conversion. Values fall back through three levels: document → SDK → built-in default."
---

Settings for Conversion. Values fall back through three levels: document → SDK → built-in default. Writes target the document only when set on a document's settings, otherwise the SDK globally when set on SdkSettings.

**Tags:** `Document`

```python

from nutrient_sdk import ConversionSettings

```

## Construction

`ConversionSettings` is accessed through a [`Document`](/api/python/document/) instance for per-document overrides, or via [`SdkSettings`](/api/python/settings/document/sdk-settings/) for SDK-wide defaults.

```python

# Per-document override

with Document.open("input.pdf") as doc:
    settings = doc.settings.conversion_settings
    settings.some_field = new_value          # mutate fields directly

# SDK-wide default (applies to all documents)

SdkSettings.conversion_settings.some_field = new_value

```

Settings are configured by writing to fields on the returned object. The settings property itself cannot be reassigned — `doc.settings.conversion_settings = other_settings` is rejected.

## Properties

### timeout_milliseconds

```python

@property
def timeout_milliseconds(self) -> int

@timeout_milliseconds.setter
def timeout_milliseconds(self, value: int) -> None

```

The conversion timeout in milliseconds. After this time, the conversion will be aborted and return a TimeoutException.

**Type:** `int`

**Default:** `The default value is -1, which means no timeout.`

---

---

## Related pages

- [Per-document override](/api/python/settings/document/open-settings.md)
- [Document Settings](/api/python/settings/document/document-settings.md)
- [Sdk Settings](/api/python/settings/document/sdk-settings.md)
- [Document](/api/python/settings/document.md)