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.
- When both
imageandsourceare provided,imagetakes precedence. - If an image or source cannot be imported, the editor still opens with all valid layout settings and shows an inline error in the Image panel.
Allowed parameters
| Parameter | Description | Allowed values | Notes |
|---|---|---|---|
| image | Direct public image URL to load into the editor. | HTTPS JPG, JPEG, PNG, or WEBP, <=20MB | Use only when the value points to the image file itself. Takes precedence over source. |
| source | Supported public page or share link from which PrintTiler imports one image. | Public Pinterest image Pin, pin.it short link, or ChatGPT image share | Use for a supported page or share link, not the image file itself. |
| 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
imagefor a public, direct HTTPS image URL (not a page or share link). - Use
sourcefor a supported page or share link. Supported sources are public Pinterest image Pins, including full Pin URLs andpin.itshort links, and public ChatGPT image shares. - Supported remote formats: JPG, JPEG, PNG, and WEBP.
- Maximum file size is 20MB.
- Private or login-protected shares, video Pins, multi-image Pins, GIFs, SVGs, and general webpages are not supported for remote import.
- URL-encode the value of
imageorsourcebefore inserting it into the PrintTiler URL.
Full Pin: https://www.pinterest.com/pin/972003532099124933/
Short Pin: https://pin.it/2FwBOu67O
ChatGPT image: https://chatgpt.com/s/m_...
Error behavior
PrintTiler keeps the entered link visible and shows an inline explanation if retrieval fails. A failed remote import never prevents valid paper, row, column, orientation, or mode parameters from loading.
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
Full Pinterest source
Imports the main image from a public Pinterest image Pin.
/editor?source=https%3A%2F%2Fwww.pinterest.com%2Fpin%2F972003532099124933%2F&paper=A3&rows=4&cols=4&mode=windowPinterest short source
Resolves a public pin.it short link before importing its main image.
/editor?source=https%3A%2F%2Fpin.it%2F2FwBOu67O&paper=A3&rows=4&cols=4&mode=windowAdvanced 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-assistant&utm_campaign=printtiler&utm_source_platform=openaiPlan 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-assistant&utm_campaign=printtiler&utm_source_platform=openaiFor 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 image with a public direct HTTPS JPG, JPEG, PNG, or WEBP URL. Use source instead for a public Pinterest image Pin, pin.it share link, or ChatGPT image share. PrintTiler imports remote images through its server, so the source image host does not need to expose browser CORS headers.
What happens when image and source are both present?
image takes precedence and source is ignored. This preserves the established image deep-link behavior for callers that add the new parameter accidentally.
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, utm_medium=ai-assistant, and utm_source_platform=openai. PrintTiler can then connect those touches to downstream analytics events like checkout and purchase.