Reference
PDF page sizes, with real dimensions and margins
A document on screen is a scroll. A document on paper is a fixed rectangle, usually with a machine behind it that expects that exact rectangle. Each page below has the dimensions in millimetres, inches, points and pixels, the margin the printer actually needs, and the CSS that produces the page box.
Six of these are named formats the render API accepts directly. The rest are set in the document itself, which is a supported path rather than a workaround: see setting the page size in CSS, or the full paged media reference. For a complete document already set to one of these sizes, see the document templates. For the label sizes in particular, the thing most likely to go on them is a code, and barcodes that still scan on paper covers the quiet zones those need.
ISO A series
A4 is the default page for business documents everywhere except North America, and the default this API uses when no format is given.
A3 is two A4 sheets side by side, and it is what a document becomes when a table stops fitting.
A5 is half an A4 sheet, and the right size for a document that is short enough that A4 looks empty.
A6 is postcard size, a quarter of an A4 sheet, and the smallest ISO size that still holds a paragraph comfortably.
ISO B5 sits between A5 and A4, and it is the standard book block size across much of Europe and Asia.
North American sizes
Letter is 8.5 by 11 inches and it is the default page in the United States, Canada, Mexico, Chile and the Philippines.
Legal is 8.5 by 14 inches: Letter width with three extra inches of height, used for contracts and court documents.
Tabloid is 11 by 17 inches, which is two Letter sheets side by side, and it is the North American equivalent of A3.
Half Letter is 5.5 by 8.5 inches, the North American answer to A5, made by cutting a Letter sheet across its long side.
Executive is 7.25 by 10.5 inches, a narrower and slightly shorter Letter used for company stationery and internal memos.
Labels
The 4 by 6 inch label is the standard thermal shipping label accepted by every major carrier, and the most common non-paper page size an API renders.
The 4 by 4 inch square label is the fulfilment and compliance label: shorter than a shipping label, same print head width.
89 by 36 millimetres, or 3.5 by 1.4 inches, is the standard single address label on a desktop label printer.
Receipt rolls
- 80mm receipt rollSet in CSS
The 80mm roll is the standard point-of-sale receipt: 80 millimetres of paper, a printable width of about 72mm, and a length that depends on the order.
- 58mm receipt rollSet in CSS
The 58mm roll is the narrow receipt used by mobile and handheld printers, with a printable width of roughly 48mm.
Cards and badges
85.6 by 53.98 millimetres is the ID-1 rectangle: the size of a bank card, and the business card standard across most of the world.
The 4 by 3 inch insert is the standard conference badge: the size that fits a lanyard holder and is readable from across a room.
Envelopes
DL is 220 by 110 millimetres, the standard business envelope in Europe, and it takes an A4 sheet folded in three.
C5 is 229 by 162 millimetres and it holds an A4 sheet folded once, or an A5 document flat.
The #10 envelope is 9.5 by 4.125 inches and it is the standard business envelope in the United States, taking a Letter sheet folded in three.
Label sheets
Thirty 2.625 by 1 inch labels in a 3 by 10 grid on a Letter sheet, which is the most common laser address label stock in North America.
Twenty-one 63.5 by 38.1 millimetre labels in a 3 by 7 grid on A4, which is the standard European address label sheet.
Everything else
A US business check is 8.5 by 3.5 inches, and almost every constraint on it comes from the machine-readable line along the bottom.
A 16:9 slide is 338.67 by 190.5 millimetres, which is 1280 by 720 pixels at 96 to the inch, and it is the page to use when the PDF will be projected rather than printed.
- Custom dimensionsSet in CSS
Any page size at all is reachable by declaring it in the document's own CSS and asking the renderer to honour that page box rather than a named format.