Deep-link documentation
PrintTiler Deep Links
PrintTiler supports deep links that open the editor with a poster layout already configured. These links are safe to share and can be generated by AI assistants like ChatGPT, Claude, and Gemini.
Use deep links to prefill rows, columns, paper size, and print mode so anyone can open the editor and export a PDF in seconds.
You can also set unit=in to show inch-based preview measurements for US and Canada users.
Behavioral contract
- Deep links apply once on the first editor load. Reload to apply new parameters.
- Values persist like normal UI edits after the link is applied.
- Stripe return links with
paid=true&session_id=are ignored. - Missing parameters do not override defaults or your current settings.
- If
tileSizeis LETTER or LEGAL,paperSizeis forced to match. - Unknown parameters are ignored.
Allowed parameters
| Parameter | Description | Allowed values | Notes |
|---|---|---|---|
| image | Poster image URL to load into the editor. | JPG, PNG, or WEBP, <=20MB | Public direct file URL, CORS-enabled, URL-encoded. |
| paper | Sets both tileSize and paperSize (recommended). | A3, A4, A5, LETTER, LEGAL | Safe default for simple links. Use matching paper systems. |
| tileSize | Tile size for the poster grid. | A3-A10, LETTER, LEGAL | Advanced: use with paperSize for mixed layouts within the same paper system. Letter/Legal tiles force matching paperSize. |
| paperSize | Print paper size for output sheets. | A3, A4, A5, LETTER, LEGAL | Advanced: use with tileSize for mixed layouts within the same paper system. paperSize is overridden when tileSize is Letter or Legal. |
| rows | Number of tile rows. | 1-20 | Rounded to whole numbers and clamped to limits. |
| cols | Number of tile columns. | 1-20 | Rounded to whole numbers and clamped to limits. |
| tileOrientation | Tile orientation for each grid cell. | portrait, landscape | Alias: orientation. |
| mode | Print mode for trimming and margins. | seamless, window | Alias value: windowpane -> window. |
| scale | Preview zoom level (does not affect export size). | fit, 100, 150, 1.5 | Advanced: numeric values or percentages may work. |
| unit | Preview measurement unit. | mm, in | Optional. Controls display labels only; export dimensions remain unchanged. |
For simple links, use paper with rows and columns. For advanced layouts, set tileSize and paperSize separately. If both are supplied, the explicit values win.
PrintTiler blocks ISO and US paper mixing by default. Use A-series tiles with A-series paper, or Letter/Legal tiles with Letter/Legal paper.
scale changes only the editor preview zoom. It does not affect export dimensions.
unit changes preview labels only. Layout math and PDF output remain the same.
Image rules
- Use a public, direct image URL (not a page or share link).
- Supported formats: JPG, PNG, WEBP.
- Maximum file size is 20MB.
- The image host must allow CORS for your link to load.
- URL-encode the image value when building links.
Examples
Simple seamless poster
A4 tiles and print paper, 6x6 grid.
/editor?paper=A4&rows=6&cols=6&mode=seamlessWindow pane layout
A3 tiles, 4x4, window mode for clean borders.
/editor?paper=A3&rows=4&cols=4&mode=windowWith a hosted image
Loads the image and fits it to the poster grid.
/editor?image=https%3A%2F%2Fprint-tiler.vercel.app%2Fposter-real.png&paper=A3&rows=4&cols=4&mode=window
Advanced mixed sizing
A6 tiles printed on A4 paper, landscape orientation.
/editor?tileSize=A6&paperSize=A4&rows=8&cols=6&tileOrientation=landscapeUS Legal layout
Legal tiles and paper, 3x3 grid.
/editor?paper=LEGAL&rows=3&cols=3&tileOrientation=portraitInch display for preview
Open the editor with inch labels for US/Canada style planning.
/editor?paper=LETTER&rows=4&cols=3&unit=inUTM attribution example
Track AI traffic in GA4 with UTM parameters.
/editor?paper=A4&rows=4&cols=4&utm_source=chatgpt&utm_medium=ai&utm_campaign=printtilerPlan sizes with the reference table
Need to calculate exact poster dimensions or sheet counts? Use the Paper Tile Size Table to preview layouts before you generate a deep link.
Attribution and tracking
Add UTM parameters to measure AI referrals in GA4. Example:
/editor?paper=A4&rows=4&cols=4&utm_source=chatgpt&utm_medium=ai&utm_campaign=printtilerFor AI-specific guidance, visit /ai.
Advertisement