QR maker app on Vareons: install, types, customization, and analytics
The QR maker app is the id qr-maker marketplace card opening /dashboard/qr-maker: it generates codes for seven content types with full visual customization, management, and analytics, and every saved code scans through a public /q/[id] page with scan tracking.
Last verified: 2026-09-19
The app installs from the /dashboard/apps marketplace with an Install button on the "QR Code Maker" card described as creating codes for products, pages, and offers, after which an Open button leads to /dashboard/qr-maker (with the short /dashboard/qr route working as an alias for the same page). The card carries a Free badge.
The maker page is titled "QR Code Maker" with a create-customize-track description, showing two stat cards — total QR codes and total scans — plus a StatsCard1 with active codes, total scans, average, and recent counts. Four tabs navigate it: Generate with a plus icon, Customize with a palette icon, Manage with a settings icon, and Analytics with a chart icon.
The Generate tab offers seven types — URL, text, email, phone, WiFi, vCard, and SMS — each with its fields (name, description, content, URL, text, email, subject, body, phone, network name, password, security, first and last name, organization, title), then a "Generate QR Code" button posting to POST /api/dashboard/qr-codes with the tenant and payload; on success it reloads the list, fetches the overview, and jumps to the Manage tab.
The Customize tab adjusts size from 100 to 1000, foreground and background colors, error-correction level (L, M, Q, or H), logo and its size, margin, and square pattern (square, circle, or rounded), then an update button saves through PUT. The Manage tab offers select, edit, and delete with a "No QR Code Selected" empty state, and editing opens an editor inside the Generate tab before saving back to Manage.
Codes are stored in the QRCode model with tenant, name, description, content, type, design settings, and an active, paused, or archived status plus scan count and last-scanned timestamp. On scan, visitors land on /q/[id] for saved codes (or the raw content for unsaved ones) with a tracking event raising the counter, and statistics render through GET /api/dashboard/qr-codes/analytics scoped by date range.
Setup steps in Vareons
Install the app from the marketplace
Open /dashboard/apps, press Install on the QR maker card, then press Open to reach /dashboard/qr-maker.
Generate a new code
From the Generate tab pick the type (URL, text, email, phone, WiFi, vCard, or SMS), fill the fields, then press Generate QR Code.
Customize the look
From the Customize tab set size, colors, error-correction level, logo, margin, and pattern to match your brand, then update.
Manage your codes
From the Manage tab select a code to edit or delete old ones; editing opens an editor, saves, and returns to Manage.
Track scans from analytics
From the Analytics tab review total codes, scans, active, and average figures by date range, and share the /q/[id] link for scanning.
Frequently asked questions
What content types does the QR maker support?
Seven types: URL, text, email, phone, WiFi, vCard, and SMS, each with dedicated fields in the Generate tab.
How is a saved code scanned?
Through a public /q/[id] page that opens the code content and records a scan event raising the counter and last-scan timestamp in analytics.
Can I add a logo inside the code?
Yes, from the Customize tab add the logo and set its size from 10 to 25, using a high error-correction level to keep it readable.
What is the difference between the qr-maker and qr paths?
No difference; /dashboard/qr is an alias opening the same page and data as /dashboard/qr-maker.
Can I pause a code temporarily?
Yes, code status supports active, paused, and archived; a paused code stops working without deleting its record and stats.
Troubleshooting
1) Generation fails: fill the type's required fields; the server rejects incomplete payloads. 2) Logo covers the code: shrink the logo size and raise error correction to Q or H. 3) Scans not recorded: make sure you share the saved code's /q/[id] link, not an old image. 4) Code not working: check its status; paused and archived codes stay inert until reactivated.
Important limitations
• Customization caps size at 100 to 1000 and margins at 20. • The logo is a base64 image stored with the code, so avoid huge files. • Analytics are basic scan counters without advanced geo breakdown. • Unsaved codes show raw content with no tracking.