---
title: "DOCX, XLSX, PPTX to image server-side conversion | Nutrient"
canonical_url: "https://www.nutrient.io/guides/document-engine/conversion/office-to-image/"
md_url: "https://www.nutrient.io/guides/document-engine/conversion/office-to-image.md"
last_updated: "2026-06-24T08:10:54.120Z"
description: "To convert an Office document to an image, post a multipart request to the /api/build endpoint, including both the Office file as the input."
---

# Convert MS Office documents to image files

To convert an Office document to an image, post a multipart request to the [`/api/build` endpoint](https://www.nutrient.io/api/reference/document-engine/upstream/#tag/Document-Editing/operation/build-document), including both the Office file as the input and the [`instructions` JSON](https://www.nutrient.io/api/reference/document-engine/upstream/#model/BuildInstructions). In response, you’ll receive a ZIP archive containing all of the document’s pages as images.

Converting an Office document to an image requires you to provide dimensions for the resulting rendered pages via a [`width`, `height`, or `dpi` option](https://www.nutrient.io/api/reference/document-engine/upstream/#model/BuildOutput).

Only one option — `width`, `height`, or `dpi` — can be chosen. Other dimensions are calculated before rendering, so as to preserve the page aspect ratio of the rendered image.

The format of the rendered images can be controlled via a [`format` option](https://www.nutrient.io/api/reference/document-engine/upstream/#model/BuildOutput). Supported image formats are PNG, JPEG, WebP, and TIFF.

- Ensure [Document Engine is up and running](https://www.nutrient.io/sdk/document-engine/getting-started.md).

- Send a [multipart POST request](https://www.baeldung.com/postman-form-data-raw-x-www-form-urlencoded) with [instructions](https://www.nutrient.io/api/reference/document-engine/upstream/#tag/Build-API) to Document Engine’s `/api/build` endpoint.

For more information, refer to the [API reference](https://www.nutrient.io/api/reference/document-engine/upstream/#tag/Build-API) to learn about the `/api/build` endpoint and all the actions you can perform on PDFs with Document Engine.

For an overview of multipart requests, refer to the [brief tour of multipart requests](https://www.nutrient.io/blog/a-brief-tour-of-multipart-requests/) blog post.









### Converting an Office file on disk to an image

Send a multipart request to the [`/api/build` endpoint](https://www.nutrient.io/api/reference/document-engine/upstream/#tag/Document-Editing/operation/build-document), attaching an input file and the [`instructions` JSON](https://www.nutrient.io/api/reference/document-engine/upstream/#model/BuildInstructions):

### SHELL

```shell

curl -X POST http://localhost:5000/api/build \
  -H "Authorization: Token token=<API token>" \
  -F document=@/path/to/example-document.docx \
  -F instructions='{
  "parts": [
    {
      "file": "document"
    }
  ],
  "output": {
    "type": "image",
    "format": "jpg",
    "dpi": 500
  }
}' \
  -o result.zip

```

### HTTP

```http

POST /api/build HTTP/1.1
Content-Type: multipart/form-data; boundary=customboundary
Authorization: Token token=<API token>

--customboundary
Content-Disposition: form-data; name="document"; filename="example-document.docx"
Content-Type: application/vnd.openxmlformats-officedocument.wordprocessingml.document

<DOCX data>
--customboundary
Content-Disposition: form-data; name="instructions"
Content-Type: application/json

{
  "parts": [
    {
      "file": "document"
    }
  ],
  "output": {
    "type": "image",
    "format": "jpg",
    "dpi": 500
  }
}
--customboundary--

```

## Converting an Office file from a URL to an image

Send a multipart request to the [`/api/build` endpoint](https://www.nutrient.io/api/reference/document-engine/upstream/#tag/Document-Editing/operation/build-document), attaching an input file and the [`instructions` JSON](https://www.nutrient.io/api/reference/document-engine/upstream/#model/BuildInstructions):

### SHELL

```shell

curl -X POST http://localhost:5000/api/build \
  -H "Authorization: Token token=<API token>" \
  -F instructions='{
  "parts": [
    {
      "file": {
        "url": "https://pspdfkit.com/downloads/examples/paper.docx"
      }
    }
  ],
  "output": {
    "type": "image",
    "format": "jpg",
    "dpi": 500
  }
}' \
  -o result.zip

```

### HTTP

```http

POST /api/build HTTP/1.1
Content-Type: multipart/form-data; boundary=customboundary
Authorization: Token token=<API token>

--customboundary
Content-Disposition: form-data; name="instructions"
Content-Type: application/json

{
  "parts": [
    {
      "file": {
        "url": "https://pspdfkit.com/downloads/examples/paper.docx"
      }
    }
  ],
  "output": {
    "type": "image",
    "format": "jpg",
    "dpi": 500
  }
}
--customboundary--

```
---

## Related pages

- [Convert CAD files to PDF](/guides/document-engine/conversion/cad-to-pdf.md)
- [Convert HTML to PDF](/guides/document-engine/conversion/html-to-pdf.md)
- [Convert image files to PDF](/guides/document-engine/conversion/image-to-pdf.md)
- [PDF and document conversion server](/guides/document-engine/conversion.md)
- [Convert PDF to HTML](/guides/document-engine/conversion/pdf-to-html.md)
- [Convert PDF to image](/guides/document-engine/conversion/pdf-to-image.md)
- [Convert PDF to Office](/guides/document-engine/conversion/pdf-to-office.md)
- [Convert text files to PDF](/guides/document-engine/conversion/text-to-pdf.md)
- [Easily convert documents to PDF/A formats](/guides/document-engine/conversion/to-pdfa.md)
- [PDF to Excel](/guides/document-engine/conversion/pdf-to-excel.md)
- [Convert PDFs to PDF/UA-1](/guides/document-engine/conversion/to-pdfua.md)
- [Convert Office files to PDF](/guides/document-engine/conversion/office-to-pdf.md)