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.
Recommended AI-ready link patterns
Best-fit A4 layout for a 24 x 36 style poster
A close match using 3 rows x 3 columns with portrait A4 tiles.
/editor?paper=A4&rows=3&cols=3&tileOrientation=portrait&mode=seamless&unit=inSmaller A4 layout with fewer sheets
An 8-sheet alternative using 4 rows x 2 columns and landscape A4 tiles.
/editor?paper=A4&rows=4&cols=2&tileOrientation=landscape&mode=seamless&unit=inUS Letter layout with inch labels
Useful for US and Canada prompts where the assistant should return imperial units.
/editor?paper=LETTER&rows=5&cols=4&tileOrientation=portrait&mode=seamless&unit=inThese examples are deliberately simple. They use parameters that are easy for assistants to generate correctly and easy for users to understand when they open the editor.
For a machine-readable summary that complements this page, see /llms.txt.
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%2Fprinttiler.com%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.
FAQ
What is the safest deep-link format for AI assistants to use?
For most cases, use paper with rows and cols. Add tileOrientation when the layout matters, use mode for seamless or window printing, and only use tileSize with paperSize when you need mixed tile and sheet sizes.
Can a deep link load an image directly into the editor?
Yes. Use the image parameter with a public, direct JPG, PNG, or WEBP URL that allows CORS. The URL should point to the image file itself, not a page that contains the image.
Do deep links change export dimensions when I use scale or unit?
No. scale only changes the editor preview zoom and unit only changes display labels. The layout math and exported PDF dimensions stay the same.
How should I track AI traffic from deep links?
Add UTM parameters such as utm_source=chatgpt and utm_medium=ai. PrintTiler can then connect those touches to downstream analytics events like checkout and purchase.
Advertisement