How do I put QR scan pages on my own domain (white label)?

What white labelling actually changes

A dynamic QR code encodes a URL, and that URL is what a phone shows in the notification before anyone taps. White labelling replaces our hostname in that URL with yours.

• New dynamic QR codes created in the workspace encode https://verify.yourbrand.com/qr/….
• Codes you already created keep their qrcodestack.com URLs. Both hostnames resolve to the same pages, so nothing printed stops working.
• Only that workspace's QR codes are served on your domain. Any other path returns a 404, so nobody else's links can borrow your domain's reputation.
• The HTTPS certificate is issued in your domain's name, so the padlock is yours too.

For the wider case for it, see the white-label QR code generator page.

Before you start

• Plan: Business. The card shows "White-label scan pages are a Business feature" on other plans.
• Role: admin or owner. Editors can connect a branded short-link domain but not a scan-page domain.
• One per workspace. A workspace can have exactly one white-label scan domain. To change it you remove the current one first. This is a different allowance from branded short-link domains, where Business includes five.
• Use a subdomain such as verify., scan. or go. — the setup needs a CNAME, which most DNS providers only allow below the root.
• Choose it carefully. The hostname ends up printed on packaging and posters, so treat it as a naming decision, not a technical one.

Steps: connect the domain

1. Open Custom Domains from the sidebar and scroll to White-label scan pages.
2. Type the hostname into Hostname and click Connect domain.
3. Add both records shown below at your DNS provider. Each value has a Copy button.
4. Click Verify DNS. The badge moves Waiting for DNS to Issuing certificate to Active.
5. Create a new dynamic QR code and confirm the URL it encodes starts with your hostname.

After it goes active

• Every dynamic QR code made from then on encodes your hostname. Generate fresh artwork for anything you are about to print — an existing downloaded image still carries the old URL.
• Remove disconnects the domain immediately. Codes that encode it stop resolving on that hostname, although their qrcodestack.com URLs keep working. Do not remove a domain that is already in print.
• Static QR codes are unaffected: they carry their content directly and never touch a domain of ours or yours.

Common problems

I get a red error instead of an upgrade prompt

On Starter and Pro the card can show the plain message "Custom domains require the Business plan." rather than an upgrade panel. It means the same thing: this feature is on Business.

Stuck on Waiting for DNS

Both records have to be right at the same time, and the TXT name includes the full hostname: _qrcs-challenge.verify.yourbrand.com. Many DNS providers append the zone automatically, in which case enter only _qrcs-challenge.verify. Give changes time to propagate before re-checking.

"This workspace already has a custom domain"

Only one scan-page domain is allowed per workspace. Remove the existing one before adding another — and remember any code already printed with it will stop resolving on that hostname.

Scanning my domain shows a 404

Your domain only serves this workspace's QR codes. A code created in a different workspace, or an old code created before the domain went active, resolves on qrcodestack.com instead.

Frequently asked questions