QR Codes - Autype

Autype can embed QR codes in your documents using the :::qrcode directive. QR codes are rendered as images in the exported document.

URL QR Code

:::qrcode{type="url" size=150 align=center}
https://example.com
:::

You can also use the url: prefix:

:::qrcode{type="url" size=200}
url: https://docs.autype.com
:::

Both formats are equivalent. If the content doesn’t start with url:, the entire first line is used as the URL.

WiFi QR Code

Generate a QR code that lets users connect to a WiFi network by scanning:

:::qrcode{type="wifi" size=200}
ssid: MyNetwork
password: secret123
encryption: WPA
:::

WiFi fields

Field	Required	Values	Description
`ssid`	Yes	String	Network name
`password`	No	String	Network password
`encryption`	No	`WPA`, `WEP`, `nopass`	Encryption type
`hidden`	No	`true`, `false`	Whether the network is hidden

Example: Guest WiFi

:::qrcode{type="wifi" size=150}
ssid: GuestWiFi
password: guest2024
encryption: WPA
hidden: false
:::

vCard QR Code

Generate a contact card QR code:

:::qrcode{type="vcard" size=180}
firstName: John
lastName: Doe
organization: Acme Corp
phone: +1-555-123-4567
email: john.doe@example.com
url: https://johndoe.com
address: 123 Main St, City, Country
:::

vCard fields

Field	Required	Description
`firstName`	No	First name
`lastName`	No	Last name
`name`	No	Full name (auto-split into first/last)
`phone`	No	Phone number
`email`	No	Email address
`organization`	No	Company / organization name
`url`	No	Website URL
`address`	No	Physical address
`note`	No	Additional note

The name field is a shortcut that splits on the first space into firstName and lastName. Use firstName and lastName separately for more control.

Minimal vCard

:::qrcode{type="vcard"}
firstName: Jane
lastName: Smith
email: jane@company.com
phone: +49-123-456789
:::

Text QR Code

Encode arbitrary text without treating it as a URL:

:::qrcode{type="text" size=180 caption="Scan for details"}
Any text payload
:::

Attribute reference

Attribute	Values	Description
`type`	`url`, `wifi`, `vcard`, `text`	QR code type (required)
`size`	Number (pixels)	Size of the QR code image
`errorCorrection`	`L`, `M`, `Q`, `H`	Error correction level
`align`	`left`, `center`, `right`	Horizontal alignment
`caption`	String	Optional caption below the QR code

Error correction levels

Level	Recovery	Best for
`L` (Low)	~7%	Clean environments, maximum data capacity
`M` (Medium)	~15%	Default, good balance
`Q` (Quartile)	~25%	Moderate damage tolerance
`H` (High)	~30%	Printed materials that may get damaged

If no size is specified, the QR code renders at a default size. For print documents, use size=200 or larger for reliable scanning.

​URL QR Code

​WiFi QR Code

​WiFi fields

​Example: Guest WiFi

​vCard QR Code

​vCard fields

​Minimal vCard

​Text QR Code

​Attribute reference

​Error correction levels

URL QR Code

WiFi QR Code

WiFi fields

Example: Guest WiFi

vCard QR Code

vCard fields

Minimal vCard

Text QR Code

Attribute reference

Error correction levels