# QR code poster, table tent and card templates

Put a styled QR code on a poster, table tent, WiFi card, business cards or stickers, or see it in a mockup.

The code is drawn by the same renderer as every other QR tool and placed on the page as it is, at a size the result reports in millimeters. A print template warns when its modules would be too small to scan.

- Endpoint: `POST https://setget.net/v1/tools/qr-template` with JSON `{"input": {...}}`
- MCP: `run_tool` with `slug` = `qr-template`
- Page: https://setget.net/tools/qr-template

## Inputs

- `text` (required, string): The text or link to store in the code. For the WiFi card, the "text" of the WiFi QR tool's result.
- `template` (optional, string, one of `poster`, `table-tent`, `wifi-card`, `business-cards`, `stickers`, `mockup-poster`, `mockup-phone`, `mockup-tent`, `mockup-card`, `mockup-sticker`, default `"poster"`): The page to make. Print templates come out at their real size: poster, table-tent (fold the page in half), wifi-card, business-cards (ten to a sheet) and stickers (twelve to a sheet). The mockup templates are pictures of the code in use.
- `title` (optional, string): The headline, or the name on a business card. Left out, the template uses its own words ("Scan me", "Wi-Fi"); give an empty text for none.
- `subtitle` (optional, string): The line by the code, or the job title on a business card. Left out, the template uses its own words.
- `details` (optional, string): More lines, one per line: opening hours, an address, a phone number. On the WiFi card write "Label: value" lines, or leave this out and the network name and password are read from the code itself.
- `page` (optional, string, one of `a4`, `letter`, default `"a4"`): Paper size of the print templates.
- `accent` (optional, string, default `"#1d4ed8"`): The color of the template's bands and highlights.
- `paper` (optional, string, default `"#ffffff"`): The color of the page or card.
- `error_correction` (optional, string, one of `L`, `M`, `Q`, `H`): How much damage the code survives: L about 7%, M 15%, Q 25%, H 30%. Higher levels hold less. Left out: M, or H when there is a logo.
- `module_size` (optional, integer, default `8`, range 1..40): Width of one small square (module) in pixels.
- `margin` (optional, integer, default `4`, range 0..20): Blank quiet zone around the code, in modules. Scanners expect at least 4.
- `foreground` (optional, string): Color of the dots: hex such as #000000, a basic color name, or a CSS linear-gradient(...) or radial-gradient(...). Left out: black.
- `background` (optional, string): Color behind the code: hex, a basic name, "transparent", or a CSS gradient. Left out: white.
- `preset` (optional, string, one of `classic`, `rounded`, `liquid`, `dots`, `ocean`, `sunset`, `forest`, `grape`, `candy`, `ink`, `gold`, `midnight`): A ready-made look. Any style input you set yourself wins over the preset.
- `dot_style` (optional, string, one of `square`, `rounded`, `liquid`, `dots`, `diamond`, `star`, `vertical`, `horizontal`, `leaf`, `mosaic`, `plus`, `hexagon`, `heart`, `maze`): Shape of the small squares (modules). Left out: square.
- `dot_scale` (optional, number, range 0.5..1): Size of each dot within its square, from 0.5 to 1. Thin shapes need more, such as diamond 0.7 and star 0.95 (the error names the least); liquid always fills its square.
- `eye_frame_style` (optional, string, one of `square`, `rounded`, `extra-rounded`, `circle`, `leaf`, `dotted`): Shape of the outer ring of the three corner eyes.
- `eye_ball_style` (optional, string, one of `square`, `rounded`, `circle`, `diamond`, `leaf`, `octagon`): Shape of the solid middle of the three corner eyes.
- `eye_colour` (optional, string): Color of the eye rings. Left out: the dot color.
- `eye_ball_colour` (optional, string): Color of the middle of the eyes. Left out: the eye ring color.
- `eye_colours` (optional, string): A color for each eye, separated by commas, in the order top-left, top-right, bottom-left: for instance "#b91c1c, #1d4ed8, #15803d". Plain colors only. An eye left out, or left empty between commas, keeps eye_colour.
- `corner_radius` (optional, number, range 0..0.5): Rounds the corners of the background, as a fraction of its side.
- `shape` (optional, string, one of `square`, `circle`, `squircle`, `octagon`, `hexagon`, `shield`, `bubble`, `heart`): Outline of the whole code: square, or a silhouette such as circle or heart. The code itself stays a complete square inside it, behind a clear ring as wide as margin, and matching dots fill the rest of the outline. Left out: square.
- `logo` (optional, string): A picture for the middle of the code, as a data: URI (PNG, JPEG, WebP, GIF or SVG, up to about 290 KB).
- `logo_size` (optional, number, range 0.1..0.4): Largest logo width as a fraction of the code, from 0.1 to 0.4. It is made smaller when the code would not scan. Left out: 0.22.
- `logo_padding` (optional, number, range 0..3): Clear space around the logo, in modules. Left out: 1.
- `logo_shape` (optional, string, one of `none`, `square`, `rounded`, `circle`): Shape of the clear area behind the logo. "none" leaves the background showing.
- `logo_background` (optional, string): Color of the clear area behind the logo. Left out: the background color.
- `logo_text` (optional, string): One to four characters for the middle of the code in place of a picture, such as initials. Drawn as outlines in the frame font, so they look the same everywhere.
- `logo_icon` (optional, string, one of `heart`, `star`, `wifi`, `phone`, `mail`, `link`, `home`, `pin`, `cart`, `bag`, `camera`, `music`, `calendar`, `person`, `globe`, `lock`, `gift`, `cup`, `bolt`, `chat`, `play`, `info`, `tag`, `book`): A small symbol for the middle of the code in place of a picture.
- `logo_colour` (optional, string): Color of the center text or symbol. Left out: the eye color.
- `background_image` (optional, string): A photo shown behind the code, as a data: URI (up to about 440 KB). The dots are drawn over it so the code still scans.
- `background_image_wash` (optional, number, range 0..0.9): How much the photo is lightened, from 0 to 0.9. Left out: 0.35.
- `frame` (optional, string, one of `none`, `label`, `banner`, `banner-top`, `rounded`): A border with a short call to action under (or above) the code.
- `frame_text` (optional, string): The words in the frame. Left out: SCAN ME.
- `frame_colour` (optional, string): Color of the frame. Left out: the dot color.
- `frame_text_colour` (optional, string): Color of the frame text. Left out: whichever of dark or light reads best.
- `frame_font` (optional, string, one of `sans`, `mono`): Letter style of the frame text.

