Add page numbers to a PDF footer

HTML for the running footer. Same classes as headerHtml; needs a bottom margin.

What it is for

The same mechanism as headerHtml, at the bottom. This is where page numbering belongs.

The trap

Same two traps: inline styles only, and it needs a bottom margin. The class names are exact — <span class="pageNumber"></span> and <span class="totalPages"></span>, and a typo produces an empty footer rather than an error.

Example

curl -X POST https://api.pdfcraft.dev/v1/render \
  -H "Authorization: Bearer $PDFCRAFT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "html": "<h1>hello</h1>",
    "options": {
      "margin": {
        "bottom": "20mm"
      },
      "footerHtml": "<div style=\"font-size:9px;width:100%;text-align:center;color:#666\">Page <span class=\"pageNumber\"></span> of <span class=\"totalPages\"></span></div>"
    }
  }' \
  --output out.pdf

Every option

• format — Paper size. Ignored if the page CSS declares its own @page size.
• landscape — Rotate the paper to landscape orientation.
• margin — Page margins. Any side may be omitted; omitted sides default to 0.
• scale — Rendering scale factor.
• printBackground — Print background colours and images. Off by default in browsers; on by default here.
• pageRanges — Subset of pages to keep, e.g. "1-5" or "1,4,7-9". Empty means all pages.
• headerHtml — HTML for the running header. Supports Chromium print classes: date, title, url, pageNumber, totalPages. Needs a top margin to be visible.
• footerHtml — HTML for the running footer. Same classes as headerHtml; needs a bottom margin.
• waitFor — Conditions to satisfy before the PDF is taken. All of them apply, in order.
• emulateMedia — Which CSS media type the page sees.
• timeoutMs — Hard ceiling on the whole render. Exceeding it returns 408 render_timeout.

Try any of these in the playground without writing a line of code, or read the full reference.