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

Settings for Image. 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:** `Format`

```python

from nutrient_sdk import ImageSettings

```

## Construction

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

# SDK-wide default (applies to all documents)

SdkSettings.image_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.image_settings = other_settings` is rejected.

## Properties

### export_format

```python

@property
def export_format(self) -> ImageExportFormat

@export_format.setter
def export_format(self, value: ImageExportFormat) -> None

```

The export format for the image.

**Type:** [`ImageExportFormat`](/api/python/enums/image-export-format/)

**Default:** `ImageExportFormat.Auto`

---

### jpeg_quality

```python

@property
def jpeg_quality(self) -> int

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

```

JPEG compression quality, in the 1..100 range. Only used when resolves to.

**Type:** `int`

**Default:** `90`

---

### mode

```python

@property
def mode(self) -> ImageSettingMode

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

```

The mode options for image processing.

**Type:** [`ImageSettingMode`](/api/python/enums/image-setting-mode/)

**Default:** `ImageSettingMode.FollowExifRotation | ImageSettingMode.PreserveIccProfile`

---

### page_index

```python

@property
def page_index(self) -> Optional[int]

@page_index.setter
def page_index(self, value: Optional[int]) -> None

```

Zero-based page index to render for single-page raster formats (PNG, JPEG, BMP).

**Type:** `Optional[int]`

**Default:** `null`

---

### rasterization_dpi

```python

@property
def rasterization_dpi(self) -> float

@rasterization_dpi.setter
def rasterization_dpi(self, value: float) -> None

```

The rasterization DPI for image rasterization.

**Type:** `float`

**Default:** `200.0F`

---

---

## Related pages

- [Per-document override](/api/python/settings/format/email-settings.md)
- [Per-document override](/api/python/settings/format/html-settings.md)
- [Format](/api/python/settings/format.md)
- [Per-document override](/api/python/settings/format/cad-settings.md)
- [Per-document override](/api/python/settings/format/pdf-settings.md)
- [Per-document override](/api/python/settings/format/jpeg-settings.md)
- [Per-document override](/api/python/settings/format/spreadsheet-settings.md)
- [Per-document override](/api/python/settings/format/markdown-settings.md)
- [Per-document override](/api/python/settings/format/word-settings.md)