Scanely documentation
Make every scan count.
A practical guide to creating QR codes, choosing where they lead, and understanding what happens after a scan.
Updated September 12, 2026
Create your first code
- Open Create QR Code. Choose General for a simple link, or a use case to prefill the setup.
- Add the destination or contact details. Give the code a recognizable name and an optional campaign tag.
- Customize the design, save the code, and run a test scan from its detail page.
- Download the final QR or a print kit. Scan a printed sample before ordering a full run.
Dashboard codes are dynamic: the printed pattern points to a Scanely short URL. Edit the destination later and keep the same printed code. A downloaded static code from our free tools contains its content directly; it has no Scanely analytics or editable destination.
Use a separate code for each placement you want to compare, such as a counter card and a window poster. Tags organize codes; client workspaces separate access.
Choose a QR type
| Choose | What a scan opens |
|---|---|
| General | Any HTTP or HTTPS URL, including an externally hosted PDF, website, form or booking page. |
| Restaurant menu, Google reviews, Flyer or poster | A URL code with a helpful starting name and call to action. Add your own menu, review or campaign URL. |
| Contact card | A hosted contact page with a downloadable vCard. Edit name, organization, title, phone, email and website later. |
| App download | An iOS or Android store link based on the device, with a required fallback URL for other devices or a missing store link. |
| File / PDF | A file hosted by Scanely. Upload a PDF, PNG, JPEG, WebP or GIF, up to 20 MB. Replace the file later without reprinting. |
Hosted files require a monthly Starter, Pro or Business subscription. Lifetime plans can link to externally hosted files through General. A saved code keeps its underlying type; create a new code when you need a different type.
Design, test & print
Customize colors, module and eye styles, gradients and frame text. Pro, Business and all Lifetime plans also support a QR logo. Save reusable designs in the dashboard. PNG and SVG downloads and PDF print kits are available on all plans.
The print kit includes a 70 × 70 mm sticker, an 85 × 55 mm business card, an A6 flyer and an A4 table stand. It uses a print-focused QR layout with a clear quiet zone, plus your call to action and optional branding. Its QR styling can differ from the decorative image preview.
Print at 100% scale. Contrast and size checks help spot common issues but do not guarantee scanning on every material, camera or lighting condition.
Different links at different times
Available on URL codes with Pro, Business or any Lifetime plan. Add a schedule during creation or edit an existing code. Keep a main destination URL: it is the fallback whenever no scheduled window is active.
- Choose Every day or Once.
- Select the timezone where your business operates. US options include Eastern, Central, Mountain, Pacific, Arizona, Alaska and Hawaii; other world timezones are also available.
- For a daily schedule, add a start time, end time and destination for each window. For a one-time schedule, choose the start and end dates and times.
| Example: America/New_York | Destination |
|---|---|
| 8:00 AM–12:00 PM, every day | Breakfast menu |
| 5:00 PM–10:00 PM, every day | Dinner menu |
| All other times | Main menu URL |
Times follow the selected timezone, regardless of the scanner’s location. Daylight saving changes are handled automatically: an 8:00 AM daily window remains at 8:00 AM local time. Choose Arizona separately from Mountain Time when your business does not follow daylight saving time.
Use up to 12 non-overlapping daily windows. A window can cross midnight, for example 10:00 PM–2:00 AM. The start is included and the end is excluded. Daily windows repeat every day; weekday-specific schedules are not currently available.
During a daylight saving transition, a skipped local hour does not occur and a repeated hour follows the same daily rule both times. The editor rejects ambiguous or nonexistent one-time dates. Scheduled redirects cannot be combined with Smart Routing or A/B testing on the same code.
Smart Routing & A/B testing
Smart Routing sends URL-code scans to different destinations by country, device type or operating system. Rules run from top to bottom; all conditions in a rule must match. The first matching rule wins, otherwise the main URL is used. You can add up to 15 rules.
A/B testing splits traffic across up to five destination variants. Set their traffic weights and enable the test. A browser cookie keeps the assignment consistent for up to 30 days; clearing cookies or changing browsers can change it. Scan counts show traffic distribution. Use conversion tracking to compare the actions visitors complete after arriving.
Both features require Pro, Business or any Lifetime plan. Choose one routing strategy per URL code: a schedule, Smart Routing or A/B testing.
Understand your results
Analytics show recorded scans by code, date, approximate location, device, browser, operating system and available referrer. Location depends on network information and may be unavailable or inaccurate. Hourly charts use UTC; the timezone chosen for a redirect schedule does not change analytics charts.
Repeated scans of the same code from the same hashed IP within one hour are deduplicated. Unique visitors are an estimate based on hashed IPs, not a count of identifiable people. A scan records access to the QR link, not a confirmed purchase or completed booking.
Free analytics cover the current calendar month. Paid plans unlock longer and custom date ranges and unique-visitor metrics. Dashboard insights highlight patterns in the recorded data; limited data can mean there is no useful insight yet.
- Chart CSV and analytics PDF: export the views available to your plan from the dashboard.
- Raw scan CSV: Pro, Business and all Lifetime plans. Includes time, code name and slug, location, device, browser, OS and referrer. Filter by date and optionally by QR code; workspace selection scopes the export. Campaign tags are not a column in this raw export.
- Shareable analytics: Pro, Business and all Lifetime plans can create a read-only link for one code. Anyone with the link can view it without signing in. Rotate or revoke the link to end access.
- Branded client report: Business and Lifetime Business workspaces provide a PDF report for the last 30 days with the client’s branding.
Measure what happens after a scan
On Pro, Business and all Lifetime plans, open Conversions, enter your website origin (for example https://your-business.com) and choose a goal: lead, booking or purchase. Each personal or client workspace has one conversion project and one selected goal.
- Install the provided Scanely script on that website.
- Connect it to your consent controls. Initialize with consent disabled and enable it after the visitor’s applicable consent choice.
- Send the goal event only after the form, booking or purchase succeeds. Use a stable event ID for that action so retries are deduplicated.
- For purchases, send an integer amount in minor currency units, such as 4900 for USD 49.00, with currency
USD.
Attribution applies to eligible URL-code redirects whose final destination matches your configured website origin. A signed visit reference connects the scan to the event. The browser SDK uses session storage after consent, so attribution is limited to that browser tab and a maximum of 30 days; it is not cross-device tracking.
The report uses visits from the last 30 days and counts a visit once when it achieves the selected goal. Visits are not unique people. Purchase values come from your website’s events and are not independently verified payments.
Disabling tracking stops new attribution and events; historical results remain. Read the integration example.
Keep client work separate
Business and Lifetime Business account owners can create up to 30 client workspaces. Each has its own QR codes, analytics, conversion project and report branding. The owner’s QR and scan allowances are shared across their personal workspace and all client workspaces.
| Role | Access |
|---|---|
| Owner | Manage codes, workspace branding, invitations, roles and reports. |
| Editor | Create and edit codes, manage conversion settings, view analytics and reports. |
| Viewer | View codes, analytics and download reports without editing. |
Create an invitation for the person’s email and copy the invite link to share it. Scanely does not send the invitation email automatically. The link is single-use and expires after seven days; the person must sign in with that email. Invitees can join on a Free account. A workspace supports up to 50 pending invitations.
Billing and API keys belong to individual accounts. If the owner no longer has a workspace-enabled plan, client workspaces become read-only. For an integration, send the X-Scanely-Workspace header with the workspace ID; see the API reference.
Link health & scan alerts
Paid plans receive daily health checks for active, unmuted codes with external link destinations. Checks include the main URL, Smart Routing destinations and configured schedule destinations. Hosted contact cards and hosted files are excluded. For App download codes, the fallback URL is checked.
A broken-link email requires failures on two consecutive UTC days. It is not an instant monitor. Recovery clears the alert state. A separate silent-code alert looks for a code with an established scan history that has received no scans for seven days.
Silence is a signal to inspect your campaign; it does not prove a poster was damaged or removed. Mute health alerts in the code’s settings when needed. You can also configure a scan-count notification separately from health monitoring.
More controls & integrations
From a code’s detail page, change its destination or content, rename it, change the campaign tag, or pause and reactivate it. Advanced settings include an expiry date, a maximum scan count, password protection, UTM parameters and scan-count notifications. The form indicates feature availability and incompatible settings.
Pausing, deleting, expiring or reaching a code’s explicitly configured maximum scan count can stop that code from forwarding. This is separate from reaching the account’s monthly tracking allowance. Deletion is permanent.
UTM fields append campaign information to the destination URL for your web analytics. The optional GA4 integration, available on Pro, Business and all Lifetime plans, is configured in Settings using a measurement ID and API secret; it reports scan events and is separate from Scanely’s conversion tracking setup.
Bulk creation imports URL codes from CSV on paid plans, up to 1,000 rows per request and within your remaining QR allowance. Review skipped rows before printing. API access requires Business or Lifetime Business; start with the API reference.
Plans & limits
These allowances apply to the account owner and are shared across their workspaces. A monthly scan allowance resets each calendar month.
| Plan | QR codes | Tracked scans / month |
|---|---|---|
| Free | 3 | 1,000 |
| Starter | 50 | 100,000 |
| Pro | 500 | 500,000 |
| Business | Unlimited | 2,000,000 |
| Lifetime Starter | 50 | 100,000 |
| Lifetime Pro | 100 | 200,000 |
| Lifetime Business | Unlimited | 500,000 |
| Plan | Schedules, routing, A/B, conversions, raw CSV, QR logos & sharing | Hosted files | Create client workspaces & API keys |
|---|---|---|---|
| Free | — | — | — |
| Starter | — | Included | — |
| Pro | Included | Included | — |
| Business | Included | Included | Included |
| Lifetime Starter | Included | — | — |
| Lifetime Pro | Included | — | — |
| Lifetime Business | Included | — | Included |
File storage: Starter 500 MB, Pro 2 GB, Business 10 GB; maximum 20 MB per file. Hosted files are excluded from all Lifetime plans. All plans include PNG/SVG downloads and PDF print kits. All paid plans include bulk generation and health monitoring.
See monthly pricing and Lifetime pricing. Lifetime access lasts for as long as the product exists, with the limits of the purchased tier.