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

Settings for Open. 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 OpenSettings

```

## Construction

`OpenSettings` 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.open_settings
    settings.some_field = new_value          # mutate fields directly

# SDK-wide default (applies to all documents)

SdkSettings.open_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.open_settings = other_settings` is rejected.

## Properties

### document_format

```python

@property
def document_format(self) -> DocumentFormat

@document_format.setter
def document_format(self, value: DocumentFormat) -> None

```

The expected document format.

**Type:** [`DocumentFormat`](/api/python/enums/document-format/)

**Default:** `GdPicture14.DocumentFormat.DocumentFormatUNKNOWN`

---

### implicit_conversion

```python

@property
def implicit_conversion(self) -> ImplicitConversion

@implicit_conversion.setter
def implicit_conversion(self, value: ImplicitConversion) -> None

```

Whether implicit conversion is enabled when opening documents in editors. When enabled, documents will be automatically converted to a compatible format for editing.

**Type:** [`ImplicitConversion`](/api/python/enums/implicit-conversion/)

**Default:** `ImplicitConversion.Enabled`

---

### max_pages

```python

@property
def max_pages(self) -> int

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

```

The maximum number of pages to load from the document.

**Type:** `int`

**Default:** `0`

---

### mode

```python

@property
def mode(self) -> OpenSettingsMode

@mode.setter
def mode(self, value: OpenSettingsMode) -> None

```

The operational mode for opening the document.

**Type:** [`OpenSettingsMode`](/api/python/enums/open-settings-mode/)

**Default:** `OpenSettingsMode.Unspecified`

---

### page_cache_mode

```python

@property
def page_cache_mode(self) -> PageCacheMode

@page_cache_mode.setter
def page_cache_mode(self, value: PageCacheMode) -> None

```

The page caching mode for the document.

**Type:** [`PageCacheMode`](/api/python/enums/page-cache-mode/)

**Default:** `PageCacheMode.Memory`

---

---

## Related pages

- [Per-document override](/api/python/settings/document/conversion-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)