Direct mail for growth teams, with an API underneath. Read the docs →
All templates

Seasonal lookbook flat mailer template

An 11x17 sheet folded to 8.5x11: a cover, four new arrivals inside and a code to use on them. Mailed when a collection drops.

Flat · 11x17 inTriggerShopify · collections/createtmpl_lookbook
  • Bleed 0.125 in
  • Trim 11×17 in
  • Safe area
  • Keep clear
Front
Back (address side)

Folds in half at 8.5 in, to 11×8.5 in. The front is the inside spread. On the back, the top half is the mailing panel and the bottom half is the cover, printed upside down on purpose so it reads upright once folded.

Mailr prints

On every piece, in our layout. You send the data, not the design.

  • The recipient’s name and address from to, in our font, inside the address panel at the top right of the back.
  • Your return address from from (required), at the top of the address panel.
  • Postage and the USPS Intelligent Mail barcode, inside the address panel.

You can add

In your own style, outside the keep-clear zones.

  • Your logo, colors, fonts and images anywhere outside the address panel (PNG or JPG at 300 DPI; fonts as TTF, WOFF, WOFF2 or Google Fonts; all on public https URLs).
  • Your own business address, phone or website in your own style. On the back keep it outside the address panel; on the front keep it out of the top half, or use light text on a dark background.
  • A full letter’s worth of copy: the whole front and most of the back are yours.
  • Personal touches from merge fields: first name, offer codes, product names, links. Any {{tag}} you add is filled from merge.
  • A QR code at least 1 in wide, inside the safe area and outside the address panel.

Don’t add

USPS can reject it, or it gets covered.

  • Stamps, permit imprints, “postage paid” or “nonprofit org.” marks, or anything that looks like them. Mailr prints the right indicia for the mail class.
  • Barcodes that look like USPS barcodes.
  • The recipient’s address anywhere else on the flat.
  • Sensitive personal data: account numbers, amounts, health or money details. It mails without an envelope, so anyone handling the flat can read it.
  • Crop marks or printer marks.
  • Anything inside the address panel. A white box is printed over it.

Design files

Print-ready HTML your agent can fetch, copy into your repo and edit. Keep the page size, the safe area and the keep-clear zones.

  • template.jsonSizes, bleed, safe area, keep-clear zone and merge-field limits. Agents read this first.Open
  • front.htmlFront at true size (11.25×17.25 in with bleed), with merge tags.Open
  • back.htmlBack at true size. The address panel (top right) is left blank.Open

Agent prompt

Paste it into Claude Code, Cursor or Codex. It points your agent at the files above.

Add the Mailr "Seasonal lookbook" flat to this app.

Measurements (inches; the HTML is laid out at 96 px per inch):
- Trim 11 × 17 in. Each page with bleed is 11.25 × 17.25 in (1080 × 1656 px). Bleed 0.125 in on every side.
- Safe area: keep text and logos 0.125 in inside the trim (0.25 in from the page edge).
- Keep clear on the back: 4 × 2.375 in at 6.75 in from the left and 0.25 in from the top of the trim. Mailr prints the addresses, postage and barcode there.
- Fold: the sheet folds in half at 8.5 in from the top of the trim, to 11 × 8.5 in. Keep text 0.25 in away from the fold. The back's top half is the mailing panel; its bottom half is the cover, laid out upside down so it reads upright when the folded piece is turned over.
- Text 8pt or larger. Images at 300 dpi for their printed size.
- Merge field limits: first_name 14, promo_code 12 characters.

1. Read the spec first: https://mailr.dev/templates/tmpl_lookbook/template.json
   It has the trim size, bleed, safe area, the keep-clear zone and a max_length for every merge field.
2. Design files (print-ready HTML at true size, with {{merge}} tags):
   https://mailr.dev/templates/tmpl_lookbook/front.html
   https://mailr.dev/templates/tmpl_lookbook/back.html
   To use the design as-is, send template: "tmpl_lookbook".
   To change it, save both files in this repo (mail/tmpl_lookbook/), edit them, keep the page size, bleed, safe area,
   keep-clear zone and merge tags, and send the HTML as front and back instead of template.
   Follow "content" in the spec: Mailr prints the recipient address, return address (from), postage and barcode,
   so never draw those in the design. Logos, fonts, images, QR codes and your own contact details are fine.
3. Trigger: when a new seasonal collection is published (Shopify collections/create).
4. Call POST https://api.mailr.dev/v1/flats with size: "11x17", to: the customer's mailing address,
   from: this business's return address (required; set it once in config),
   and merge: { first_name, promo_code } from the customer record. Check each value against max_length before sending.
5. Auth: Authorization: Bearer <MAILR_API_KEY>, read from the MAILR_API_KEY environment variable.
6. Save the returned id on the customer so the same person is never mailed twice for the same event.
7. Check delivery with GET https://api.mailr.dev/v1/flats/{id} (status and events; webhooks are not available yet).

API reference for agents: https://mailr.dev/llms.txt

Print spec

Trim size
11 × 17 in, portrait
Bleed
0.125 in on every side (page 11.25 × 17.25 in)
Safe area
0.125 in inside the trim
Keep clear
4 × 2.375 in address panel at the top right of the back. USPS wants a flat’s address in the top half
Mails as
Flat: USPS flat rate, no envelope
Paper
100 lb silk cover, full color on both sides
Fonts
Inter (Google Fonts)
Endpoint
POST /v1/flats

Mailing a batch of these? See prices with postage included.

Merge fields

TagMaxExample
{{first_name}}14Theo
{{promo_code}}12WINTER15
START SENDING

Put your first postcard in the mail

Create a key, send a test to yourself, and check the proof before anything prints.

  • Postcards, flats and folded mailers
  • A proof before anything prints
  • Free test mode: nothing prints, nothing charges
  • A status for every piece

Download the template kit?

mailr-kit.zip · about 310 KB · 65 text files

Only HTML, JSON and Markdown files. No programs, scripts or macros, nothing that installs or runs.