XLSX

Images

Embed PNG and JPEG images in worksheets

Basic Image

{
  "worksheets": [
    {
      "name": "Images",
      "rows": [{ "cells": [{ "value": "Label" }, { "value": "Data" }] }],
      "images": [
        {
          "data": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAAEAAAABCAQAAAC1HAwCAAAAC0lEQVR42mNkYAAAAAYAAjCB0C8AAAAASUVORK5CYII=",
          "type": "png",
          "col": 3,
          "row": 1
        }
      ]
    }
  ]
}

Multiple Images

{
  "worksheets": [
    {
      "name": "Gallery",
      "rows": [{ "cells": [{ "value": "Photos" }] }],
      "images": [
        {
          "data": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAAEAAAABCAQAAAC1HAwCAAAAC0lEQVR42mNkYAAAAAYAAjCB0C8AAAAASUVORK5CYII=",
          "type": "png",
          "col": 2,
          "row": 2
        },
        {
          "data": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAAEAAAABCAQAAAC1HAwCAAAAC0lEQVR42mNkYAAAAAYAAjCB0C8AAAAASUVORK5CYII=",
          "type": "jpg",
          "col": 5,
          "row": 2
        }
      ]
    }
  ]
}

Supported Formats

Formattype value
PNG"png"
JPEG"jpg"

Already-compressed formats (PNG/JPEG/GIF) are stored uncompressed (ZIP_STORED) since they are already compressed; vector/uncompressed formats (EMF/WMF/BMP) use DEFLATE.

Image Options Reference

OptionTypeDescription
dataUint8ArrayImage file data
type"png" | "jpg"Image format
colnumber1-based column position
rownumber1-based row position
Copyright © 2026