---
title: "Document-to-image API"
canonical_url: "https://www.nutrient.io/guides/dws-processor/tools-and-api/document-to-image-api/"
md_url: "https://www.nutrient.io/guides/dws-processor/tools-and-api/document-to-image-api.md"
last_updated: "2026-05-27T15:15:53.462Z"
description: "Convert DOC, DOCX, XLS, XLSX, PPT, PPTX, and HTML to JPG, PNG, WebP, or TIFF in iOS, Android, and web apps with the document-to-image API. No MS Office license is required."
---

# Document-to-image API

The document-to-image API converts Office documents into images with configurable dimensions and quality settings. Supported input formats include DOC, DOCX, XLS, XLSX, PPT, PPTX, and HTML. Supported output formats are JPG, PNG, WebP, and TIFF. The examples below use JPG, but you can change the `format` value to match your desired output format.

## Rendering a single page

By default, the first page is rendered. Render any other page by adding the `pages` option.

The example below renders the fifth page. Note that pages are indexed starting from zero:

```json

"output": {
  "type": "image",
  "pages": {"start": 4, "end": 4},
  "format": "jpg",
  "width": 500
}

```

## Rendering multiple pages

In addition to rendering a single page (the default), it’s possible to render multiple pages at the same time by adding the `pages` option.

> Render up to 50 pages in a single request. Requesting more than 50 pages results in a status `400` being returned.

The following example returns a ZIP file containing all pages:

```json

"output": {
  "type": "image",
  "pages": {"start": 0, "end": -1},
  "format": "jpg",
  "width": 500
}

```

Render a subset of pages by specifying a range. The example below renders pages two, three, and four:

```json

"output": {
  "type": "image",
  "pages": {"start": 1, "end": 3},
  "format": "jpg",
  "width": 500
}

```

Files in the ZIP archive are named `<page_number>.<format>` (e.g. `1.jpg`, `1.png`).

## Controlling image dimensions

Specify either a width, height, or resolution for output images — choose only one option. Specifying more than one results in a status `400` being returned.

Depending on which option you choose, one or both dimensions are determined based on the page dimensions in the document.

> The maximum image resolution is 34 million pixels (4960×7016px), regardless of aspect ratio. Requesting a larger image results in a status `400` being returned.

Specify the `width` option to render all pages with the same width and varying heights based on page dimensions:

```json

"output": {
  "type": "image",
  "format": "jpg",
  "width": 768
}

```

Specify the `height` option to render all pages with the same height and varying widths based on page dimensions:

```json

"output": {
  "type": "image",
  "format": "jpg",
  "height": 1024
}

```

Specify the `dpi` option to render pages where width and height depend only on page dimensions:

```json

"output": {
  "type": "image",
  "format": "jpg",
  "dpi": 72
}

```

---

## Related pages

- [Tools and APIs](/guides/dws-processor/tools-and-api.md)
- [DOCX templating API](/guides/dws-processor/tools-and-api/docx-templating-api.md)
- [Image-to-PDF API](/guides/dws-processor/tools-and-api/image-to-pdf-api.md)
- [Markdown-to-PDF API](/guides/dws-processor/tools-and-api/markdown-to-pdf-api.md)
- [Office-to-PDF API](/guides/dws-processor/tools-and-api/office-to-pdf-api.md)
- [PDF security API](/guides/dws-processor/tools-and-api/pdf-security-api.md)
- [PDF-to-PDF/A API](/guides/dws-processor/tools-and-api/pdf-to-pdfa-api.md)
- [PDF generator API](/guides/dws-processor/tools-and-api/pdf-generator-api.md)
- [PDF watermark API](/guides/dws-processor/tools-and-api/pdf-watermark-api.md)
- [PDF OCR API](/guides/dws-processor/tools-and-api/pdf-ocr-api.md)
- [PDF-to-image API](/guides/dws-processor/tools-and-api/pdf-to-image-api.md)
- [PDF/UA auto-tagging API](/guides/dws-processor/tools-and-api/pdfua-api.md)
- [Redaction API](/guides/dws-processor/tools-and-api/redaction-api.md)