Feature docs

QR Code Maker on Vareons for Egypt stores: create, customize, share and track scans

The QR Code Maker on Vareons is the merchant self-service tool for reusable marketing assets: it generates codes for seven content types, styles them with the store logo and colors, exports them for printing on packaging, stickers and flyers, then tracks every scan by device and country from the same workspace.

Last verified: 2026-09-20

The QR Code Maker on Vareons is managed from /dashboard/qr-maker and /dashboard/qr, both rendering the same page. It is a dashboard-protected route requiring QR-code permissions (view for listing and analytics, create for generation, edit for customization and status, delete for removal).

The workspace has four tabs. The Generate tab first shows the seven type cards — URL, text, email, phone, WiFi, contact (vCard) and SMS — each with a dedicated input form: email carries address, subject and pre-filled body; WiFi carries network name, password, security type and a hidden-network option; vCard carries name, company, title, phones, both emails, website and address. Then basic info is entered (required name up to 200 characters, optional description up to 500) and the code is created with the "Generate QR Code" button, which jumps automatically to the Manage tab.

The Customize tab works on the selected code and shows a live preview in three sizes (mobile, tablet, desktop) with PNG, SVG and PDF download buttons, content copy, and Web Share sharing. Customization is split into four sections: appearance (size 100–1000px, margin 0–20, square/circle/rounded pattern), colors (eight presets plus custom foreground and background), logo (image upload up to 5MB by drag or browse, size 10%–25% with error correction raised to H automatically when a logo is present), and advanced (error-correction level L, M, Q or H), plus a reset-to-defaults button.

The Manage tab lists codes with search, selection, editing, status changes (active, paused, archived) and deletion. The Analytics tab aggregates tenant stats: total scans, period-over-period change, active codes, average scans, new codes this week, top performer, daily scan trend, device split (mobile, desktop, tablet), geographic distribution by country, recent activity and top codes — over 7, 30, 90, 365-day and all-time ranges with a refresh button.

The core tracking idea is that the original content (the destination) is stored as-is on the QRCode document, while the QR image encodes the hop URL /q/[id]. On scan, the public hop page calls POST /api/dashboard/qr-codes/track, which records the scan (device, browser, OS and country derived from the User-Agent and headers), then instantly redirects URL, email, phone and SMS types to their destination, and displays text, WiFi and vCard types with a copy button. A paused or archived code is not accessible and returns a "QR Code Unavailable" error instead of redirecting.

Data lives in the multi-tenant QRCode collection keyed by tenantId and tenantSlug, with compound indexes on (tenant, createdAt), (tenant, status) and (tenant, type); analytics hold scan counts, unique scans, last scan, and scan maps by date, country, browser and OS plus device splits. Every successful write (create, update, delete) is quietly logged to the activity feed as entity qr with WiFi passwords, vCards and logos masked, while public scan tracking is never logged so it does not flood the feed.

For Egypt stores the QR maker bridges offline and online: a code on the packaging opens order tracking or product reviews, a code on a table or shopfront opens a menu or an offer, a printed WiFi code connects customers without dictating a password, and a vCard code on a sales card saves contact details in one scan — all measurable by scans, countries and devices instead of blind print distribution.

Setup steps in Vareons

  1. Open the QR Code Maker

    In the dashboard, open /dashboard/qr-maker (or the /dashboard/qr alias). The page is protected and requires the view QR-codes permission; it shows the stats overview (active codes, total scans, average, recent) with the four tabs.

  2. Pick the type and enter the content

    In the Generate tab pick one of the seven cards (URL, text, email, phone, WiFi, contact or SMS) and fill its dedicated form, then enter the code name (required) with an optional description and press “Generate QR Code” to jump to the Manage tab.

  3. Customize the look and logo

    Select the code, then open the Customize tab: set size, margin and pattern, pick a color preset or two custom colors, and upload the store logo (up to 5MB, capped at 25% of the size) while checking the live preview across mobile, tablet and desktop sizes.

  4. Download and share the code for print

    From the preview section download the code as PNG, SVG or PDF in print quality, or copy the content and share the link via sharing. The encoded image carries the /q/[id] tracking link while the original destination stays stored in the database.

  5. Manage codes and statuses

    In the Manage tab search for a code, select it and edit its content and settings, or flip its status between active, paused and archived to suspend or retire scanning, or delete it permanently. Editing an already-printed code changes its destination without reprinting because the image points at the stable tracking link.

  6. Follow analytics and improve distribution

    Open the Analytics tab, pick the range (7, 30, 90, 365 days or all time) and review total scans, change, device and country splits, the daily curve and top codes — then double printing on the highest-scan placements and retire the dead ones.

Frequently asked questions

Is there a QR code maker inside Vareons?

Yes. The QR Code Maker app lives at /dashboard/qr-maker and /dashboard/qr with four tabs — Generate, Customize, Manage and Analytics — and works with QR-code staff permissions.

What content types can be encoded?

Seven types: website URL, free text, email with subject and body, phone number, WiFi network with password, vCard contact, and SMS — each with its own input form.

Can the store logo and colors go on the code?

Yes, from the Customize tab: eight color presets plus two custom colors, logo upload up to 5MB sized up to 25% with error correction raised to H automatically, and a live preview before download.

In which formats can the code be downloaded for print?

Codes download as PNG, SVG and PDF from the preview section, with content copy and system sharing — suitable for printing on packaging, stickers and flyers.

Are scan counts recorded?

Yes. Every scan is recorded through the /q/[id] hop page with device and country, and the Analytics tab shows totals, splits, the daily curve and top codes across multiple ranges.

What happens when an already-printed code is paused?

A paused or archived code is not accessible: the scan page shows a “QR Code Unavailable” error instead of redirecting. It can be reactivated or pointed at a new destination without reprinting.

Can a code destination change after printing?

Yes. The printed image points at the stable /q/[id] tracking link while the destination lives in the database, so editing the content from the Manage tab changes the destination instantly with no reprint.

Troubleshooting

1) If the maker page does not appear, check staff permissions: view QR codes for viewing and analytics, create for generation, edit for customization and status, delete for removal. 2) If the generate button fails, make sure the code name and the required type content are entered (e.g. the URL for URL type, the network name for WiFi type). 3) If the code looks faint after printing, raise the contrast between foreground and background, avoid dark backgrounds, and re-download at higher quality. 4) If a code with a logo does not scan, shrink the logo below 25%, confirm error correction is on H, then reprint larger. 5) If scanning shows a "QR Code Unavailable" error, the code is paused, archived or deleted — reactivate it from the Manage tab. 6) If analytics stay at zero despite distribution, confirm the prints carry the /q/[id] tracking link and not the raw destination. 7) If the logo does not appear after upload, confirm the file is a real image under 5MB and retry.

Important limitations

• Tracking depends on scans passing through the /q/[id] hop page; codes printed from the raw destination outside the maker are not counted. • Analytics are aggregate per code (counts, device, country, date), not individual visitor profiles. • Public scan tracking is never written to the dashboard activity feed, to avoid flooding it. • PDF download is rendered from the canvas at the chosen quality; it is not always an infinitely scalable vector file. • Country data is derived from network headers and may be approximate or missing depending on the network. • The logo data URL is treated as untrusted input size-wise, capped at 5MB.

Related links

تواصل معنا على واتساب