Skip to main content
Templates is a hosted Chromiumly feature. It is not available on self-hosted Gotenberg endpoints. To use templates, configure apiKey (or CHROMIUMLY_API_KEY). When only apiKey is set, Chromiumly uses https://api.chromiumly.dev.

​
Supported template types

  • invoice_freelancer
  • invoice_saas
  • invoice_classic
  • invoice_minimal
  • invoice_modern

​
Basic usage

import { Chromiumly, Templates } from "chromiumly";

Chromiumly.configure({
  apiKey: process.env.CHROMIUMLY_API_KEY!,
});

const templates = new Templates();
const buffer = await templates.generate({
  type: "invoice_saas",
  data: {
    invoiceNumber: "INV-319",
    createdDate: "2026-03-19",
    dueDate: "2026-04-02",
    sender: {
      name: "Acme Cloud LLC",
      addressLine1: "450 Madison Ave",
      addressLine2: "New York, NY 10022",
    },
    receiver: {
      name: "Northwind Health Inc.",
      addressLine1: "221 Harbor Blvd",
      addressLine2: "San Diego, CA 92101",
    },
    items: [
      {
        description: "Platform Subscription",
        qty: 1,
        unitPrice: "1500.00",
        amount: "1500.00",
      },
    ],
    currency: "USD",
    subTotal: "1500.00",
    taxRate: 8.25,
    taxAmount: "123.75",
    total: "1623.75",
    footerNote: "Payment due in 14 days.",
  },
});

​
Runtime validation

Pass { validate: true } as the second argument to validate the payload shape before the request: 
const buffer = await templates.generate(request, { validate: true });
If apiKey is missing, Templates.generate() throws.