Skip to main content

Find out what is accepted

Rather than guessing at values, ask:
This returns the valid patterns, corner styles, shapes and frames. An invalid value returns 400 with INVALID_PARAMETER.

The fields

For a gradient background, set background_style and background_color_secondary. For no background at all, is_transparent_background=true — useful over a printed design, risky over a busy one.
Or text instead of an image with center_logo_text.
A frame with a short instruction measurably improves scan rates in print — people need to be told the code is for them.

Staying scannable

QR codes tolerate damage, which is what lets you put a logo in the middle. That tolerance is finite, and three things spend it:
The pattern must be substantially darker than the background. Light grey on white looks refined and fails in poor lighting, which is most of the places a QR code gets scanned.Dark pattern on light background. Inverting — light pattern on dark — is rejected outright by some scanners.
Around 3rem is a reasonable ceiling. A logo past that eats the error correction budget, and the first thing to fail is a code that is slightly dirty, slightly creased, or scanned at an angle — in other words, a real one.
The destination is encoded in the pattern, so a long URL means finer detail, which means a larger print size to stay readable. A short back half is not just tidier, it is a smaller printable code.
Test the actual exported file, at the actual size, on a phone that is not yours. A code that scans from your screen at 400px may not scan from a poster at arm’s length.

Consistent styling across a set

Keep the style in one place and spread it across every call:
Restyling later is safe — printed codes keep working, because the encoded URL does not change.