TypeScript icon, indicating that this package has built-in type declarations

1.0.1 • Public • Published


** THIS IS FORK FROM node-html-to-image PACKAGE. Updated puppeteer version to 5.5.0

Welcome to htmltoimg-node 🌄

A Node.js library that generates images from HTML


This module exposes a function that generates images (png, jpeg) from HTML. It uses puppeteer in headless mode to achieve it. Additionally, it embarks Handlebars to provide a way to add logic in your HTML.


npm install htmltoimg-node


Simple example

const nodeHtmlToImage = require('htmltoimg-node')

  output: './image.png',
  html: '<html><body>Hello world!</body></html>'
  .then(() => console.log('The image was created successfully!'))

TypeScript support

Types are included in the package. Enable the esModuleInterop compiler flag then change all references of require with import statements and you should be good to go:

import nodeHtmlToImage from 'htmltoimg-node'


List of all available options:

option description type required
output The ouput path for generated image string optional
html The html used to generate image content string required
type The type of the generated image jpeg or png (default: png) optional
quality The quality of the generated image (only applicable to jpg) number (default: 80) optional
content If provided html property is considered an handlebars template and use content value to fill it object or Array optional
waitUntil Define when to consider markup succeded. Learn more. string or Array (default: networkidle0) optional
puppeteerArgs The puppeteerArgs property let you pass down custom configuration to puppeteer. Learn more. object optional
beforeScreenshot An async function that will execute just before screenshot is taken. Gives access to puppeteer page element. Function optional
transparent The transparent property lets you generate images with transparent background (for png type). boolean optional
encoding The encoding property of the image. Options are binary (default) or base64. string optional

Setting output image resolution

htmltoimg-node takes a screenshot of the body tag's content. If you want to set output image's resolution you need to set its dimension using CSS like in the following example.

const nodeHtmlToImage = require('htmltoimg-node')

  output: './image.png',
  html: `<html>
        body {
          width: 2480px;
          height: 3508px;
    <body>Hello world!</body>
  .then(() => console.log('The image was created successfully!'))

Example with Handlebars

Handlerbars is a templating language. It generates HTML from a template and an input object. In the following example we provide a template to htmltoimg-node and a content object to fill the template.

const nodeHtmlToImage = require('htmltoimg-node')

  output: './image.png',
  html: '<html><body>Hello {{name}}!</body></html>',
  content: { name: 'you' }
  .then(() => console.log('The image was created successfully!'))

Handlebars provides a lot of expressions to handle common use cases like conditions or loops.

Dealing with images

If you want to display an image which is stored remotely do it as usual. In case your image is stored locally I recommend having your image in base64. Then you need to pass it to the template with the content property. Here is an example:

const nodeHtmlToImage = require('htmltoimg-node')
const fs = require('fs');

const image = fs.readFileSync('./image.jpg');
const base64Image = new Buffer.from(image).toString('base64');
const dataURI = 'data:image/jpeg;base64,' + base64Image

  output: './image.png',
  html: '<html><body><img src="{{imageSource}}" /></body></html>',
  content: { imageSource: dataURI }

Using the buffer instead of saving to disk

If you don't want to save the image to disk and would rather do something with it immediately, you can use the returned value instead! The example below shows how you can generate an image and send it back to a client via using express.

const express = require('express');
const router = express.Router();
const nodeHtmlToImage = require('htmltoimg-node');

router.get(`/api/tweet/render`, async function(req, res) {
  const image = await nodeHtmlToImage({
    html: '<html><body><div>Check out what I just did! #cool</div></body></html>'
  res.writeHead(200, { 'Content-Type': 'image/png' });
  res.end(image, 'binary');

Generating multiple images

If you want to generate multiple images in one call you must provide an array to the content property.

Saving to disk

To save on the disk you must provide the output property on each object in the content property.

  html: '<html><body>Hello {{name}}!</body></html>',
  content: [{ name: 'Pierre', output: './image1.png' }, { name: 'Paul', output: './image2.png' }, { name: 'Jacques', output: './image3.png' }]
  .then(() => console.log('The images were created successfully!'))

Using buffers

If you don't want to save the images to disk you can use the returned value instead. It returns an array of Buffer objects.

const images = await nodeHtmlToImage({
  html: '<html><body>Hello {{name}}!</body></html>',
  content: [{ name: 'Pierre' }, { name: 'Paul' }, { name: 'Jacques' }]

Run tests

yarn test

Show your support

Give a ⭐️ if this project helped you!

Package Sidebar


npm i htmltoimg-node

Weekly Downloads






Unpacked Size

32.7 kB

Total Files


Last publish


  • jamol_tokhtaev