Skip to main content
QR Health Center is a single page that surfaces problems across every QR code on your account — codes outside their active schedule, unpublished drafts, broken form links, and incomplete domain verification — so you don’t have to check each QR code individually. Open it from /qr/health, or via the Health Center button in the QR Codes list header. Previously, diagnosing “my QR code isn’t working” meant checking three separate places — the QR list, the forms module, and custom domain settings. Health Center runs those checks across your whole account and presents everything on one screen, ranked by how much real traffic each problem is costing you.
QR Health Center overview showing a healthy summary bar, five metric cards (Critical, Warnings, Needs Review, Healthy, Paused by User), an Open Issues table, and a Health Monitor section with five check cards

QR Health Center, showing a live account with open issues

​
Overview and metrics

At the top, a summary bar shows the percentage of your QR codes currently healthy, out of your total count, alongside your total lifetime scans. The bar is colour-coded: Below it, five metric cards break the same picture down by category:
  • Critical — the highest-risk live issues.
  • Warnings — needs action soon.
  • Needs Review — operational cleanup, lower urgency.
  • Healthy — QR codes with no open issue.
  • Paused by User — intentionally deactivated QR codes, excluded from the issue counts above (a paused QR code isn’t “unhealthy,” it’s just off on purpose).
The five cards are not designed to add up to your QR code total. Critical, Warnings and Needs Review count issues; Healthy and Paused by User count QR codes. A single QR code can carry more than one issue at the same time.

​
The open issues table

Below the metrics, a filterable, searchable table lists every open issue: which QR code (name and ID), its severity, the issue type and a short description, its lifetime scan count, and a View issue button. Filter by Severity or Issue type, or search by QR code name, QR code ID, owner, or issue text. Each filter label carries a count, so you can see the shape of your problems before applying anything. Issues are sorted Critical → Warning → Needs Review, and within each tier by scan volume, highest first. The top row is therefore always the costliest problem on the account — which is exactly where the Open top issue button jumps to. Click View issue to open a detail drawer for that specific QR code:
Issue detail drawer showing why the issue surfaced (Draft not published, Category, Owner, Draft saved and Published live timestamps), what to do next as a checklist, and traffic context with created/updated timestamps

Issue detail drawer for a single QR code

The drawer is organized into three sections:
  • Why this issue surfaced — the reason code, category, owner, and issue-specific fields (for example, draft-saved and published-live timestamps for a publishing issue, or CNAME/TXT verification status for a domain issue), plus a plain-language impact statement.
  • What to do next — a short resolution instruction and a checklist of the specific conditions the health check found.
  • Traffic context — the QR code’s relative visit weight and created/last-updated timestamps, so you can judge how urgent a fix really is.
An Open QR details button in the drawer footer takes you straight to that QR code.

​
Health monitor: the underlying checks

Further down, the Health monitor section lists the individual live checks Health Center runs, each as its own card. Each card shows how many QR codes it currently affects, or “All clear” if none. Click any card to open a drawer describing what that specific check looks for and listing the affected QR codes (or confirming none are affected):
Monitor signal drawer for the Schedule check, showing 'What this check looks for: Flags QR codes that are currently outside their live schedule' and an empty state reading 'No QR codes are affected'

A monitor-signal drawer for a check with nothing currently flagged

Health Center refreshes on demand — use the Refresh button in the header rather than reloading the page, and the “Refreshed” timestamp next to the page title tells you how current the data is.

​
How severity is calculated

Severity is not a fixed scan threshold. It is calculated against your own account’s traffic distribution, so the ranking stays meaningful whether you have 50 scans or 500,000. The principle: a problem is urgent in proportion to how many real people it affects. A broken QR code nobody scans is housekeeping. A broken QR code carrying most of your traffic is an emergency. How the ranking is built:
  1. Every active QR code’s lifetime scan count is collected.
  2. Only QR codes with actual traffic shape the distribution, so a large number of zero-scan codes can’t drag the thresholds down artificially.
  3. Your account’s own median and top-tier cut-offs are calculated from that set.
  4. Each flagged QR code is placed against those cut-offs to get its severity.

​
Two deliberate refinements

Small accounts are capped at Warning. Until an account has at least ten QR codes carrying real traffic, there isn’t enough data to rank fairly — so no issue is raised to Critical. This is why a new or lightly-used account often sees mostly Needs Review and Warning issues rather than a wall of red.
Draft not published never escalates to Critical. A stale draft doesn’t break a scan — the visitor simply sees older content — so it is capped at Warning even on your busiest QR codes, and never outranks a genuinely broken experience.

​
Scope and access

  • Paused QR codes are excluded from every check. Pausing is treated as a deliberate decision, so a paused code never generates an issue. It still appears in your account totals as Paused. Resume it to bring it back under monitoring.
  • The page adapts to your permissions. If your role doesn’t have access to Forms or Custom Domains, you simply see fewer checks — the page loads and works normally with the remaining ones. This is why a colleague may see more checks than you do.
  • Anyone who can view QR codes can open Health Center.

​
Empty and edge-case states

Health Center adapts its messaging to your account’s actual situation rather than showing a generic empty table:
  • No QR codes yet — the page invites you to create your first one instead of showing an empty issues table.
  • Everything paused — Health Center explains that paused codes are excluded from issue counts by design, with a link back to the QR list.
  • All clear — if you have QR codes and none currently have an open issue, the page confirms your account is healthy and offers quick links to the QR list, forms, or domains depending on what you have access to.
  • Filters exclude everything — if your search or filter combination matches no issues, the page prompts you to widen the search rather than reading as “no problems found.”
  • QR code scheduling — the activation/deactivation rules behind the Schedule health check.
  • Custom domains — CNAME/TXT verification is what the Domain verification health check monitors.
  • Publishing — draft vs. live state is what the Draft publishing health check compares.
  • Building a form — broken form links are what the Form link health check flags.