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.
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.
- 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 | Safe default for simple links. |
| tileSize | Tile size for the poster grid. | A3-A10 | Advanced: use with paperSize for mixed layouts. |
| paperSize | Print paper size for output sheets. | A3, A4, A5 | Advanced: use with tileSize for mixed layouts. |
| 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. |
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.
scale changes only the editor preview zoom. It does not affect export dimensions.
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=landscapeUTM 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.