Skip to contentPostalForm
Resources
Postcard PDF guidelines
Use this page when you are creating a fully composed postcard PDF for PostalForm's API or machine payment endpoints.
Published Apr 13, 2026 • Updated Apr 17, 2026
Required canvas sizes
postcard_size="4x6"requires a6.25in x 4.25inbleed canvas on both pages.postcard_size="6x9"requires a9.25in x 6.25inbleed canvas on both pages.postcard_size="11x6"requires a11.25in x 6.25inbleed canvas on both pages.
These are bleed dimensions, not trim-only dimensions. Do not upload a 6.00in x 4.00in or 9.00in x 6.00in PDF and assume PostalForm will expand it for you.
Layout rules
- Keep all critical artwork, logos, and text inside your own safe area.
- Keep the mailing side clean enough for address placement, postage or indicia, and barcode handling.
- In PostalForm's template downloads, page 1 is the artwork/front guide and page 2 is the current Lob mailing-side guide for that size.
- Do not typeset sender/recipient names or mailing addresses into the postcard PDF. Provide sender/recipient data in the order fields instead.
- Do not invert the page order. PostalForm treats page 1 as the artwork side and page 2 as the mailing side.
- On page 2, leave Lob's reserved mailing block clear. Lob prints the address, indicia, and barcode there.
- If you include a message on page 2, keep it out of Lob's reserved mailing block.
Template downloads
Each download remains a 2-page PDF so you can keep the same PostalForm upload flow:
- Page 1 keeps the existing front-side bleed, trim, and safe-area guide.
- Page 2 matches Lob's current postcard mailing-side template for that size.
API usage
Use the same machine endpoints you already use for letters. The only additions are:
mailpiece_type: "postcard"postcard_size: "4x6" | "6x9" | "11x6"
Your pdf field should point to the final 2-page postcard PDF itself, using the same accepted PDF input formats as letter uploads.