## Example 1: A poster

```json
{"input":{"text":"https://setget.net","template":"poster","title":"Order from your table","preset":"ocean","accent":"#0c4a6e"}}
```

## Example 2: A WiFi card that prints the network name and password

```json
{"input":{"text":"WIFI:T:WPA;S:Cafe Luna Guests;P:espresso2026;;","template":"wifi-card"}}
```

## Example 3: A mockup: the code on a phone

```json
{"input":{"text":"https://setget.net","template":"mockup-phone","preset":"grape","accent":"#6d28d9"}}
```

**How do I print it?** This tool shows the page. The QR print tool makes the same page as a PDF at its real size, or as a PNG. Print at 100 percent ("actual size"), not "fit to page".

**How does the WiFi card know my network?** It reads the network name and password out of the code's own text, so what is printed can never disagree with the code. Make the text with the WiFi QR tool, or write your own lines in details.

**Which letters can the text use?** Latin with every accent, Greek and Cyrillic, digits and common punctuation. Text is drawn as outlines, so it prints the same everywhere; a character that cannot be drawn is reported, never replaced.

**Are the mockups for printing?** No. A mockup is a picture of the code in use, for a slide or a post. Print the poster, tent, card or sticker templates instead.

**Does the code expire or track scans?** No. The content is stored in the picture itself, so the code works forever. Nothing is redirected or counted, and nothing needs an account.

**Can I add a logo, colors or rounded dots?** Yes. Every QR tool takes the same style inputs: dot and eye shapes, colors and CSS gradients, a logo, a background photo, a frame with text, and ready-made presets. Unstyled codes stay exactly as they always were.
